Los webhooks entrantes permiten recibir datos en tiempo real en Brevo desde una aplicación externa. Cada vez que se produce un evento en tu aplicación externa, Brevo recibe un webhook que contiene los detalles del evento. A continuación, puedes:

• Activar un evento personalizado en Brevo; o
• Crear o actualizar automáticamente un contacto según los datos recibidos.

Información relevante

• Los webhooks entrantes se están implementando gradualmente y es posible que aún no esté disponible en todas las cuentas.
• Puedes crear hasta 20 webhooks entrantes en tu cuenta de Brevo. Para añadir un nuevo webhook a partir de este límite, deberás eliminar uno existente.
• Cada URL de webhook puede gestionar hasta 20 eventos por segundo.
• Por ahora, solo puedes recuperar datos del primer nivel de jerarquía de la carga útil JSON. Es decir, puedes acceder directamente a matrices y objetos de nivel superior, pero no puedes recuperar datos de matrices anidadas o niveles más profundos.
• Si deseas crear webhooks salientes para enviar datos en tiempo real desde Brevo a una aplicación externa, consulta nuestro artículo dedicado Nuevos webhooks: cómo crear webhooks salientes para enviar datos en tiempo real desde Brevo a una aplicación externa.

Paso 1: Crear un webhook entrante en Brevo

Para comenzar, debes crear un webhook entrante en Brevo.

1. En Brevo, haz clic en el menú desplegable de la cuenta y selecciona Integrations (Integraciones).
2. Ve a la pestaña Webhooks.
3. Haz clic en Add webhook (Añadir webhook).
   
4. Selecciona Inbound webhook (Webhook entrante).
5. Haz clic en Add webhook (Añadir webhook).
   

Paso 2: Configurar el webhook entrante en Brevo

A continuación, configura el webhook entrante en Brevo.

1. Introduce un nombre para el webhook.
   
2. Haz clic en Continue (Continuar).
3. Selecciona el método HTTP que deseas utilizar para este webhook (POST, GET, PUT o PATCH).
4. Copia la URL del webhook generada por Brevo. Esta URL de devolución de llamada indica a tu aplicación externa dónde enviar el webhook entrante cuando se produzca un evento.
   
5. Pega la URL del webhook en tu aplicación externa. Generalmente, esto se hace desde una página de configuración de webhooks, una sección de automatización o mediante una integración de API.
   
   💡 Información relevante

   Si no estás seguro de dónde pegar la URL del webhook, consulta el centro de ayuda de la aplicación externa o ponte en contacto con el equipo de asistencia.
6. (Opcional) Para añadir una capa adicional de seguridad, o si tu aplicación externa lo requiere:
   1. Activa la opción Require authentication (Requerir autenticación).
   2. Copia el token generado por Brevo.
      
      
      💡 Información relevante

      Si tu token se ve comprometido, puedes volver a generarlo haciendo clic en el icono de actualización 🔄 y actualizándolo en tu aplicación externa.
   3. Pega el token en tu aplicación externa.
7. Finaliza la configuración del webhook entrante en tu aplicación externa. Puede que se te pida que selecciones:
   • El evento que activará el webhook.
   • Los datos que se incluirán en la carga útil.

Paso 3: Enviar una solicitud de prueba y elegir la carga útil a sincronizar

Prueba el webhook entrante y confirma la recepción de los datos del evento.

1. Envía una solicitud de prueba desde tu aplicación externa a Brevo. 
2. Verifica los datos del evento recibidos para asegurarte de que contienen todos los parámetros que deseas sincronizar. Si falta alguna información, envía solicitudes de prueba adicionales hasta que se reciba la carga útil correcta.
   
3. (Opcional) Si se han enviado varias solicitudes de prueba:
   1. Haz clic en 🔄 Reload (Recargar).
   2. Utiliza el menú desplegable para seleccionar la carga útil deseada de entre las 10 últimas recibidas.
      
4. Haz clic en Continue (Continuar).

Paso 4: Configurar la acción activada por el webhook entrante

Configura la acción que se activará en Brevo cuando se reciba el webhook. Esto implica asignar las claves de carga útil (los datos del evento recibidos en el webhook entrante) a los atributos de Brevo para garantizar que los datos entrantes tienen el formato correcto y activan la acción adecuada.

Puedes elegir entre dos acciones disponibles:

• Opción 1: Crear un evento
  Realiza un seguimiento de las acciones externas en Brevo mediante la creación de un evento personalizado.
• Opción 2: Crear o actualizar un contacto
  Añade o actualiza automáticamente datos de contacto en Brevo.

Una vez activado, el webhook entrante enviará datos desde tu aplicación externa a Brevo cada vez que se active. A continuación, puedes utilizar los datos recibidos para realizar diversas acciones, como:

• Segmentar los contactos en función de los datos del evento.
• Activar automatizaciones mediante eventos personalizados.
• Personalizar emails, SMS u otros mensajes.

Revisar los logs de un webhook entrante para solucionar problemas

Cada vez que se activa un webhook entrante, se envían datos desde tu aplicación externa a Brevo, donde se procesan las acciones del webhook. Puedes revisar los logs de un webhook entrante para verificar si las acciones se ejecutaron correctamente e identificar posibles problemas para solucionarlos.

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 Inbound webhook (Webhook entrante). Aquí encontrarás una descripción general de las acciones procesadas en las últimas 24 horas y su estado para cada webhook entrante:
   
   • Mapped (Asignada): la acción se ha procesado correctamente.
   • Not mapped (No asignada): se ha producido un error y la acción no se ha procesado.
     
4. Haz clic en el nombre del webhook entrante para acceder a sus logs.
5. En la pestaña Logs, revisa los logs del webhook entrante:
   
   
   1. Filtrar por estado: visualiza todas las acciones, solo las asignadas o las no asignadas.
   2. Actualizar logs: obtén los datos más recientes en tiempo real.
   3. Ver llamadas de webhook entrante: revisa la marca de tiempo y la carga útil procesada de cada llamada de webhook.
   4. Revisar acciones y atributos procesados: visualiza las acciones que Brevo ha gestionado después de recibir un webhook entrante y consulta los datos pasados de cada acción. Si se produce un error, compara el tipo de clave esperado con el valor recibido.

Desactivar un webhook entrante

Si necesitas dejar de recibir datos de tu aplicación externa temporalmente, puedes desactivar el webhook entrante.

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 Inbound webhook (Webhook entrante).
4. Desmarca el webhook entrante que deseas desactivar.
   

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

Eliminar un webhook entrante

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

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 Inbound webhook (Webhook entrante).
4. Haz clic en el icono de la papelera situado junto al webhook entrante que deseas eliminar.
   
5. Haz clic en Delete webhook (Eliminar webhook) para confirmar.

El webhook entrante y su URL de devolución de llamada asociada se han eliminado de forma permanente.

⏭️ ¿Qué es lo siguiente?

• Nuevos webhooks: cómo crear webhooks salientes para enviar datos en tiempo real desde Brevo a una aplicación externa
• Enviar webhooks salientes 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 la agencia partner de Brevo adecuada.