> For the complete documentation index, see [llms.txt](https://b2chat.gitbook.io/b2chat-api-central/llms.txt). Markdown versions of documentation pages are available by appending `.md` to page URLs; this page is available as [Markdown](https://b2chat.gitbook.io/b2chat-api-central/nuestros-servicios/webhooks.md).

# Webhooks

Los webhooks en B2Chat son una herramienta poderosa que te permite recibir notificaciones en tiempo real sobre eventos clave que ocurren en la plataforma. Gracias a esta funcionalidad, es posible integrar fácilmente B2Chat con sistemas externos como CRMs, plataformas de e-commerce o herramientas de automatización de marketing, mejorando significativamente la eficiencia operativa y la capacidad de respuesta hacia tus clientes.

### ¿Cómo funcionan?

Cuando se configura un webhook, B2Chat enviará automáticamente datos relevantes a un endpoint HTTP definido por tu sistema cada vez que ocurra uno de los eventos habilitados. Esto permite automatizar procesos y mantener tus sistemas internos sincronizados con lo que sucede en B2Chat sin intervención manual.

### Configuración

Los webhooks se configuran directamente desde el módulo de B2Chat. Para comenzar:

* Ingresa a tu dashboard de B2Chat.
* Ve a **Configuraciones** → **Integraciones** → **Webhooks**.
* Activa el toggle del módulo para habilitarlo.
* Configura la URL de tu webhook, y opcionalmente un token de autenticación y un email para notificaciones de errores.
* Suscríbete a los eventos que deseas recibir.

Desde el mismo módulo también puedes probar tus eventos antes de activarlos y eliminar la configuración si lo necesitas.

<figure><img src="/files/DHbGiSE3JD4cFXdJJYD9" alt=""><figcaption></figcaption></figure>

{% hint style="info" %}
Para ver el paso a paso completo del proceso, consulta la :link:[Guía de configuración de Webhooks](https://help.b2chat.io/como-configurar-webhooks-en-b2chat).
{% endhint %}

### 💻 Aspectos técnicos

***

Para asegurar una integración segura, confiable y eficiente con los webhooks de B2Chat, es importante tener en cuenta las siguientes consideraciones técnicas:

#### 🔒 Conexión segura (HTTPS)

Todos los eventos generados por B2Chat se envían a través de una conexión segura HTTPS (HTTP sobre TLS). Esto garantiza la confidencialidad e integridad de los datos transmitidos, evitando accesos no autorizados o manipulaciones en tránsito.

#### 🔁 Método HTTP

Los datos de cada evento se envían usando el método HTTP POST al endpoint configurado por tu sistema.

* El servidor receptor debe responder con un código de estado HTTP 200 o 201 para confirmar que la notificación fue recibida correctamente.
* Si no se recibe una respuesta válida, B2Chat considerará el intento fallido y podrá aplicar una política de reintentos (según configuración o diagnóstico).

#### 🧾 Encabezados HTTP (Headers)

Se enviarán encabezados estándar para estructurar y autenticar la solicitud:

* `Content-Type: application/json`\
  Indica que el cuerpo del mensaje está en formato JSON.
* `Authorization: Bearer <token>`\
  Se incluirá un **token de autenticación** en el encabezado para validar la procedencia del mensaje.

### 🛑 Manejo de Errores

***

Para garantizar la estabilidad y trazabilidad del envío de eventos desde B2Chat, se implementa un sistema de manejo de errores que ayuda a identificar fallos de integración y prevenir pérdidas de información:

#### 📭 Formato de solicitud no aceptado

Si el servidor receptor **no puede interpretar el formato de la solicitud**, debe responder con el código de estado **HTTP `415 Unsupported Media Type`**.\
Esto indica que el endpoint no reconoce el tipo de contenido enviado (por ejemplo, `application/json`) y ayuda a B2Chat a identificar que hay un error de compatibilidad.

#### ⚙️ Fallos en el endpoint

Cuando el **endpoint configurado no responde** correctamente o se encuentra inactivo, B2Chat:

* Enviará una **notificación por correo electrónico** al administrador registrado con los detalles del fallo.
* Esta notificación se emitirá por un **período de tiempo limitado**, permitiendo detectar el error y tomar acciones correctivas rápidamente.
* Si el problema persiste y no se logra establecer comunicación con el endpoint, **B2Chat detendrá el envío de eventos al webhook** de forma automática para evitar sobrecarga o repetidos intentos fallidos.

<figure><img src="/files/NJTE231KHn7P0D2mnNYI" alt=""><figcaption></figcaption></figure>

{% hint style="info" %}
El correo electrónico al cual se enviarán estas notificaciones puede ser configurado solicitándolo al equipo de soporte.
{% endhint %}