Qué es un webhook, explicado para no desarrolladores: cómo conectar tu chatbot con tus herramientas
Un webhook es un mensaje automático que una app envía a otra en cuanto pasa algo. Cómo funcionan los webhooks de un chatbot, en qué se diferencian de una API y cómo mantenerlos…

En este artículo
Entonces, ¿qué es un webhook? Un webhook es un mensaje automático que una app envía a otra en el momento en que ocurre algo, por ejemplo, cuando tu chatbot capta un lead nuevo. En lugar de que tus otras herramientas pregunten "¿hay algo nuevo?" cada pocos minutos, el chatbot se lo dice al momento.
Piensa en la diferencia entre bajar al buzón cada hora y tener un timbre. El timbre solo suena cuando de verdad hay alguien en la puerta.
A continuación: cómo funcionan los webhooks de un chatbot, en qué se diferencian de una API, qué eventos merece la pena enviar y cómo mantenerlos seguros.
Puntos clave
- Un webhook envía datos a otro sistema cuando ocurre un evento; una API suele ser algo a lo que llamas para obtener datos.
- Los webhooks útiles de un chatbot se disparan con eventos de negocio, como un lead nuevo, un traspaso a una persona o una conversación cerrada.
- Las firmas HMAC demuestran que un mensaje es auténtico, y los reintentos garantizan que una caída breve no haga perder datos.
Qué es un webhook, explicado de forma sencilla
Un webhook tiene tres partes:
- Un evento: algo ocurre en la app de origen, como que un visitante deje su email en el chat.
- Una URL: la dirección del sistema que recibe, a menudo llamada endpoint. La pegas en la configuración de la app de origen.
- Un payload: un pequeño paquete de datos, normalmente en JSON, que describe lo que ha pasado.
Cuando se produce el evento, la app de origen envía el payload a esa URL. El sistema receptor lo lee y hace algo útil: crea un contacto, publica una alerta o añade una fila a una hoja de cálculo. Nadie tiene que pulsar un botón ni escribir un script que compruebe si hay cambios.
Tampoco tienes que construir tú el extremo receptor. Las plataformas de automatización como Zapier, Make y n8n pueden generarte una URL de webhook en unos pocos clics, y por eso los webhooks están al alcance de quien no programa.
Webhook vs API: ¿en qué se diferencian?
Mucha gente los trata como rivales, pero funcionan en pareja. Una API (interfaz de programación de aplicaciones) es un conjunto de puertas de entrada a una app a las que llamas para leer o modificar datos. Un webhook es la app llamando a tu puerta cuando ocurre algo.
Sin webhooks, la única forma de enterarte de los eventos nuevos es el polling: preguntarle a la API una y otra vez si ha cambiado algo.
| Webhook (push) | Polling a la API (pull) | |
|---|---|---|
| Quién lo inicia | La app de origen, cuando ocurre un evento | Tu sistema, de forma programada |
| Velocidad | Casi en tiempo real | Tan rápido como tu intervalo de consulta |
| Ideal para | Alertas, sincronizar registros nuevos, iniciar flujos de trabajo | Exportaciones masivas, informes, consultas puntuales |
| Configuración | Pegar una URL y elegir los eventos | Escribir un script o una tarea programada |
| Principal riesgo | Mensajes perdidos si el receptor está caído (se resuelve con reintentos) | Retrasos, peticiones inútiles, límites de uso |
Muchas integraciones usan las dos cosas. Un webhook dice "la conversación 123 se acaba de traspasar" y, después, el sistema receptor llama a la API si necesita más detalle.
Webhooks de un chatbot: eventos de ejemplo que merece la pena enviar
Los mejores webhooks de un chatbot se corresponden con momentos que a tu equipo ya le importan. Tres ejemplos habituales:
Lead nuevo captado
Un visitante comparte sus datos de contacto y responde a una o dos preguntas de cualificación. Usos habituales: crear o actualizar un contacto en el CRM, avisar en el canal de ventas o añadir el lead a una lista de nutrición (con su consentimiento). Como responder rápido a los leads nuevos cierra más ventas, suele ser el primer webhook que configuran los equipos.
Conversación traspasada a una persona
El asistente ha decidido que debe intervenir una persona, o el cliente lo ha pedido. Usos habituales: avisar al agente de guardia, abrir un ticket en el help desk o marcar una cuenta prioritaria. El payload debe llevar el contexto en el que se apoya tu proceso de traspaso del chatbot a un agente humano, como la intención, las etiquetas y los datos de contacto.
Conversación cerrada
Una conversación ha terminado, resuelta por la IA o por un agente. Usos habituales: registrarla para los informes, actualizar un panel o crear una tarea de seguimiento.
Una regla sencilla: suscríbete solo a los eventos con los que vayas a hacer algo. Cada webhook que activas es una cosa más que vigilar.
Seguridad de los webhooks: firmas, reintentos y seguimiento de entregas
Una URL de webhook no es más que una dirección en internet. ¿Qué impide que alguien le envíe mensajes falsos de "lead nuevo"? ¿Y qué pasa si tu servidor está caído diez minutos? Tres salvaguardas responden a esas preguntas.
Firmas HMAC. El emisor y el receptor comparten una clave secreta. El emisor calcula una firma a partir del payload y del secreto y la incluye en cada petición. El receptor la vuelve a calcular y rechaza todo lo que no coincida, así que los mensajes falsificados o manipulados no pasan.
Reintentos. Si el receptor no confirma la entrega, el emisor vuelve a intentarlo más tarde, normalmente con intervalos cada vez mayores entre intentos. Una caída breve no significa perder datos.
Circuit breakers y seguimiento de entregas. Si un endpoint sigue fallando, un circuit breaker pausa las entregas durante un tiempo en lugar de bombardear un servidor que no funciona. Los registros de entregas muestran qué se ha enviado y si ha llegado bien, para que puedas depurar sin adivinar.
En el lado receptor, unos pocos hábitos evitan la mayoría de los problemas:
- Verifica la firma antes de usar los datos.
- Responde rápido con un código de éxito y haz el trabajo pesado en segundo plano.
- Cuenta con los duplicados: un reintento puede entregar el mismo evento dos veces, así que usa el ID del evento para saltarte las repeticiones.
- Usa solo endpoints HTTPS.
- Reenvía solo los datos personales que necesita la herramienta receptora; las normas del RGPD para chatbots de IA siguen aplicándose cuando los datos salen del chat.
Cómo gestiona Conviro los webhooks en tiempo real
Conviro ofrece webhooks en tiempo real. Los eventos llegan a tu endpoint en el momento en que ocurren, firmados con HMAC para que puedas verificar cada petición, con reintentos automáticos si la entrega falla y protegidos por un circuit breaker. El seguimiento de entregas muestra qué se ha enviado y si ha llegado.
Apunta esos webhooks a tu propio código o a una herramienta no-code: Conviro también se conecta con Zapier, Make y n8n, y ofrece una API REST con autenticación por bearer token y claves con permisos limitados para obtener datos cuando los necesites. Todo esto está disponible a partir del plan Pro. La documentación para desarrolladores explica los payloads y la verificación de firmas, y la página de integraciones de automatización muestra las opciones sin código.
Preguntas frecuentes
¿Qué es un webhook en palabras sencillas?
Un webhook es una notificación automática que una app envía a otra cuando ocurre un evento concreto. Le das a la app de origen una URL, eliges los eventos y, cada vez, envía un pequeño paquete de datos a esa URL. Funciona como un timbre para el software: el sistema receptor se entera de los cambios al instante en lugar de comprobarlo una y otra vez.
¿Necesito un desarrollador para usar webhooks?
No siempre. Las plataformas de automatización como Zapier, Make y n8n te generan una URL de webhook y te permiten asignar los datos entrantes a acciones en un editor visual. Un desarrollador resulta útil cuando construyes tu propio endpoint, verificas las firmas en código o conectas un sistema interno que no tiene un conector ya hecho.
¿Es un webhook más rápido que una API?
Para enterarte de los eventos nuevos, sí. Un webhook llega instantes después del evento, mientras que consultar una API solo es tan rápido como la frecuencia con la que compruebas. Para datos históricos o más detalle, la API es la herramienta adecuada. La mayoría de las integraciones bien hechas usan webhooks para avisar y la API para consultar.
¿Qué pasa si mi endpoint de webhook está caído?
Depende del emisor. Los buenos sistemas de webhooks reintentan las entregas fallidas durante un tiempo, así que las caídas breves no hacen perder datos, y algunos pausan las entregas a un endpoint que sigue fallando. Comprueba si tu proveedor hace reintentos y asegúrate de que tu endpoint puede gestionar sin problemas el mismo evento si llega dos veces.
Próximos pasos
Elige un evento con el que harías algo hoy mismo, normalmente los leads nuevos, y conéctalo a la herramienta en la que ya trabaja tu equipo. Cuando funcione de forma fiable, añade los traspasos y las conversaciones cerradas. Empieza gratis con Conviro para configurar tu asistente y pasa al plan Pro cuando quieras conectar webhooks.
Publicado por
Conviro
Comparte conocimientos sobre soporte al cliente con IA, automatización de chatbots y estrategias de crecimiento SaaS.
Desarrolla sobre Conviro
Conecta los flujos conversacionales con tu stack
Revisa los recursos para desarrolladores y los patrones de integración antes de diseñar la implementación.
Artículos relacionados
Más publicaciones
Engineering
IMAP o POP3 (y SMTP): cómo conectar un buzón de soporte a un asistente de IA
7 min de lectura
Leer artículo

Engineering
API de chatbot: 7 formas de sacar partido a tus conversaciones de soporte
7 min de lectura
Leer artículo