Webhooks en emailmarketing.com.ar

Recibí notificaciones en tiempo real sobre:

• La performance de tus campañas
• El comportamiento de tus contactos

Qué es un webhook

Un webhook es una herramienta que permite a un sistema o aplicación enviar notificaciones sobre un evento específico a otro sistema o aplicación en tiempo real.

Al configurar los webhooks de emailmarketing.com.ar podés conectarlos a una URL pública (perteneciente al sistema o aplicación de destino) a la cual se enviarán notificaciones cuando se produzca un evento específico en la herramienta. Por ejemplo: el envío de una campaña, la suscripción de un contacto, entre otros.

Configuración en emailmarketing.com.ar

Configurar un webhook es muy sencillo. Seguí estos pasos:

1. Una vez que iniciás sesión en emailmarketing.com.ar, dirígete a Configuración.
2. Ingresá a la sección de Webhooks.
3. Copiá la URL perteneciente al sistema o aplicación a la cual se va a integrar. Debés agregar el formato http(s) al inicio.
4. Vas a ver la lista completa de eventos disponibles: seleccioná aquellos de los cuales deseás recibir notificaciones.
5. Al final, recordá guardar los cambios.

Detalle de los eventos

01) Apertura de campaña

Esta notificación se envía cuando un contacto abre una campaña. Si un mismo contacto abre varias veces la misma campaña, solo se notificará la primera vez.

Datos que devuelve:

Ejemplo:

{
  "id": "39f3abfc43b23e",
  "event": "campaign_read",
  "email": "ejemplo@dominio.com",
  "ts_event": 1631199366,
  "campaign_id": "383",
  "campaign_name": "Campaña de Prueba",
  "ts_sent": 1631198557
}

02) Campaña enviada

Se envía una notificación tras el envío exitoso de una campaña.

Datos que devuelve:

Ejemplo:

{
  "id": "61269d5887e2f",
  "event": "campaign_sent",
  "ts_event": 1629920600,
  "campaign_id": "200",
  "campaign_name": "Nombre de la Campaña"
}

03) Clic en una campaña

Se envía una notificación cuando un contacto hace clic en algún enlace de la campaña.

Datos que devuelve:

Ejemplo:

{
  "id": "39f3abff06dbcc",
  "event": "campaign_click",
  "email": "ejemplo@dominio.com",
  "ts_event": 1631199371,
  "campaign_id": "383",
  "campaign_name": "Campaña de Prueba",
  "ts_sent": 1631198557,
  "campaign_url": "http://www.ejemplo.com?utm_source=email_marketing&utm_medium=email&utm_campaign=Prueba_Webhooks"
}

04) Suscripción de contacto

Se envía una notificación cuando:

• El contacto se suscribe a una o varias listas desde los formularios (la notificación se envía cuando se recibe la confirmación del correo).
• El administrador suscribe al contacto entrando a la lista y agregándolo.
• El administrador crea un contacto individual asignándolo a una o varias listas.

Datos que devuelve:

Ejemplo:

{
  "id": "612cfec2819fb",
  "event": "member_subscribe",
  "ts_event": 1630338754,
  "email": "ejemplo@dominio.com",
  "list_ids": [
    "13"
  ]
}

05) Desuscripción de contacto

Se envía una notificación cuando:

• El contacto se desuscribe de una o todas las listas desde el enlace proporcionado en el pie de las campañas.
• El administrador desuscribe al contacto entrando a la lista y eliminándolo.

Datos que devuelve:

Ejemplo:

{
  "id": "612d0604472c8",
  "event": "member_unsubscribe",
  "ts_event": 1630340612,
  "reason": "irrelevant",
  "email": "ejemplo@dominio.com",
  "list_ids": [
    "5"
  ],
  "campaign_id": "201",
  "campaign_name": "Campaña de Prueba",
  "ts_sent": 1630340179
}