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

• Puedes crear hasta 40 webhooks salientes por cuenta de Brevo. Si alcanzas este límite, elimina un webhook existente antes de crear uno nuevo.
• También puedes crear webhooks salientes mediante una automatización o la API.
• Para crear webhooks entrantes y 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 crear un webhook saliente en Brevo:

1. En Brevo, haz clic en el nombre de tu cuenta y selecciona Integrations (Integraciones) > Webhooks.
2. Haz clic en Add webhook (Añadir webhook).
   
3. Selecciona Outbound webhook (Webhook saliente).
4. 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. Selecciona tu estrategia de envío de webhook:
   • Enviar uno a la vez
     Envía los eventos individualmente en tiempo real.
   • Enviar por lotes
     Envía los eventos en lotes de hasta 500. Se recomienda si tienes límites de velocidad más bajos, ya que puede reducir el número de solicitudes.
7. 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.

Supervisar la entrega de webhooks y configurar alertas

Supervisa la entrega de tus eventos de webhooks salientes y configura alertas para recibir notificaciones cuando surjan problemas.

Revisar las estadísticas de webhooks

El panel de supervisión te ayuda a realizar un seguimiento del estado de entrega de tus eventos de webhooks salientes. Esto te permite identificar rápidamente los problemas de entrega.

Para revisar las estadísticas de tus eventos de webhooks salientes:

1. En Brevo, haz clic en el nombre de tu cuenta y selecciona Integrations (Integraciones) > Webhooks.
2. En la pestaña Outbound webhooks (Webhooks salientes), haz clic en el webhook saliente que quieras supervisar.

3. En Statistics (Estadísticas), revisa el estado de entrega de tus eventos de webhooks salientes:

   📨 Estados de entrega📊 Gráfico de barras

   

   Consulta el número de eventos de webhooks salientes de las últimas 24 horas en tres estados de entrega:

   • ❌ Failed (Fallido): el número de eventos únicos de webhooks salientes que no se pudieron entregar tras 24 horas de reintentos y se descartaron.
   • ⚠️ Retries (Reintentos): el número de eventos únicos de webhooks salientes que se están reintentando actualmente en las últimas 24 horas. Para obtener más información sobre el mecanismo de reintento, consulta nuestra documentación sobre las API dedicada.
   • ✅ Delivered (Entregados): el número de eventos únicos de webhooks salientes entregados correctamente en las últimas 24 horas.

   

   El gráfico de barras de las últimas 24 horas muestra el número de eventos de webhooks salientes en cada estado con un desglose por horas. Puedes pasar el cursor sobre una barra para ver el número exacto de eventos únicos de webhooks salientes que se están reintentando, entregando o que han fallado durante esa hora.

Configurar alertas de webhook

Configura alertas por email para recibir notificaciones cuando los problemas en la entrega de eventos de webhooks salientes alcancen un umbral definido. Las alertas se envían al email predeterminado de tu cuenta, con un máximo de una notificación por hora cuando se alcanza un umbral.

Para configurar alertas de webhook:

1. En Alert configuration (Configuración de alertas), activa las alertas que quieras recibir:
   • Alerta de reintentos
     Establece un umbral para recibir una notificación cuando el número de reintentos de eventos de webhooks salientes alcance este valor. El umbral mínimo es 50.
   • Alerta de fallos
     Establece un umbral para recibir una notificación cuando el número de eventos de webhooks salientes fallidos alcance este valor. El umbral mínimo es 50.
     
2. Haz clic en Save (Guardar).

Desactivar un webhook saliente

Si necesitas detener temporalmente el envío de datos desde Brevo a tu aplicación externa, puedes desactivar el webhook saliente.

1. En Brevo, haz clic en el menú desplegable de la cuenta y selecciona Integrations (Integraciones).
2. Ve a la pestaña Webhooks.
3. Selecciona la opción Outbound webhook (Webhook saliente).
4. Desmarca el webhook saliente que quieras desactivar.
    

El webhook saliente ahora está desactivado (botón gris). Puedes volver a activarlo en cualquier momento.

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.