inQuba Journey (Pré-visualização)
Publique dados sem problemas nas APIs do Customer Journey da inQuba e acompanhe efetivamente as jornadas dos seus clientes.
Este conector está disponível nos seguintes produtos e regiões:
| Serviço | Class | Regiões |
|---|---|---|
| Estúdio Copiloto | Premium | Todas as regiões do Power Automatic , exceto as seguintes: - Governo dos EUA (CCG) - Governo dos EUA (GCC High) - China Cloud operado pela 21Vianet - Departamento de Defesa dos EUA (DoD) |
| Aplicações Lógicas | Standard | Todas as regiões do Logic Apps , exceto as seguintes: - Regiões do Azure Government - Regiões do Azure China - Departamento de Defesa dos EUA (DoD) |
| Aplicações Power | Premium | Todas as regiões do Power Apps , exceto as seguintes: - Governo dos EUA (CCG) - Governo dos EUA (GCC High) - China Cloud operado pela 21Vianet - Departamento de Defesa dos EUA (DoD) |
| Automatize o poder | Premium | Todas as regiões do Power Automatic , exceto as seguintes: - Governo dos EUA (CCG) - Governo dos EUA (GCC High) - China Cloud operado pela 21Vianet - Departamento de Defesa dos EUA (DoD) |
| Contato | |
|---|---|
| Nome | Suporte inQuba |
| URL | https://inquba.com |
| support@inquba.com |
| Metadados do conector | |
|---|---|
| Editora | Inquba Inteligência do Cliente Pty Ltd |
| Sítio Web | 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 os seus sistemas existentes e a plataforma inQuba Journey. Envie dados facilmente através do conector para visualizar rapidamente as jornadas dos seus clientes e obter informações sobre o que os seus clientes estão a dizer e a fazer. O conector oferece APIs REST fáceis de usar que permitem publicar jornadas 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 Microsoft Power Apps ou Power Automate com recurso de conector personalizado;
Você pode comprar uma assinatura visitando o Azure Market place ou visitando o site inQuba e entrando em contato com o departamento de 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 seu gerente de conta ou com o Suporte do inQuba para obter suas credenciais de API. Essas credenciais serão usadas no conector Journey para todas as operações da API.
Introdução ao conector
O inQuba Journey Connector requer autorização para todas as ações. Comece sempre com 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 atributos de evento ou transação do inQuba. Essas definições de atributos indicarão os atributos necessários para interagir com seus clientes ou acompanhar suas jornadas de clientes. Você pode entrar em contato com seu gerente de conta ou com o Suporte 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 Autroização'. Adicione o valor 'Portador' e, em seguida, selecione Conteúdo dinâmico usando o valor do Token de autorização da etapa anterior, conforme mostrado abaixo.
Depois disso, você pode preencher os detalhes necessários no formulário da ação e pode prosseguir com a integração com a plataforma inQuba.
Um exemplo de um fluxo popular usando o Dynamics é mostrado abaixo. O fluxo abaixo é acionado quando uma etapa de fluxo é executada em Dynamics:
Problemas conhecidos e limitações
Atualmente, a API create event e create transaction suporta apenas cargas úteis de evento único e transação por solicitação. Para vários eventos e transações, recomenda-se 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 correspondem às credenciais fornecidas, conforme fornecido pelo inQuba. Você pode entrar em contato com o Suporte inQuba para verificar suas credenciais.
A resposta contém um erro HTTP 404
Certifique-se de que está a utilizar o nome de inquilino e o URL de anfitrião corretos, conforme fornecido pelo inQuba. Você pode entrar em contato com o Suporte inQuba para verificar seu nome de locatário.
A resposta contém um erro HTTP 500
Certifique-se de que sua matriz de atributos de evento ou transação esteja 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 inQuba para verificar sua configuração.
FAQ
Quantas solicitações posso enviar usando o endpoint de eventos ou transações? Não há limite rígido para o número de solicitações que podem ser enviadas, no entanto, o processamento de viagens e eventos é limitado pelo nível de assinatura pago. Os preços da subscrição podem ser consultados aqui.
Onde posso encontrar as definições da 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 que não são de produção estão disponíveis para teste? Yes. Entre em contato com seu gerente de conta ou com o Suporte inQuba para obter suas credenciais de teste.
Quais fontes de dados o conector suporta? O conector suporta quaisquer fontes de dados que possam ser usadas no Power Automate. Você pode adicionar o conector como uma etapa para qualquer fluxo configurado.
Limites de Limitação
| Name | Chamadas | Período de Renovação |
|---|---|---|
| Chamadas de API por conexão | 100 | 60 segundos |
Ações
| Adquirir token de acesso |
Autentique-se com a API inQuba e receba um token de autorização que será usado para todas as interações da 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 inQuba Journey. Um token de portador é necessário para interagir com a API. |
Adquirir token de acesso
Autentique-se com a API inQuba e receba um token de autorização que será usado para todas as interações da API.
Parâmetros
| Name | Chave | Necessário | Tipo | Description |
|---|---|---|---|---|
|
Nome do Inquilino
|
TenantName | True | string |
Nome do Inquilino conforme registrado no inQuba. |
|
URL do anfitrião
|
HostURL | True | string |
O host do ponto de extremidade do token deve ser fornecido sem o nome do esquema. Por exemplo. api.inqubacx.com |
|
Nome de utilizador
|
username | True | string |
Nome de usuário da conta, conforme fornecido pela inQuba. |
|
Palavra-passe
|
password | True | string |
Senha da conta fornecida pela inQuba. |
|
ID do Cliente
|
client_id | True | string |
ID do cliente conforme fornecido pela inQuba. |
|
Segredo do Cliente
|
client_secret | True | string |
Segredo do Cliente conforme fornecido pela inQuba. |
Devoluções
| Name | Caminho | Tipo | Description |
|---|---|---|---|
|
Token de autorização
|
access_token | string |
Token de autorização que será usado para todas as interações da API. |
Criar evento
Publique um registro de evento na API inQuba. Um token de portador é necessário para interagir com a API.
Parâmetros
| Name | Chave | Necessário | Tipo | Description |
|---|---|---|---|---|
|
Nome do Inquilino
|
TenantName | True | string |
Nome do Inquilino 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 do evento para o qual você está publicando essa solicitação. |
|
|
É teste
|
isTest | boolean |
Um sinalizador indicando se este evento deve ou não ser publicado como teste ou ao vivo. |
|
|
Código
|
code | string |
Código de atributo do evento |
|
|
Valor
|
value | string |
Valor do atributo do evento |
Devoluções
- SuccessStatus
- string
Criar transação
Publique uma transação na API inQuba Journey. Um token de portador é necessário para interagir com a API.
Parâmetros
| Name | Chave | Necessário | Tipo | Description |
|---|---|---|---|---|
|
Nome do Inquilino
|
TenantName | True | string |
Nome do Inquilino 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 esta solicitação. |
|
|
É teste
|
isTest | boolean |
Uma bandeira indicando se esta transção deve ou não ser publicada como teste ou ao vivo. |
|
|
Código
|
code | string |
Código de atributo da transação |
|
|
Valor
|
value | string |
Valor do atributo da transação |
Devoluções
- SuccessStatus
- string
Definições
cadeia (de caracteres)
Este é o tipo de dados básico 'string'.