Si está familiarizado con las métricas detalladas que ofrece Brevo para los emails, sabrá lo abrumador que puede ser intentar darle sentido a todo. En lugar de examinar un montón de datos para encontrar la información que necesita, los webhooks le permiten recibir los datos idóneos directamente y, por tanto, acceder a los detalles importantes que necesita con total facilidad.
¿Qué es un webhook?
Los webhooks se pueden definir como notificaciones que se activan por eventos específicos. Por lo general, se utilizan para facilitar la comunicación entre diferentes sistemas. En esencia, los webhooks son un sencillo mecanismo para recibir alertas cada vez que ocurre un evento en otro sistema.
En términos más técnicos, un webhook es una devolución de llamada HTTP que permite que varios sistemas se interconecten y mantengan acciones coherentes entre ellos. Cuando ocurre un evento en un sistema, se envía una solicitud POST a la URL proporcionada en tiempo real. Esta solicitud HTTP POST contiene información relacionada con ese evento específico; por ejemplo, la hora en que ocurrió, el nombre del evento y los identificadores clave.
¿Cómo funcionan los webhooks en Brevo?
En Brevo, un webhook es una URL que se puede integrar en nuestro sistema para recibir actualizaciones en tiempo real sobre eventos relacionados con el envío de emails de marketing y transaccionales, y la gestión de los contactos. Con los webhooks, puede realizar un seguimiento de los eventos específicos que le interesan; por ejemplo, cuando se abre un email o se elimina un contacto.
Hay varios tipos de eventos que se pueden supervisar. Por ejemplo, puede recibir notificaciones sobre el estado de una campaña de marketing en curso para saber cómo está funcionando en tiempo real. También puede hacer un seguimiento de cuándo se envían los mensajes transaccionales, cuándo se entregan o cuándo los abren los destinatarios. Asimismo, puede recibir notificaciones sobre los cambios que se producen en los contactos.
¿Qué eventos están disponibles en Brevo?
Todos los eventos disponibles que se pueden supervisar en Brevo se agrupan en dos categorías:
| Cuando un email: | Cuando un contacto: |
|
|
Encontrará más información sobre los eventos de marketing y los datos asociados en la documentación sobre las API.
| Cuando un email: | |
|
|
Encontrará más información sobre los eventos transaccionales y los datos asociados en la documentación sobre las API.
Crear webhook propio
En el caso de nuestros ejemplos, vamos a centrarnos en el evento "Abierto" de la plataforma transaccional. En esencia, cada vez que enviamos un nuevo email transaccional, recibiremos una notificación a través de nuestro webhook que indicará que el email llegó correctamente a la bandeja de entrada del destinatario.
-
Vaya a la página Webhooks:
- Para eventos de marketing, vaya a Contacts (Contactos) > Settings (Configuración) > Webhooks o Campaigns (Campañas )> Settings (Configuración) > Webhooks.
- Para eventos transaccionales, vaya a Transactional (Transaccional) > Settings (Configuración) > Webhooks.
- Haga clic en Add a new webhook (Añadir un nuevo webhook).
- En el campo URL, introduzca la URL de notificación donde se enviarán los datos cada vez que se active el evento.
- En los campos When the message is (Cuando el mensaje es) o When the contact is (Cuando un contacto es), seleccione los eventos sobre los que desea recibir notificaciones.
- En el campo Description (Descripción), escriba una descripción del webhook.
- Cuando haya terminado, haga clic en Save (Guardar).
- Una vez que haya creado el webhook, le recomendamos que lo pruebe. Junto al webhook que ha creado, haga clic en Actions (Acciones) > Send a test (Enviar una prueba) o Test (Prueba). Una vez que se haya activado el evento, recibirá una notificación en la URL que especificó para el webhook.
Cuando cree un webhook a partir de una automatización, recibirá una notificación cada vez que un contacto llegue al paso Llamada a un webhook en su automatización.
- Vaya a Automations (Automatizaciones).
- Haga clic en Create an automation (Crear una automatización).
- Utilice una automatización predefinida o cree una personalizada.
- Agregue un punto de entrada a la automatización.
- (Opcional) Agregue los pasos que los contactos deben seguir antes de activar el webhook.
- Agregue el paso Call a webhook (Llamada a un webhook) a la automatización:
- En el último paso de su automatización, haga clic en +.
- Seleccione el paso Call a webhook (Llamada a un webhook).
- En el campo Introduzca la URL, escriba la URL de notificación donde se enviarán los datos cada vez que se active el evento.
- (Opcional) Para recibir información sobre el contacto que desencadenó el evento, habilite la opción Quiero enviar propiedades de contacto al webhook.
- Haga clic en OK (Aceptar).
- (Opcional) Agregue otros pasos a su automatización.
- Pruebe la automatización para comprobar que recibe la información.
- Haga clic en Activate the automation (Activar la automatización) para permitir que los contactos entren en la automatización.
Para crear un webhook desde la API, solo tiene que realizar una llamada para configurar la URL del webhook que desee utilizar. A continuación, se muestra una llamada de ejemplo:
| curl --request POST \ --url https://api.brevo.com/v3/webhooks \ --header 'accept: application/json' \ --header 'content-type: application/json' \ --data ' { "url": "http://requestb.in/173lyyx1", "description": "Webhook triggered on opened emails", "events": [ "opened" ], "type": "transactional", "domain": "example.com" } ' |
Para obtener más información sobre la creación de webhooks desde la API, consulte nuestra documentación sobre las API.
Proteger el webhook
Una vez que haya creado y probado el webhook, le recomendamos que lo proteja para asegurarse de que no se pueda acceder a él desde otras partes de la red. Para proteger los webhooks, debe incluir en la lista blanca los siguientes rangos de IP de Brevo:
-
1.179.112.0/20-
Primera dirección IP:
1.179.112.1 -
Última dirección IP:
1.179.127.254
-
Primera dirección IP:
🤔 ¿Tiene alguna duda?
Si tiene alguna pregunta, no dude en ponerse en contacto con nuestro equipo de asistencia mediante la creación de un ticket desde su cuenta. Si todavía no tiene una cuenta, puede ponerse en contacto con nosotros aquí.
Si necesitas ayuda con un proyecto usando Brevo, podemos ponerte en contacto con un socio certificado de Brevo.