Trabajo con integraciones estándar external-sources

Vaya a la sección Configuraciones del menú de la izquierda y haga clic en Administrar desde la tarjeta Integraciones.

A continuación, haga clic en Crear integración para iniciar una nueva configuración.

{modal="regular"}

Opcionalmente, pegue un comando cURL para rellenar automáticamente la dirección URL, el método HTTP, los encabezados y los parámetros de consulta.

Proporcione un Nombre y una Descripción para su integración.

Escriba el extremo de API URL.

Para las variables de ruta de acceso, ajuste una etiqueta entre llaves dobles en la dirección URL, por ejemplo, https://api.example.com/v1/products/{{productId}}, y después establezca cada marcador de posición en Parámetro de ruta de acceso.

Seleccione Habilitar exploración para vincular una integración de exploración activa, de modo que sus campos de respuesta se puedan asignar a variables en encabezados, parámetros de consulta y ruta de acceso y la carga útil.

➡️ Ver Crear integraciones de exploración

{modal="regular"}

Configure el Parámetro de ruta de acceso con Nombre y Valor predeterminado para cada marcador de posición que agregó en la dirección URL.

Tenga en cuenta que Name es una etiqueta orientada al especialista en marketing solo en el editor; no se envía en la solicitud de API.

{modal="regular"}

Seleccione el método HTTP entre GET y POST.

Haga clic en Agregar encabezado o en Agregar parámetros de consulta según sea necesario para la integración. Proporcione los siguientes detalles para cada parámetro:

• Parámetro: El nombre real del encabezado o del parámetro de consulta que espera la API.

• Name: una etiqueta compatible con el especialista en marketing para este parámetro, los autores la seleccionan al asignar valores en las campañas.

• Tipo: elige Constante para un valor fijo o Variable para entrada dinámica.

• Valor: escriba el valor directamente para las constantes o seleccione una asignación de variables.

• Obligatorio: especifique si este parámetro es necesario. Para los parámetros Variable obligatorios, si no se resuelve ningún valor en tiempo de ejecución y no se proporciona ningún valor predeterminado, la generación de solicitudes falla con un error y no se realiza la llamada de API saliente.

{modal="regular"}

Elija un tipo de autenticación:

• Sin autenticación: Para las API abiertas que no requieren credenciales.

• clave de API: autentique solicitudes con una clave de API estática. Escriba su Nombre de clave API, Valor de clave API y especifique su ubicación.

• Autenticación básica: use la autenticación básica estándar de HTTP. Escriba Nombre de usuario y Contraseña.

• OAuth 2.0: realice la autenticación mediante el protocolo OAuth 2.0. Haga clic en el icono para configurar o actualizar la carga útil.

{modal="regular"}

Establezca la configuración de directiva, como el período de tiempo de espera para las solicitudes de API, y elija habilitar la restricción, la caché o reintentar.

Para un método POST, configure la carga útil eligiendo un tipo de cuerpo:

• JSON: Haga clic en el icono y pegue la carga de la solicitud JSON. Asigne las variables que necesita cumplir en la carga útil.

• GraphQL: pegue la consulta de GraphQL. Journey Optimizer genera un nombre de operación automáticamente y le permite asignar las variables de consulta correspondientes.

  {modal="regular"}

Elija Tipo de respuesta entre JSON y HTML.

Con el campo Carga de respuesta, puede decidir qué campos de la salida de ejemplo se deben utilizar para la personalización de mensajes.

Haga clic en el icono y pegue una carga útil de respuesta JSON de muestra para detectar automáticamente los tipos de datos.

Elija los campos que desea exponer para la personalización y especifique sus tipos de datos correspondientes.

{modal="regular"}

Cuando se definan la dirección URL, el método HTTP, los encabezados y los parámetros de consulta, haga clic en Enviar conexión de prueba para ejecutar una prueba de conectividad y confirmar la configuración.

En el cuadro de diálogo Enviar conexión de prueba, escriba valores predeterminados para cualquier marcador de posición de Variable en la ruta de acceso de la dirección URL, los encabezados y los parámetros de consulta.

Estos valores se incluyen en la solicitud de prueba. Journey Optimizer invoca el extremo e informa de si la conexión se realizó correctamente o no.

{modal="regular"}

Si la prueba devuelve una respuesta correcta, seleccione Usar como carga útil de respuesta para copiar el cuerpo de respuesta en el campo Carga útil de respuesta; consulte el paso 10 en Configurar la integración, donde se pueden detectar tipos de datos y se pueden seleccionar campos para la personalización.

{modal="regular"}

Si la prueba no se realiza correctamente, expanda la lista desplegable Error para revisar los detalles del error, actualice la configuración de la integración según sea necesario y ejecute Enviar conexión de prueba de nuevo.

{modal="regular"}

Una vez validado, haga clic en Activar.

Acceda a la integración recién creada para:

• Actualización: cambia los detalles de Autenticación y la configuración de directiva solamente. Las actualizaciones se aplican a recorridos en directo y campañas. Antes de guardar los cambios, usa el menú Explorar referencias para confirmar dónde se usa la integración.

• Archivo: Archive una configuración de integración.

  {modal="regular"}

Después de la activación, haz clic en el icono para acceder al menú Explorar referencias y revisar el uso de esta configuración, incluidos los recorridos y las campañas que dependen de ella.

{modal="regular"}