> 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.
{% 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 `\
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.
{% hint style="info" %}
El correo electrónico al cual se enviarán estas notificaciones puede ser configurado solicitándolo al equipo de soporte.
{% endhint %}
---
# Agent Instructions
This documentation is published with GitBook. GitBook is the documentation platform designed so that both humans and AI agents can read, navigate, and reason over technical content effectively. Learn more at gitbook.com.
## Querying This Documentation
If you need additional information that is not directly available in this page, you can query the documentation dynamically by asking a question.
Perform an HTTP GET request on the current page URL with the `ask` query parameter:
```
GET https://b2chat.gitbook.io/b2chat-api-central/nuestros-servicios/webhooks.md?ask=
```
The question should be specific, self-contained, and written in natural language.
The response will contain a direct answer to the question and relevant excerpts and sources from the documentation.
Use this mechanism when the answer is not explicitly present in the current page, you need clarification or additional context, or you want to retrieve related documentation sections.