# Webhook: ¿qué es y para qué sirve?

> Un webhook envía un aviso automático cuando ocurre un evento en un software. Cómo funciona, ejemplo con cifras para una pyme y errores de seguridad frecuentes.

Actualizado el 15 de octubre de 2026 · https://app.pilotiko.com/es/glosario/webhook

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.

## 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](https://app.pilotiko.com/es/glosario/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](https://app.pilotiko.com/es/glosario/saas) ofrecen webhooks. A menudo sirven para crear una [orden de trabajo](https://app.pilotiko.com/es/glosario/orden-de-trabajo) en cuanto llega una reserva, o para avisar a la persona que prepara una [cotización](https://app.pilotiko.com/es/glosario/soumission).

## ¿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?

**Cálculo: una clínica de fisioterapia de 3 salas en Rimouski que sincroniza sus reservas**

- Opción 1: consultar la API cada 5 minutos, 12 h al día : 144 consultas por día
- Nuevas reservas reales por día (hipótesis) : 18
- Consultas sin ninguna novedad (144 − 18) : 126
- Opción 2: webhook sobre el evento «reserva creada» : 18 avisos por día
- Retraso máximo para ver una reserva, opción 1 : hasta 5 minutos
- **= El webhook transmite solo los 18 eventos útiles, en el momento en que ocurren, en lugar de 144 verificaciones de las cuales 126 no encuentran nada.**

## ¿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](https://app.pilotiko.com/es/glosario/automatizacion-procesos) 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](https://app.pilotiko.com/es/glosario/aprobacion-humana), 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

1. GitHub Docs, « About webhooks », https://docs.github.com/en/webhooks/about-webhooks (consultado el 2026-10-15)
2. Stripe Docs, « Receive Stripe events in your webhook endpoint », https://docs.stripe.com/webhooks (consultado el 2026-10-15)
