En este artículo se describe la nueva experiencia de gestión de webhooks, que ofrece más eventos y capacidades mejoradas.
Todos tus webhooks salientes existentes se han migrado automáticamente, por lo que puedes empezar a utilizar la nueva experiencia de inmediato sin necesidad de volver a crear ni reconfigurar nada.
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:
- En Brevo, haz clic en el nombre de tu cuenta y selecciona Integrations (Integraciones) > Webhooks.
- Haz clic en Add webhook (Añadir webhook).
- Selecciona Outbound webhook (Webhook saliente).
- 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.
- Introduce un nombre para el webhook.
- Haz clic en Continue (Continuar).
- 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.
- (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
- (Opcional) Para añadir un encabezado a tu webhook saliente:
- Haz clic en + Add an object (Añadir un objeto).
- Introduce el nombre y el valor del encabezado.
- 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.
-
Enviar uno a la vez
- 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.
-
Selecciona la categoría de evento para la que deseas crear un webhook saliente
(por ejemplo, email transaccional, oportunidades, formularios, etc.).
💡 Información relevanteLos eventos de contactos se encuentran en la categoría de eventos Emails de marketing. -
De forma predeterminada, se activan todos los eventos de la categoría seleccionada. Si
es necesario, puedes desactivar eventos específicos desmarcándolos.
-
(Opcional) Para enviar solicitudes de prueba para los eventos:
-
Haz clic en el icono de tres puntos al lado de un evento y selecciona Send test request (Enviar solicitud de prueba).
- Comprueba tu aplicación externa para confirmar si has recibido el webhook saliente.
-
Haz clic en el icono de tres puntos al lado de un evento y selecciona Send test request (Enviar solicitud de prueba).
- 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.
- En Brevo, haz clic en el nombre de tu cuenta y selecciona Integrations (Integraciones).
- Ve a la pestaña Webhooks.
- Selecciona la opción Outbound webhook (Webhook saliente).
- Haz clic en el icono de la papelera 🗑️ situado junto al webhook saliente que deseas eliminar.
- 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.