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.

Try 30 days free

30 days free, no credit card.

Por Pilotiko editorial team · Actualizado el

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?

Ejemplos de eventos y de posibles reacciones
Evento en el software de origenDatos enviadosReacción posible
Pago con tarjeta aceptadoMonto, cliente, número de facturaMarcar la factura como pagada en la contabilidad
Reserva creada en el sitio webFecha, servicio, datos de contactoCrear la orden de trabajo del técnico
Formulario de cotización completadoNecesidad descrita, direcciónAvisar a la persona que prepara la cotización
Suscripción canceladaCliente, fecha de finalizaciónRetirar 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

  1. GitHub Docs, About webhooks (consultado el 15 de octubre de 2026).
  2. Stripe Docs, Receive Stripe events in your webhook endpoint (consultado el 15 de octubre de 2026).

Your whole business, on one screen.

Each department is a room. Pilotiko prepares the work; you approve with one click.

Try 30 days free

The Pilotiko office of a sample company: each department is a room.
  • Call answered
  • Appointment confirmed
  • Email reply ready
  • Invoice prepared

Pruebe la oficina con su equipo

30 días gratis.

Pruebe 30 días gratis