Hola, Humans. ¿En qué podemos ayudarte?

02. API de automatización: Cómo usar e integrar con Zapier en Zenvia Customer Cloud
7 min
Creado por Leonora Alves en 15/02/2024 15:59
Actualizado por Leonora Alves en 08/03/2024 15:46

Zenvia Customer Cloud 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 ZCC y cómo funciona en la práctica.

⚠️ Atención: Esta funcionalidad sólo está disponible para usuarios con perfiles Operator o Admin.

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 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, ve a Envíos de mensajes > Envíos y automatizaciones y haz clic en Crear automatización. A continuación, seleccione el disparador API, que es la regla que define la activación del flujo.

Con la automación activa en Zenvia Customer Cloud, 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 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 Customer Cloud con el flujo de Zapier. Para ello, en la automatización creada, haga clic en el disparador para comprobar el código de solicitud;
  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.

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.
{

"recipientChannels":{"sms":"{NÚMERO DE CONTACTO}"},

"variables": {"name": "string"}

}


Listo. Siguiendo estos pasos, ahora puede enviar datos desde su sistema o proveedor a una automación de marketing de Zenvia Customer Cloud.