# Webhooks y Eventos: Conectar tu Chatbot con Sistemas Externos en Tiempo Real
Los **webhooks** son el puente que conecta tu Chatbot Builder de Wazaut con el resto de tu ecosistema tecnológico. Permiten que tu chatbot envíe información en tiempo real a sistemas externos cada vez que ocurre un evento específico, habilitando integraciones poderosas sin código complejo.
En esta guía completa, aprenderás a configurar webhooks, entender los eventos disponibles, implementar seguridad robusta y crear integraciones que transformarán tu chatbot en el centro neurálgico de tu operación.
## ¿Qué son los Webhooks?
Un **webhook** es una notificación HTTP automática que se dispara cuando ocurre un evento en tu chatbot. En lugar de consultar constantemente si algo cambió (polling), los webhooks «empujan» la información al instante.
**Analogía Simple**:
– **Polling** = Llamar cada 5 minutos preguntando «¿ya llegó mi paquete?»
– **Webhook** = El mensajero te llama apenas llega el paquete
## Eventos Disponibles en Wazaut
Wazaut ofrece 12 eventos principales que puedes capturar vía webhooks:
| Evento | Cuándo se Dispara | Payload Incluye |
|——–|——————|—————–|
| **conversation.started** | Usuario inicia conversación | contacto, origen, timestamp |
| **message.received** | Chatbot recibe mensaje | mensaje, tipo, contacto |
| **message.sent** | Chatbot envía mensaje | mensaje, estado, timestamp |
| **variable.captured** | Se captura una variable | nombre, valor, tipo |
| **flow.completed** | Usuario completa un flujo | flow_id, duración, resultado |
| **human.requested** | Usuario pide hablar con humano | motivo, prioridad, contexto |
| **lead.qualified** | Lead cumple criterios | score, datos, categoría |
| **purchase.completed** | Se completa una compra | productos, total, método_pago |
| **appointment.scheduled** | Se agenda una cita | fecha, servicio, contacto |
| **error.occurred** | Ocurre un error en el bot | tipo_error, nodo, detalles |
| **session.timeout** | Conversación expira por inactividad | duración, último_mensaje |
| **rating.submitted** | Usuario califica la conversación | rating, comentario, NPS |
Continúa leyendo los artículos de Integraciones para dominar webhooks y bases de datos.