inQuba Journey (versão prévia)
Publique dados diretamente nas APIs de Jornada do Cliente do InQuba e acompanhe efetivamente seus percursos do cliente.
Esse conector está disponível nos seguintes produtos e regiões:
| Service | Class | Regions |
|---|---|---|
| Copilot Studio | Premium | Todas as regiões do Power Automate , exceto as seguintes: – Governo dos EUA (GCC) – Governo dos EUA (GCC High) - China Cloud operado pela 21Vianet - Departamento de Defesa dos EUA (DoD) |
| Aplicativos Lógicos | Standard | Todas as regiões dos Aplicativos Lógicos , exceto as seguintes: – Regiões do Azure Governamental - Regiões do Azure China - Departamento de Defesa dos EUA (DoD) |
| Power Apps | Premium | Todas as regiões do Power Apps , exceto as seguintes: – Governo dos EUA (GCC) – Governo dos EUA (GCC High) - China Cloud operado pela 21Vianet - Departamento de Defesa dos EUA (DoD) |
| Power Automate | Premium | Todas as regiões do Power Automate , exceto as seguintes: – Governo dos EUA (GCC) – Governo dos EUA (GCC High) - China Cloud operado pela 21Vianet - Departamento de Defesa dos EUA (DoD) |
| Contato | |
|---|---|
| Nome | Suporte ao inQuba |
| URL | https://inquba.com |
| support@inquba.com |
| Metadados do conector | |
|---|---|
| Publicador | Inquba Customer Intelligence Pty Ltd |
| Site | https://inquba.com/ |
| Política de privacidade | https://www.inquba.com/data-privacy/ |
| Categorias | Dados; Comunicação |
O InQuba Journey Connector permite uma integração perfeita entre seus sistemas existentes e a plataforma inQuba Journey. Envie facilmente dados por meio do conector para visualizar rapidamente seus percursos do cliente e obter insights sobre o que seus clientes estão dizendo e fazendo. O conector oferece APIs REST fáceis de usar que permitem publicar percursos e eventos do cliente que são consumidos pela plataforma inQuba.
Pré-requisitos
Você precisará do seguinte para utilizar o inQuba Journey Connector:
- Uma Instância de Jornada inQuba registrada implantada
- Uma assinatura ativa do Azure
- Um plano do Microsoft Power Apps ou do Power Automate com o recurso de conector personalizado;
Você pode comprar uma assinatura visitando o local do Mercado do Azure ou visitando o site do inQuba e entrando em contato com as vendas.
Como obter credenciais
A autorização é necessária em todas as APIs inQuba. Depois de concluir o processo de registro do inQuba, entre em contato com o gerenciador de contas ou com o Suporte do inQuba para obter suas credenciais de API. Essas credenciais serão usadas no conector do Journey para todas as operações de API.
Introdução ao conector
O inQuba Journey Connector requer autorização para todas as ações. Comece sempre usando a ação "Adquirir Token de Acesso" antes de usar as ações "Criar Evento" ou "Criar Transação".
Recupere suas definições e credenciais de atributo de evento ou transação do inQuba. Essas definições de atributo indicarão os atributos necessários para interagir com seus clientes ou acompanhar seus percursos do cliente. Você pode entrar em contato com o gerenciador de contas ou com o Suporte do InQuba para obter as definições e credenciais relevantes.
Use os detalhes fornecidos na ação Adquirir Token de Acesso:
Use a ação Criar Evento ou Criar Transação. Use o conteúdo dinâmico da ação Adquirir Token de Acesso para atualizar o campo "Token de Authroization". Adicione o valor 'Portador' e selecione Conteúdo dinâmico usando o valor do Token de Autorização da etapa anterior, conforme mostrado abaixo.
Depois disso, você poderá preencher os detalhes necessários no formulário da ação e pode continuar a integrar-se à plataforma inQuba.
Um exemplo de um fluxo popular usando o Dynamics é mostrado abaixo. O fluxo abaixo dispara quando uma etapa de fluxo é executada no fluxo Dynamics:
Problemas e limitações conhecidos
No momento, a API de criação e criação de transações dá suporte apenas a conteúdos de eventos e transações individuais por solicitação. Para vários eventos e transações, é recomendável iniciar muitas solicitações iteradas.
Erros e soluções comuns
A resposta contém um erro HTTP 401
Verifique se suas credenciais estão corretas e corresponda às credenciais fornecidas conforme fornecido pelo inQuba. Você pode entrar em contato com o Suporte do InQuba para verificar suas credenciais.
A resposta contém um erro HTTP 404
Verifique se você está usando o nome do locatário correto e a URL do host, conforme fornecido pelo inQuba. Você pode entrar em contato com o Suporte do InQuba para verificar o nome do locatário.
A resposta contém um erro HTTP 500
Verifique se a matriz de atributos de evento ou transação está definida corretamente usando a entrada da matriz de atributos ou verificando se os atributos brutos estão corretos. Você pode entrar em contato com o Suporte do InQuba para verificar sua configuração.
perguntas frequentes
Quantas solicitações posso enviar usando o ponto de extremidade de eventos ou transações? Não há um limite rígido no número de solicitações que podem ser enviadas, no entanto, o processamento de percursos e eventos é limitado pelo seu nível de assinatura pago. Os preços da assinatura podem ser encontrados aqui.
Onde posso encontrar as definições de API Aberta para eventos e transações? A documentação do Swagger está disponível para a API de Eventos e Transações .
Os pontos de extremidade não de produção estão disponíveis para teste? Sim. Entre em contato com o gerenciador de contas ou com o Suporte do InQuba para obter suas credenciais de teste.
Quais fontes de dados o conector dá suporte? O conector dá suporte a quaisquer fontes de dados que possam ser usadas no Power Automate. Você pode adicionar o conector como uma etapa a qualquer fluxo configurado.
Limitações
| Nome | Chamadas | Período de renovação |
|---|---|---|
| Chamadas à API por conexão | 100 | 60 segundos |
Ações
| Adquirir token de acesso |
Autentique com a API inQuba e receba um token de autorização que será usado para todas as interações de API. |
| Criar evento |
Publique um registro de evento na API inQuba. Um token de portador é necessário para interagir com a API. |
| Criar transação |
Publique uma transação na API do InQuba Journey. Um token de portador é necessário para interagir com a API. |
Adquirir token de acesso
Autentique com a API inQuba e receba um token de autorização que será usado para todas as interações de API.
Parâmetros
| Nome | Chave | Obrigatório | Tipo | Description |
|---|---|---|---|---|
|
Nome do locatário
|
TenantName | True | string |
Nome do locatário conforme registrado no inQuba. |
|
URL do host
|
HostURL | True | string |
O host do ponto de extremidade token deve ser fornecido sem o nome do esquema. Eg. api.inqubacx.com |
|
Nome de usuário
|
username | True | string |
Nome de usuário da conta, conforme fornecido pelo inQuba. |
|
Senha
|
password | True | string |
Senha da conta, conforme fornecido pelo inQuba. |
|
ID do cliente
|
client_id | True | string |
ID do cliente, conforme fornecido pelo inQuba. |
|
Segredo de Cliente
|
client_secret | True | string |
Segredo do Cliente, conforme fornecido pelo inQuba. |
Retornos
| Nome | Caminho | Tipo | Description |
|---|---|---|---|
|
Token de autorização
|
access_token | string |
Token de autorização que será usado para todas as interações de API. |
Criar evento
Publique um registro de evento na API inQuba. Um token de portador é necessário para interagir com a API.
Parâmetros
| Nome | Chave | Obrigatório | Tipo | Description |
|---|---|---|---|---|
|
Nome do locatário
|
TenantName | True | string |
Nome do locatário conforme registrado no inQuba. |
|
Token de autorização
|
AuthorizationToken | True | string |
Token de autorização para autorizar a solicitação de API para inQuba. |
|
Código de definição de evento
|
eventDefinitionCode | string |
O código de evento para o qual você está publicando essa solicitação. |
|
|
É teste
|
isTest | boolean |
Um sinalizador que indica se esse evento deve ou não ser publicado como teste ou ao vivo. |
|
|
Code
|
code | string |
Código do atributo de evento |
|
|
Value
|
value | string |
Valor do atributo de evento |
Retornos
- SuccessStatus
- string
Criar transação
Publique uma transação na API do InQuba Journey. Um token de portador é necessário para interagir com a API.
Parâmetros
| Nome | Chave | Obrigatório | Tipo | Description |
|---|---|---|---|---|
|
Nome do locatário
|
TenantName | True | string |
Nome do locatário conforme registrado no inQuba. |
|
Token de autorização
|
AuthorizationToken | True | string |
Token de autorização para autorizar a solicitação de API para inQuba. |
|
Código de definição de transação
|
transactionDefinitionCode | string |
O código de transação para o qual você está publicando essa solicitação. |
|
|
É teste
|
isTest | boolean |
Um sinalizador que indica se essa transação deve ou não ser publicada como teste ou ativa. |
|
|
Code
|
code | string |
Código do atributo de transação |
|
|
Value
|
value | string |
Valor do atributo de transação |
Retornos
- SuccessStatus
- string
Definições
cadeia
Esse é o tipo de dados básico 'string'.