Webhook: el aviso automático entre dos programas
Un webhook es un aviso que un programa envía a otro en el momento en que ocurre algo, sin que nadie tenga que preguntar. Es la pieza que hace que un pago, un pedido o una firma aparezcan solos en su sistema.
1Qué es, sin tecnicismos
Piense en la diferencia entre llamar cada media hora a la agencia de transporte para saber si ha llegado el envío y que la agencia le mande un mensaje cuando llega. Lo segundo es un webhook: el sistema donde pasa el hecho avisa al sistema que lo necesita, en cuanto pasa.
Técnicamente, el aviso es una pequeña petición por internet a una dirección que su sistema deja preparada. Lleva los datos del suceso (qué pedido, qué importe, qué cliente) y su sistema los recibe y actúa: marca la factura como cobrada, crea el pedido o avisa a una persona.
2Dos ejemplos de una pyme
Los casos más habituales en una empresa pequeña:
- Pago confirmado: un cliente paga con tarjeta en su web o por un enlace de pago. La pasarela avisa a su sistema, que da el pedido por pagado y lo pasa a preparación sin que nadie mire el extracto.
- Pedido de la tienda online: entra un pedido en la tienda y la tienda avisa al programa de almacén, que reserva el stock y genera el albarán de salida.
- Otros: un documento firmado, una cita reservada, un formulario enviado, un envío entregado.
3Webhook o consultar cada pocos minutos
La alternativa a un webhook es que su sistema pregunte al otro cada cierto tiempo si hay novedades. Funciona, y a veces es la única opción, porque no todos los programas saben avisar. Tiene dos pegas: el dato llega con retraso (hasta el siguiente turno de consulta) y se hacen muchas consultas para nada.
El webhook es más inmediato y más ligero, pero depende de que el otro programa lo ofrezca. Por eso, antes de prometer que algo será «automático», conviene comprobar en la documentación del otro programa qué avisos envía. En nuestra página sobre qué es una API explicamos la pieza de la que cuelgan ambos métodos.
4Qué pasa si el aviso falla
Es la pregunta que más importa y la que menos se hace. Un aviso puede perderse: su servidor estaba en mantenimiento, hubo un corte o el aviso llegó con un formato inesperado. Los servicios serios reintentan el envío varias veces durante un tiempo, pero no para siempre.
Un sistema bien hecho, por eso, hace tres cosas: comprueba que el aviso viene de quien dice venir, no procesa dos veces el mismo aviso si llega repetido (para no cobrar ni servir dos veces) y, cada cierto tiempo, cuadra lo recibido con el otro sistema para encontrar lo que se haya perdido. Lo que no cuadra se enseña a una persona.
- ¿Qué avisos ofrece el programa con el que queremos conectar?
- ¿Cuántas veces reintenta y durante cuánto tiempo?
- ¿Cómo nos enteramos si un aviso se pierde del todo?
5Dónde lo hemos necesitado

Kiero
Un empleado de IA en el WhatsApp del negocio
Kiero cobra dentro del chat de WhatsApp con Stripe Connect, conectado a la cuenta del negocio. Es el tipo de integración en la que saber con certeza que un pago se ha confirmado decide qué pasa después. Publicado en kiero.es.
Publicado en kiero.es
6Preguntas frecuentes
¿Un webhook y una API son lo mismo?
No. La API es la puerta por la que un programa deja que otro le pida o le envíe datos. El webhook es un uso concreto: el programa le llama a usted cuando pasa algo, en lugar de esperar a que usted pregunte.
¿Mi programa de gestión admite webhooks?
Depende del programa y, a veces, del plan contratado. Algunos avisan de todo, otros de casi nada. Lo comprobamos en su documentación antes de proponer una conexión.
¿Se puede cobrar dos veces por un aviso repetido?
Si el sistema no está preparado, puede pasar. Por eso cada aviso se identifica y, si llega dos veces, la segunda se ignora.
¿Qué ocurre si mi servidor está caído cuando llega el aviso?
Normalmente el emisor lo reintenta durante un tiempo. Si aun así se pierde, la comprobación periódica contra el otro sistema lo detecta y lo deja a la vista de una persona.
¿Qué dato copia hoy a mano de un programa a otro?
Díganos qué programas usa y le diremos si pueden avisarse solos o si hay que consultarlos cada cierto tiempo.
Cuéntenos su problema