Crear webhooks para recibir actualizaciones en tiempo real sobre los emails y los contactos

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: 

Eventos de marketing Eventos transaccionales
Cuando un email: Cuando un contacto:
  • Se marca como spam
  • Se rechaza mediante hard bounce
  • Se entrega
  • Se abre
  • Se cancela su suscripción
  • Se hace clic en él
  • Se rechaza mediante soft bounce
  • Se agrega a una lista
  • Se actualiza
  • Se elimina

Encontrará más información sobre los eventos de marketing y los datos asociados en la documentación sobre las API.

Crear webhook propio

💡 Información relevante
Puede crear hasta 40 webhooks para emails transaccionales y de marketing. 

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.

Desde Contacts (Contactos), Campaigns (Campañas) o Transactional (Transaccional) Uso de una automatización Uso de la API
  1. Vaya a la página Webhooks:
  2. Haga clic en Add a new webhook (Añadir un nuevo webhook).
  3. En el campo URL, introduzca la URL de notificación donde se enviarán los datos cada vez que se active el evento. 
  4. 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.
  5. En el campo Description (Descripción), escriba una descripción del webhook.

  6. Cuando haya terminado, haga clic en Save (Guardar).
  7. 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.

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:

  • 185.107.232.0/24
    • Primera dirección IP: 185.107.232.1
    • Última dirección IP: 185.107.232.254
  • 1.179.112.0/20
    • Primera dirección IP: 1.179.112.1
    • Última dirección IP: 1.179.127.254
💡 Información relevante
Estos rangos de IP corresponden a los webhooks de marketing, los webhooks transaccionales y los webhooks invocados directamente desde una automatización.

🤔 ¿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.

💬 ¿Fue útil este artículo?

Usuarios a los que les pareció útil: 6 de 27