Cómo configurar el envío de webhooks a tu sistema

Webhook es un mecanismo de notificación a un sistema sobre eventos. Webhook en Automatización 360 es una forma de notificar a tu sistema sobre eventos que les suceden a mensajes en automatizaciones.

¿Qué permite hacer un webhook?

Enviar webhooks le permite al servicio SendPulse recibir actualizaciones cuando el estado de los clientes cambia o cuando la serie automatizada alcanza un objetivo específico.

Por ejemplo, los clientes potenciales dejan solicitudes en tu sitio; sus datos de contacto se envían a su sistema CRM y se sincronizan con SendPulse. Se inicia un flujo de Automatización 360 con éstos leads para calentar. Deseas llamar a todos los que abren el tercer correo electrónico del flujo. Para hacer esto, debes cambiar el estado de los clientes potenciales en tu CRM. Puedes hacerlo con la ayuda de un webhook enviando datos sobre un evento a tu sistema.

Cómo enviar un webhook en un flujo de automatización

Para enviar notificaciones de eventos a otro sistema, vincula el elemento Acción: Enviar webhook al elemento desde el que deseas rastrear un evento. Puedes realizar un seguimiento de recibir o abrir un correo electrónico, filtrar por una condición específica, lograr un objetivo o cualquier otra acción realizada por un suscriptor dentro de un flujo de automatización.

Especifica un nombre de webhook y una URL a la que se enviará el webhook. Solo se permiten números y caracteres latinos en un nombre de webhook.

Configura el envío de la clave en respuesta al primer webhook para eliminar el límite de envío de webhooks. De lo contrario, el servicio le permitirá enviar un webhook por hora.

Estructura del Webhook

Un webhook transmite estos datos:

• una ID de flujo;
• un nombre de webhook;
• una fecha de activación de webhook;
• una dirección de correo electrónico y un número de teléfono de un suscriptor para quien se envía el webhook;
• datos variables.

Si una automatización comienza con una lista de correo, las variables de la lista de correo se envían al webhook. Si una automatización comienza por un evento, las variables del evento se envían en el webhook.

[
   {
      "automation_id":"123456789",
      "title":"New Automation",
      "execution_date":"2022-01-04 09:02:39",
      "email":"example@example.com",
      "phone":"+380631234567",
      "variables":[
         {
            "name1":"value1"
         },
         {
            "name2":"value2"
         }
      ]
   }
]

Cómo enviar una solicitud de prueba

Puedes enviar una solicitud de prueba para comprobar si la configuración es correcta y detectar posibles problemas o errores. Selecciona Ejecutar solicitud de prueba.

En la ventana de diálogo, podrás encontrar el análisis de la solicitud con la URL de tu sitio web, el webhook y la respuesta del webhook.

El webhook devuelve diferentes respuestas según los parámetros de la solicitud o el estado del sistema.

La respuesta del webhook contiene los siguientes parámetros:

El webhook puede devolver las siguientes respuestas:

En caso de error de código:

[
   {
     "status": false,
     "message": 'Error during query execution',
     "code": 21111011
   }
]

En caso de error en la ejecución de la solicitud:

[
   {
     "status": false,
     "message": 'The request failed',
     "code": 11110111
   }
]

En caso de error provocado por la falta de respuesta del usuario en formato JSON:

[
   {
     "status": false,
     "message": 'Invalid response format. Expects json!',
     "code": 11110112
   }
]

En caso de error causado por un código de verificación incorrecto para los usuarios del plan gratuito:

[
   {
     "status": false,
     "message": 'The request did not pass code verification',
     "code": 11110113
   }
]

En caso de error de verificación de la dirección IP, es decir, cuando la dirección IP está bloqueada o es local:

[
   {
     "status": false,
     "message": 'Incorrect url ip',
     "code": 11110114
   }
]

En caso de solicitud aprobada:

[
   {
     "status": true,
     "(string)message": (webhook response),
     "code": 1
   }
]

Cómo hacer un seguimiento de las bajas y las quejas de spam

Puedes configurar el seguimiento de las bajas y las quejas de spam en la configuración de tu cuenta.

Un ejemplo de webhook de queja de spam:

[
   {
      "timestamp":1496827422,
      "event":"spam",
      "task_id":3668141,
      "email":"john.doe@sendpulse.com",
      "source":"automation360",
      "automation_id":"123456789"
   }
]

Un ejemplo de un webhook para darse de baja:

[
   {
      "task_id":"3668141",
      "timestamp":"1496827872",
      "from_all":1,
      "email":"john.doe@sendpulse.com",
      "reason":null,
      "book_id":490686,
      "event":"unsubscribe",
      "categories":"",
      "source":"automation360",
      "automation_id":"123456789"
   }
]

Última actualización: 02.04.2024