Los webhooks salientes permiten enviar datos en tiempo real desde Brevo a una aplicación externa. Cuando se produzca un evento específico en Brevo, tu aplicación externa recibirá una notificación con los detalles del evento.

Puedes crear webhooks salientes para eventos relacionados con las siguientes funcionalidades de Brevo:

Información relevante

• Todos los webhooks salientes existentes creados desde las páginas Contacts (Contactos), Campaigns (Campañas) o Transactional (Transaccional) mediante la experiencia clásica para la gestión de webhooks se han migrado a la página Webhooks.
• Puedes crear hasta 40 webhooks salientes en tu cuenta de Brevo. Si se supera este límite, elimina un webhook existente para crear uno nuevo.
• También puedes crear webhooks salientes desde una automatización o desde la API.
• Si deseas crear webhooks entrantes para recibir datos en tiempo real desde otra aplicación en Brevo, consulta nuestro artículo dedicado Cómo crear webhooks entrantes para recibir datos en tiempo real en Brevo.

Antes de empezar

Asegúrate de recuperar desde tu aplicación externa:

• La URL del servidor o punto de conexión al que deseas enviar el webhook saliente
• (Opcional) El método de autenticación y las credenciales necesarias
• Cualquier nombre y valor de encabezado necesario

Si no estás seguro de dónde recuperar esta información, consulta el centro de ayuda de la aplicación externa o ponte en contacto con el equipo de asistencia.

Paso 1: Crear un webhook saliente en Brevo

Para comenzar, debes crear un webhook saliente en Brevo.

1. En Brevo, haz clic en el nombre de tu cuenta y selecciona Integrations (Integraciones).
2. Ve a la pestaña Webhooks.
3. Haz clic en Add webhook (Añadir webhook).
   
4. Selecciona Outbound webhook (Webhook saliente).
5. Haz clic en Add webhook (Añadir webhook).
   

Paso 2: Configurar el webhook saliente

A continuación, configura el nombre, la URL y el método de autenticación del webhook saliente.

1. Introduce un nombre para el webhook.
2. Haz clic en Continue (Continuar).
3. Introduce la URL del servidor o punto de conexión al que desear enviar tus eventos. De este modo, Brevo sabrá dónde enviar el webhook saliente cuando se produzca un evento.
   

4. (Opcional) De forma predeterminada, se selecciona No authentication (Sin autenticación) como método de autenticación. Para añadir una capa adicional de seguridad, o si la aplicación externa a la que envías el webhook lo requiere, puedes elegir cualquier de las dos opciones:

   • Autenticación básica (nombre de usuario y contraseña); o

   • Autenticación con token
     

5. (Opcional) Para añadir un encabezado a tu webhook saliente:
   1. Haz clic en + Add an object (Añadir un objeto).
   2. Introduce el nombre y el valor del encabezado.
      
6. Haz clic en Continue (Continuar).

Paso 3: Elegir los eventos y enviar solicitudes de prueba

Por último, elige los eventos para los que deseas recibir el webhook saliente y envía solicitudes de prueba a tu aplicación externa.

1. Selecciona la categoría de evento para la que deseas crear un webhook saliente (por ejemplo, email transaccional, oportunidades, formularios, etc.).
   
   💡 Información relevante

   Los eventos de contactos se encuentran en la categoría de eventos Emails de marketing.
2. De forma predeterminada, se activan todos los eventos de la categoría seleccionada. Si es necesario, puedes desactivar eventos específicos desmarcándolos.
   
3. (Opcional) Para enviar solicitudes de prueba para los eventos:
   1. Haz clic en el icono de tres puntos al lado de un evento y selecciona Send test request (Enviar solicitud de prueba).
      
   2. Comprueba tu aplicación externa para confirmar si has recibido el webhook saliente.
4. Haz clic en Activate webhook (Activar webhook) cuando hayas terminado.

Proteger los webhooks salientes

Para proteger tus webhooks salientes, debes incluir en la lista blanca algunos de los intervalos de IP de Brevo. De esta forma, se garantiza que solo las solicitudes autorizadas puedan activar los webhooks. 

➡️ Para obtener más información, consulta nuestro artículo dedicado Intervalos de IP de Brevo: lista de servicios expuestos públicamente.

Eliminar un webhook saliente

Si ya no necesitas un webhook saliente, puedes eliminarlo permanentemente.

1. En Brevo, haz clic en el nombre de tu cuenta y selecciona Integrations (Integraciones).
2. Ve a la pestaña Webhooks.
3. Selecciona la opción Outbound webhook (Webhook saliente).
4. Haz clic en el icono de la papelera 🗑️ situado junto al webhook saliente que deseas eliminar.
   
5. Haz clic en Delete webhook (Eliminar webhook) para confirmar.

El webhook saliente se ha eliminado de forma permanente.

🤔 ¿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 la agencia partner de Brevo adecuada.