Para configurar los Webhooks de Email accede a Connectif, Integraciones -> Integración Email -> pestaña Configuración.
En esa pestaña se encuentra una sección de configuración avanzada donde se puede configurar el endpoint de:
- notificación de una nueva suscripción
- notificación de una cancelación de suscripción
- notificación de un rebote.
Notificar una nueva suscripción
Connectif llamará a este endpoint cada vez que un contacto se suscriba a la newsletter a través de un formulario de alta que haya sido configurado para notificar la suscripción (esto se puede configurar en las opciones del formulario).
La petición es HTTP GET e incluirá los siguientes parámetros en el query string:
- email: el email del contacto que se ha suscrito a la newsletter;
- ip: la ip del contacto desde la cual ha enviado el formulario de suscripción.
Cancelación de la suscripción
Connectif llamará a este endpoint cada vez que un contacto cancele su suscripción a la newsletter.
La petición es HTTP GET e incluirá los siguientes parámetros en el query string:
- email: el email del contacto que se ha dado de baja;
- ip: la ip del contacto desde la cual ha hecho click en el enlace de baja.
Nota
Este webhook se dispara también si se cancela la suscripción (marcando el campo estado de suscripción newsletter con el valor dado de baja) de un contacto dentro Connectif mediante, la ficha de detalle del contacto, importación de contactos o workflow con nodo establecer campo. En estos casos el parámetro ip no tendrá valor.
Rebote de un correo
Connectif llamará a este endpoint cada vez que un envío de email a un contacto produzca un rebote de cualquier tipo.
La petición POST de tipo “Content-Type: application/json” envía en el body los siguientes parámetros:
| Nombre | Descripción |
|---|---|
| bounceErrorMessage | texto con la descripción del rebote devuelto por el servidor de correo al que se ha intentado entregar el email |
| bouncestatus | código de rebote devuelto por el servidor de correo al que se ha intentado entregar el email |
| bounceTypeId | tipo de rebote, los posibles valores pueden ser: 'hard', 'soft', 'other' |
| workflowId | el id del workflow desde el cual se ha enviado el correo que ha provocado el rebote |
| contentId | el id del contenido que se le ha enviado al contacto |
| entityId | el id del contacto que ha rebotado |
| entityEmail | el email del contacto que se ha rebotado |