Webhook: ¿qué es y para qué sirve?
En lugar de preguntar sin cesar «¿hay novedades?», su software es avisado en el mismo momento en que algo sucede.
Un webhook es un mecanismo mediante el cual un software envía automáticamente una solicitud HTTP con datos a una dirección web elegida en cuanto ocurre un evento preciso, como un pago recibido o una reserva creada. Así, el sistema que recibe el aviso no necesita consultar repetidamente el software de origen.
30 days free, no credit card.
En resumen
- Uno se suscribe una vez a un evento; los avisos llegan después por sí solos.
- El webhook complementa la API: envía la información en lugar de esperar a que se la pidan.
- Hay que verificar la firma de cada mensaje recibido.
- Un buen receptor responde rápido y sabe procesar dos veces el mismo aviso.
¿Cómo funciona un webhook?
La documentación de GitHub resume bien el principio: uno se suscribe a eventos que ocurren en un sistema de software y recibe automáticamente una entrega de datos en su servidor cada vez que suceden. La ventaja es recibir la información en el momento en que se produce, en lugar de consultar una API de vez en cuando para ver si hay novedades [1].
Al crear el webhook, se indica una dirección (URL) y los eventos que interesan. Cuando uno de ellos ocurre, el software de origen envía a esa dirección una solicitud HTTP con los detalles del evento. El servidor que escucha puede entonces actuar: enviar un aviso, actualizar una ficha, iniciar un paso siguiente [1].
Muchos software como servicio ofrecen webhooks. A menudo sirven para crear una orden de trabajo en cuanto llega una reserva, o para avisar a la persona que prepara una cotización.
¿Qué eventos activan un webhook en una pyme de servicios?
| Evento en el software de origen | Datos enviados | Reacción posible |
|---|---|---|
| Pago con tarjeta aceptado | Monto, cliente, número de factura | Marcar la factura como pagada en la contabilidad |
| Reserva creada en el sitio web | Fecha, servicio, datos de contacto | Crear la orden de trabajo del técnico |
| Formulario de cotización completado | Necesidad descrita, dirección | Avisar a la persona que prepara la cotización |
| Suscripción cancelada | Cliente, fecha de finalización | Retirar al cliente de las rutas previstas |
Los eventos disponibles dependen por completo de cada software; consulte su documentación.
¿Qué ocurre si el servidor receptor está caído?
Los buenos proveedores reintentan. Stripe, por ejemplo, indica que en modo real intenta entregar un evento durante un máximo de tres días, con plazos que se alargan entre intentos; en su entorno de pruebas, reintenta tres veces en unas pocas horas [2].
Consecuencia práctica: el mismo aviso puede llegar más de una vez. El receptor debe reconocer un evento ya procesado para no, por ejemplo, crear dos veces la misma factura.
¿Cuántas consultas innecesarias evita un webhook?
¿Qué errores de seguridad y de diseño son frecuentes?
- Aceptar cualquier mensaje recibido en la dirección del webhook sin verificar su firma: cualquiera podría enviar un falso «pago recibido».
- Modificar el cuerpo sin procesar del mensaje antes de verificar la firma: Stripe precisa que cualquier modificación hace fallar la verificación [2].
- Hacer todo el procesamiento antes de responder: con algunos proveedores, una respuesta demasiado lenta puede contarse como un fallo y provocar un nuevo envío.
- No gestionar los duplicados, cuando los reintentos son normales.
- Conectar una automatización que escribe a un cliente apenas se recibe el aviso, sin control humano.
¿Pilotiko utiliza webhooks?
El registro de capacidades de Pilotiko no describe ningún webhook ofrecido a los clientes; por eso no anunciamos ninguno. Nuestra posición sobre los envíos, en cambio, es clara: en Pilotiko, todo lo que afecta a un cliente, al dinero o a un envío espera la aprobación de una persona, aunque la información haya llegado de forma automática.
Preguntas frecuentes
¿Cuál es la diferencia entre un webhook y una API?
Con una API, su programa hace la pregunta cuando lo decide. Con un webhook, el software de origen le avisa por sí mismo cuando ocurre un evento. Ambos suelen complementarse: el webhook señala el cambio y la API sirve luego para leer el detalle.
¿Se necesita un servidor para recibir un webhook?
Se necesita una dirección web accesible que escuche las solicitudes, ya sea su propio servidor, una función alojada o una herramienta de automatización. Esa dirección debe usar HTTPS para proteger los datos transmitidos.
¿Un webhook es instantáneo?
Se envía en el momento del evento, pero el retraso real depende del proveedor y de la red. Si el receptor está caído, el aviso puede llegar mucho más tarde, tras nuevos intentos.
¿Cómo saber si un webhook proviene realmente del software correcto?
La mayoría de los proveedores firman cada mensaje con un secreto que solo usted conoce. Su receptor recalcula la firma y rechaza cualquier mensaje que no coincida.
¿Los webhooks son adecuados para una pequeña empresa?
Sí, sobre todo mediante herramientas de automatización que proporcionan la dirección de recepción por usted. Comience con un solo evento útil, como una nueva reserva, y verifique el resultado durante algunas semanas.
Fuentes
- GitHub Docs, About webhooks (consultado el 15 de octubre de 2026).
- Stripe Docs, Receive Stripe events in your webhook endpoint (consultado el 15 de octubre de 2026).
Para seguir leyendo
- API: ¿qué es una interfaz de programación?¿Qué es una API? El contrato que permite a dos programas intercambiar datos, con un ejemplo cifrado de una pyme quebequense y los errores más frecuentes.
- Automatización de procesos: ¿RPA, flujo de trabajo o agente de IA?Automatizar un proceso: compare la RPA, el flujo de trabajo por reglas y el agente de IA, con un cálculo para una pyme de Quebec y los errores que debe evitar.
- SaaS: ¿qué es un software como servicio?SaaS o software como servicio: qué es, en qué se diferencia del software instalado, un cálculo de suscripción para una pyme y las trampas del contrato.
- OAuth: ¿cómo conectar dos aplicaciones sin compartir su contraseña?OAuth conecta dos aplicaciones sin entregar su contraseña. Funcionamiento, tokens y alcances, ejemplo para una pyme quebequense y errores que debe evitar.
Your whole business, on one screen.
Each department is a room. Pilotiko prepares the work; you approve with one click.
- Call answered
- Appointment confirmed
- Email reply ready
- Invoice prepared