Flujos de Mensajería por WhatsApp - Paso "Connect APIs"

Con ActiveCampaign, puedes usar el paso "Connect APIs" en los flujos de Mensajería por WhatsApp para conectar cualquier solicitud que admita solicitudes de API. Esta funcionalidad te permite ampliar tus flujos al integrarte con sistemas externos, automatizar procesos y recuperar o enviar datos.

Este artículo explica el paso "API" y ofrece algunos ejemplos para mostrar su potencial.

Toma nota

Esta opción es para usuarios avanzados. Tienes que sentirte cómodo con el código. Nuestro equipo de Experiencia del cliente no puede ayudarte a implementar código ni a solucionar problemas de código.

Acerca del paso "Conectar API"

El paso "Conectar APIs" te permite hacer solicitudes HTTP a APIs externas. Puedes configurar este paso para enviar o recuperar datos de otros sistemas, lo que permite una integración fluida entre ActiveCampaign y tus herramientas actuales.

El paso API admite varios métodos HTTP, incluidos GET, POST, PATCH, PUT y DELETE, y te permite personalizar encabezados, parámetros de consulta y cuerpos de solicitud.

Configurar el paso "Conectar API"

1. Haz clic en WhatsApp > Flujos de mensajes en el menú de la izquierda.
2. Editar o crear un flujo de mensajes nuevo.
   • Si editas un flujo, haz clic en un flujo > Update > Steps. Haz clic en un nodo (+) del constructor donde quieres colocar la acción. Se abrirá una ventana modal. Haz clic en la opción "Connect APIs", luego haz clic en el botón "Add" 
   • Si creas un nuevo flujo, aparecerá una ventana modal en el generador de flujos. Haz clic en la opción "Connect APIs", luego haz clic en el botón "Add" 
3. En la ventana emergente "Agregar paso" que aparece:
   • Haz clic en el ícono de lápiz y asigna un nombre a tu paso. Te recomendamos usar nombres únicos que sean cortos y descriptivos.
   • Tipo de método - Seleccionar el método HTTP adecuado según tu caso de uso
   • URL - Introduce la URL del endpoint de API externo al que te quieres conectar
   • Agregar los encabezados de API necesarios, como Body, Headers y Query. Si el endpoint de la API requiere parámetros de consulta, puedes agregarlos aquí. Para solicitudes POST o PATCH, define el objeto JSON, el formulario o la cadena que se enviará como cuerpo de la solicitud.
   • Solicitud de prueba - Haz clic en este botón para probar la conexión de la API
   • Activar formato de caracteres de escape en variables - Si se activa, se formatean los caracteres especiales en el texto de la variable.

Ejemplos

Ejemplo 1: Enviar datos a un CRM

Supón que quieres actualizar la información de un contacto en tu CRM cada vez que complete un flujo en ActiveCampaign. Puedes usar el paso "Connect APIs" para enviar una solicitud POST a la API del CRM con los datos actualizados del contacto. Para ello:

1. Configurar la URL de tu CRM. Por ejemplo,  https://api.yourcrm.com/v1/contacts
2. Elegir POST para el método HTTP - POST
3. Configurar encabezados:

{
  "Authorization": "Bearer YOUR_API_KEY",
  "Content-Type": "solicitud/json"
}

4. Definir cuerpo de la solicitud:

{
  "first_name": "{{contact.first_name}}",
  "last_name": "{{contact.last_name}}",
  "email": "{{contact.email}}",
  "phone": "{{contact.phone}}"
}

Ejemplo 2: Recuperar datos desde un sistema externo

Imagina que necesitas recuperar el historial de pedidos de una persona desde un sistema externo y mostrárselo en un flujo de Mensajería por WhatsApp. Puedes usar el paso "Connect APIs" para hacer una solicitud GET a la API del sistema externo, luego usar los datos obtenidos en los siguientes pasos del flujo.

1. Configurar la URL como: https://api.yourordersystem.com/v1/orders?user_id={{contact.id}}
2. Elegir GET como método HTTP
3. Configurar encabezados:

{
  "Authorization": "Bearer YOUR_API_KEY"
}

Luego puedes usar la respuesta de la API en el flujo para mostrar el historial de pedidos del cliente.

Ejemplo 3: Desencadenar un flujo de trabajo externo

Supongamos que quieres desencadenar un flujo de trabajo externo cada vez que una persona completa un paso específico en un flujo de WhatsApp. Puedes usar el paso "Conectar APIs" para enviar una solicitud POST a la API del sistema externo y pasar todos los datos necesarios.

1. Configurar la URL como: https://api.yourworkflowtool.com/v1/trigger
2. Elegir POST como método HTTP
3. Configurar encabezados:

"Authorization": "Bearer YOUR_API_KEY",
  "Content-Type": "solicitud/json"

4. Definir el cuerpo de la solicitud:

{
  "user_id": "{{contact.phone}}",
  "evento": "flow_completed",
}