¿Cómo configurar Webhooks en B2Chat?

1. ¿Cómo acceder al módulo de Webhooks?

1. Ingresa a tu dashboard de B2Chat.
2. Ve a Configuraciones → Generales → Integraciones → Webhooks.
3. Activa el toggle del módulo para habilitarlo.

Una vez activado, verás dos secciones disponibles: Configurar webhook y Configurar eventos.

2. ¿Cómo configurar tu webhook?

1. Haz clic en Configurar webhook.
2. Ingresa la URL del webhook — campo obligatorio. Sin una URL válida no podrás guardar.
3. (Opcional) Ingresa un Token de autenticación. Si lo haces, podrás ver en pantalla cómo se enviará en el header: Authorization: Bearer {token}. Si no lo ingresas, las notificaciones se enviarán sin header de autenticación.
4. (Opcional) Ingresa un Email de notificación para errores.
5. Haz clic en Guardar.

💡 Si prefieres generar un token seguro automáticamente, usa el botón Generar que aparece cuando el campo de token está vacío. El sistema creará un token criptográficamente seguro e invalidará cualquier token anterior.

⚠️ Importante: Debes guardar exitosamente la configuración del webhook antes de poder suscribirte a eventos o probarlos.

3. ¿Cómo suscribirte a eventos?

1. Haz clic en Configurar eventos.
2. Se abrirá un modal con los los eventos disponibles. (Puedes ver más en la documentación de desarrollador)
3. Selecciona uno o varios eventos según lo que quieras monitorear.
4. Para ver los detalles de un evento antes de seleccionarlo, haz clic en Ver detalle. Allí encontrarás el nombre, descripción y previsualización del payload que se enviará.
5. Haz clic en Guardar para confirmar tu selección.

4. ¿Cómo probar tu webhook?

Antes de activar el envío real, puedes verificar que tu endpoint recibe correctamente los eventos.

1. Accede a Configurar eventos y haz clic en Ver detalle sobre el evento que deseas probar.
2. Haz clic en el botón Probar.
3. El sistema enviará el payload del evento a la URL configurada y mostrará el resultado.

Los posibles resultados son:

• ✅ Éxito: B2Chat envió el evento y tu endpoint respondió correctamente (código 2xx).
• ❌ Error en tu endpoint: B2Chat envió el evento pero tu sistema respondió con error (4xx o 5xx). Se mostrará el código y mensaje de error.
• ❌ Error de envío: B2Chat no pudo enviar el evento (fallo de red o error interno). No se mostrará información de tu endpoint.

⚠️ Importante: El botón Probar estará deshabilitado si no has configurado tu URL. Al pasar el cursor sobre él, verás el mensaje: "Por favor, configura tu webhook primero".

5. ¿Cómo eliminar un webhook?

1. Ingresa al modal de Edición de tu webhook.
2. Borra el contenido del campo URL.
3. Haz clic en Aceptar.
4. Confirma la eliminación en el modal de confirmación.

Al confirmar, se eliminan el webhook, el token y el email configurados, se desuscriben todos los eventos y el toggle del módulo vuelve a estado OFF.

⚠️ Importante: Esta acción no se puede deshacer. Si vuelves a activar el toggle, deberás configurar el webhook desde cero.

Ahora ya sabes cómo configurar Webhooks en B2Chat para recibir notificaciones en tiempo real en tus sistemas. Explora los 10 eventos disponibles y configura solo los que sean relevantes para tu operación.

Si tienes dudas sobre la integración con tu sistema, consulta con tu asesor asignado. 🤗