inQuba Journey (versión preliminar)
Publique datos sin problemas en las API inQuba Customer Journey y realice un seguimiento eficaz de los recorridos del cliente.
Este conector está disponible en los siguientes productos y regiones:
| Service | Class | Regions |
|---|---|---|
| Copilot Studio | Premium | Todas las regiones de Power Automate excepto las siguientes: - Gobierno de EE. UU. (GCC) - Gobierno de EE. UU. (GCC High) - China Cloud operado por 21Vianet - Departamento de Defensa de EE. UU. (DoD) |
| Aplicaciones lógicas | Estándar | Todas las regiones de Logic Apps excepto las siguientes: - Regiones de Azure Government - Regiones de Azure China - Departamento de Defensa de EE. UU. (DoD) |
| Power Apps | Premium | Todas las regiones de Power Apps excepto las siguientes: - Gobierno de EE. UU. (GCC) - Gobierno de EE. UU. (GCC High) - China Cloud operado por 21Vianet - Departamento de Defensa de EE. UU. (DoD) |
| Power Automate | Premium | Todas las regiones de Power Automate excepto las siguientes: - Gobierno de EE. UU. (GCC) - Gobierno de EE. UU. (GCC High) - China Cloud operado por 21Vianet - Departamento de Defensa de EE. UU. (DoD) |
| Contacto | |
|---|---|
| Nombre | Compatibilidad con inQuba |
| URL | https://inquba.com |
| Correo Electrónico | support@inquba.com |
| Metadatos del conector | |
|---|---|
| Publicador | Inquba Customer Intelligence Pty Ltd |
| Sitio web | https://inquba.com/ |
| Directiva de privacidad | https://www.inquba.com/data-privacy/ |
| Categorías | Datos; Comunicación |
El conector inQuba Journey permite una integración perfecta entre los sistemas existentes y la plataforma inQuba Journey. Envíe fácilmente datos a través del conector para visualizar rápidamente los recorridos del cliente y obtener información sobre lo que sus clientes dicen y hacen. El conector ofrece API REST fáciles de usar que permiten publicar recorridos y eventos del cliente que consume la plataforma inQuba.
Prerrequisitos
Necesitará lo siguiente para usar el conector inQuba Journey:
- Una instancia registrada enQuba Journey implementada
- Una suscripción a Azure activa
- Un plan de Microsoft Power Apps o Power Automate con una característica de conector personalizada;
Puede comprar una suscripción visitando azure Market place o visitando el sitio web de InQuba y poniéndose en contacto con las ventas.
Obtención de credenciales
Se requiere autorización en todas las API de InQuba. Una vez que haya completado el proceso de registro de inQuba, póngase en contacto con el administrador de cuentas o con el soporte técnico de InQuba para obtener sus credenciales de API. Estas credenciales se usarán en el conector Journey para todas las operaciones de API.
Introducción al conector
El conector inQuba Journey requiere autorización para todas las acciones. Comience siempre con la acción "Adquirir token de acceso" antes de usar las acciones "Crear evento" o "Crear transacción".
Recupere las definiciones de atributos de evento o transacción y las credenciales de inQuba. Estas definiciones de atributo indicarán los atributos necesarios para interactuar con los clientes o realizar un seguimiento de sus recorridos del cliente. Puede ponerse en contacto con el administrador de cuentas o con el soporte técnico de InQuba para conocer las definiciones y credenciales pertinentes.
Use los detalles proporcionados en la acción Adquirir token de
Use la acción Crear evento o Crear transacción. Use el contenido dinámico de la acción Adquirir token de acceso para actualizar el campo "Token de autenticación". Agregue el valor "Bearer" (Portador) y, a continuación, seleccione Contenido dinámico con el valor de Token de autorización del paso anterior, como se muestra a continuación.
Después, puede rellenar los detalles necesarios en el formulario de la acción y continuar con la integración con la plataforma inQuba.
A continuación se muestra un ejemplo de un flujo popular mediante Dynamics. El flujo siguiente se desencadena cuando se ejecuta un paso de flujo en Dynamics:
Problemas y limitaciones conocidos
Actualmente, la API de creación de eventos y transacciones solo admite cargas de transacciones y eventos únicos por solicitud. Para varios eventos y transacciones, se recomienda iniciar muchas solicitudes iteradas.
Errores y soluciones comunes
La respuesta contiene un error HTTP 401
Compruebe que las credenciales son correctas y que coincidan con las credenciales proporcionadas según lo proporcionado por inQuba. Puede ponerse en contacto con el soporte técnico de InQuba para comprobar sus credenciales.
La respuesta contiene un error HTTP 404
Asegúrese de que usa el nombre de inquilino y la dirección URL de host correctos, tal como lo proporciona inQuba. Puede ponerse en contacto con el soporte técnico de InQuba para comprobar el nombre del inquilino.
La respuesta contiene un error HTTP 500
Asegúrese de que la matriz de atributos de evento o transacción esté definida correctamente mediante la entrada de la matriz de atributos o compruebe que los atributos sin procesar son correctos. Puede ponerse en contacto con el soporte técnico de InQuba para comprobar la configuración.
Preguntas más frecuentes
¿Cuántas solicitudes puedo enviar mediante el punto de conexión de eventos o transacciones? No hay ningún límite estricto en el número de solicitudes que se pueden enviar sin embargo, el procesamiento de recorridos y eventos está limitado por el nivel de suscripción de pago. Los precios de la suscripción se pueden encontrar aquí.
¿Dónde puedo encontrar las definiciones de Open API para eventos y transacciones? La documentación de Swagger está disponible para la API de eventos y transacciones .
¿Hay puntos de conexión que no son de producción disponibles para las pruebas? Sí. Póngase en contacto con el administrador de cuentas o el soporte técnico de InQuba para obtener sus credenciales de prueba.
¿Qué orígenes de datos admite el conector? El conector admite los orígenes de datos que se pueden usar en Power Automate. Puede agregar el conector como paso a cualquier flujo que configure.
Limitaciones
| Nombre | Llamadas | Período de renovación |
|---|---|---|
| Llamadas API por conexión | 100 | 60 segundos |
Acciones
| Adquisición del token de acceso |
Autentíquese con la API inQuba y reciba un token de autorización que se usará para todas las interacciones de api. |
| Crear evento |
Publique un registro de eventos en la API inQuba. Se requiere un token de portador para interactuar con la API. |
| Crear transacción |
Publique una transacción en la API de recorrido de inQuba. Se requiere un token de portador para interactuar con la API. |
Adquisición del token de acceso
Autentíquese con la API inQuba y reciba un token de autorización que se usará para todas las interacciones de api.
Parámetros
| Nombre | Clave | Requerido | Tipo | Description |
|---|---|---|---|---|
|
Nombre del inquilino
|
TenantName | True | string |
Nombre del inquilino como registrado con inQuba. |
|
URL del host
|
HostURL | True | string |
El host del punto de conexión de token debe proporcionarse sin nombre de esquema. Eg. api.inqubacx.com |
|
Nombre de usuario
|
username | True | string |
Nombre de usuario de cuenta proporcionado por inQuba. |
|
Contraseña
|
password | True | string |
Contraseña de cuenta proporcionada por inQuba. |
|
Id. de cliente
|
client_id | True | string |
Id. de cliente proporcionado por inQuba. |
|
Secreto del cliente
|
client_secret | True | string |
Secreto de cliente proporcionado por inQuba. |
Devoluciones
| Nombre | Ruta de acceso | Tipo | Description |
|---|---|---|---|
|
Token de autorización
|
access_token | string |
Token de autorización que se usará para todas las interacciones de API. |
Crear evento
Publique un registro de eventos en la API inQuba. Se requiere un token de portador para interactuar con la API.
Parámetros
| Nombre | Clave | Requerido | Tipo | Description |
|---|---|---|---|---|
|
Nombre del inquilino
|
TenantName | True | string |
Nombre del inquilino como registrado con inQuba. |
|
Token de autorización
|
AuthorizationToken | True | string |
Token de autorización para autorizar la solicitud de API a inQuba. |
|
Código de definición de eventos
|
eventDefinitionCode | string |
El código de evento para el que está publicando esta solicitud. |
|
|
Is Test
|
isTest | boolean |
Marca que indica si este evento se debe publicar como prueba o activo. |
|
|
Código
|
code | string |
Código de atributo de evento |
|
|
Importancia
|
value | string |
Valor del atributo de evento |
Devoluciones
- SuccessStatus
- string
Crear transacción
Publique una transacción en la API de recorrido de inQuba. Se requiere un token de portador para interactuar con la API.
Parámetros
| Nombre | Clave | Requerido | Tipo | Description |
|---|---|---|---|---|
|
Nombre del inquilino
|
TenantName | True | string |
Nombre del inquilino como registrado con inQuba. |
|
Token de autorización
|
AuthorizationToken | True | string |
Token de autorización para autorizar la solicitud de API a inQuba. |
|
Código de definición de transacción
|
transactionDefinitionCode | string |
El código de transacción para el que está publicando esta solicitud. |
|
|
Is Test
|
isTest | boolean |
Marca que indica si esta transcción debe publicarse como prueba o activa. |
|
|
Código
|
code | string |
Código de atributo de transacción |
|
|
Importancia
|
value | string |
Valor del atributo de transacción |
Devoluciones
- SuccessStatus
- string
Definiciones
cuerda / cadena
Este es el tipo de datos básico "string".