Zenvia Attraction le permite iniciar una automación a través de una llamada API dentro de un servidor o sistema de terceros.
En este artículo, le explicamos por qué debería utilizar la API de automación de marketing de Zenvia Attraction y cómo funciona en la práctica.
⚠️ Atención: Tenga en cuenta que la integración de la API requiere conocimientos técnicos avanzados, por lo que es importante contar con la ayuda de un desarrollador. Puede encontrar información sobre la API de automación de marketing de Zenvia Attraction en Zenvia APIs.
Por qué utilizar la API de automación
Imagine que tiene una página de inscripción para un evento en línea sobre estrategias de marketing. En lugar de proporcionar inmediatamente el enlace de acceso al evento en cuanto alguien rellena el formulario de inscripción, podría enviar una comunicación a la persona interesada con toda la información necesaria, incluido un enlace único para acceder al evento.
En este caso, la API puede conectar la información recopilada a través del formulario de inscripción con la activación de una campaña de automación de marketing.
En resumen, se inicia una cadena de comunicación a través de una llamada API dentro de un servidor o sistema de terceros.
Cómo funciona la integración de la API
Antes de integrar la API, debe crear la automación que recibirá el estímulo externo. Utilicemos el ejemplo del formulario de inscripción a un evento online.
Para ello, en el menú lateral, seleccione Automaciones de marketing > Crear nueva. A continuación, seleccione el disparador API, que es la regla que define la activación del flujo.
En la regla creada, se ha definido que se enviará un mensaje SMS a la persona que se inscribió en el evento.
Con la automación activa en Zenvia Attraction, es necesario integrar el trigger que inicia la regla de comunicación - la API - con su sistema. Para llevar a cabo esta integración, utilizamos Zapier, un integrador creado para facilitar la comunicación entre softwares.
Crear una integración con Zapier
Ya sabes que Zapier es el facilitador de la integración, es decir, el encargado de conectar una aplicación con otra para intercambiar información. Para ello:
1. Accede a Zapier y selecciona el botón naranja +Crear Zap en el menú lateral de la izquierda.
2. Elige la aplicación desencadenante (trigger).
3. Selecciona el disparador, que es el evento que ocurre en la aplicación que activa el flujo de datos de Zapier. Los disparadores se muestran según las posibilidades que ofrece la aplicación seleccionada. En este caso, los eventos disponibles son:
- Nueva respuesta de formulario (New form response): el evento que dispara el flujo de Zapier es cuando se recibe una nueva respuesta de formulario;
- Respuesta de formulario nueva o actualizada (New or Updated Form Response): el evento que dispara el flujo Zapier es cuando se añade o modifica una nueva respuesta de formulario.
4. Haz clic en Continue.
5. Seleccione la cuenta que desea conectar a la aplicación.
Listo. El siguiente paso es añadir una acción al disparador, es decir, los datos de la API de automatización de Zenvia Attraction para que la regla se inicie cuando se responda al formulario.
Configurar la acción
1. Selecciona la aplicación para que Zapier registre una acción cuando se active el disparador configurado. Para ello, busca y elige la aplicación que quieres conectar al formulario;
2. Elige el evento que Zapier realizará en la aplicación seleccionada cuando se active. En este caso, vamos a utilizar como ejemplo la aplicación Webhooks by Zapier;
3. Defina los datos que desea enviar a su aplicación de acción. En esta etapa, debe combinar los datos de su automatización de Zenvia Attraction con el flujo de Zapier. Para ello, en la automatización creada, haga clic en el disparador para comprobar el código de solicitud;
En el ejemplo, asociamos los campos de la siguiente manera:
Campo en Zapier |
Solicitud API |
| Method | Es el método de la acción en la URL. En nuestro caso, es el método POST. |
| URL | Esta es la URL de la API de automatización, es decir, https://api.zenvia.com/v2marketing-automations/{ruler-id}/dispatches |
| Headers | Son los parámetros introducidos en la cabecera de la solicitud. Para utilizar la API, necesita X-API-Token: es el token de autorización, que encontrará en el panel Tokens y Webhooks del menú Zenvia Platform Developers. Content-Type: es el tipo de contenido de la respuesta, que es application/json. |
| Data | Este es el cuerpo (body) de la API.{
|
4. Después de combinar todos los campos en Zapier, haga clic en Continue;
5. Se muestra el resumen de la solicitud y ahora puede probar su acción para ver si funciona como se espera haciendo clic en Probar acción. Después de probar, simplemente publica la acción haciendo clic en Publish Zap.
Listo. Siguiendo estos pasos, ahora puede enviar datos desde su sistema o proveedor a una automación de marketing de Zenvia Attraction.