Automatización
¿Qué es un webhook? Para qué sirve y en qué se diferencia de una API
Publicado el 6 min de lecturaLienzo Studio
Un webhook es un aviso automático que un programa envía a otro en el momento en que ocurre algo concreto, como un pago recibido, un formulario enviado o un pedido nuevo. Con ese aviso viajan los datos del suceso, para que el segundo programa pueda actuar al instante sin que nadie copie nada. Es una de las piezas más sencillas y útiles para conectar las herramientas de una empresa.
En pocas palabras: con una API, tu programa pregunta; con un webhook, el otro programa te avisa. Sirve para que un hecho en una herramienta ponga en marcha una acción en otra sin esperas. Solo funciona si el programa de origen lo ofrece, y conviene prever qué ocurre cuando un aviso falla.
El nombre suena muy técnico, pero la idea es cotidiana. Imagina que esperas un paquete. Puedes llamar a la empresa de reparto cada hora para preguntar si ha salido, o puedes pedirle que te mande un mensaje cuando salga. Lo primero es consultar; lo segundo es un webhook.
¿Cómo funciona un webhook?
El funcionamiento se resume en cuatro pasos:
- Se elige el suceso. En el programa de origen se indica qué interesa: por ejemplo, «factura pagada» o «formulario recibido».
- Se indica la dirección de destino. Se configura una dirección web del programa que recibirá el aviso.
- Ocurre el suceso. El programa de origen envía automáticamente a esa dirección un mensaje con los datos, como el cliente, el importe o la fecha.
- El destino actúa. El programa que recibe el aviso hace lo acordado: registrar el cobro, crear una tarea o avisar a una persona.
Todo sucede sin que nadie intervenga y, normalmente, en cuestión de segundos.
¿En qué se diferencia de una API?
Se confunden a menudo porque los dos sirven para que los programas se comuniquen. La diferencia está en quién da el primer paso:
| Criterio | API | Webhook |
|---|---|---|
| Quién toma la iniciativa | El programa que necesita el dato | El programa donde ocurre el suceso |
| Cuándo se comunican | Cuando alguien lo pide | Cuando sucede algo |
| Idea principal | «Dime cómo está esto» | «Te aviso de que ha pasado esto» |
| Para qué sirve más | Consultar, crear o modificar datos | Reaccionar a un suceso en el momento |
| Riesgo habitual | Preguntar demasiado o llegar tarde | Perder un aviso si nadie lo vigila |
No se trata de elegir uno u otro. Lo habitual es combinarlos: el webhook avisa de que ha llegado un pedido y después, mediante la API, se consultan los detalles o se registra el resultado. Si esta parte te suena lejana, antes conviene leer qué es una API, que explica la base.
¿Para qué sirve un webhook en una pyme?
Sirve para que un hecho en una herramienta ponga en marcha el siguiente paso en otra. Algunos ejemplos habituales:
| Lo que ocurre | Quién avisa | Lo que pasa después |
|---|---|---|
| Un cliente paga por internet | La pasarela de pago | Se marca la factura como cobrada y se avisa a administración |
| Llega un formulario de contacto | La web | Se crea el contacto en el CRM y una tarea para el equipo comercial |
| Entra un pedido en la tienda online | La tienda | Se crea el pedido en el programa de gestión y se avisa al almacén |
| Un cliente firma un documento | La herramienta de firma | Se guarda el documento y se abre el siguiente paso del expediente |
| Se cancela una cita | La agenda online | Se libera el hueco y se avisa a quien corresponda |
La mayoría de estos casos encajan en las tareas repetitivas que puedes automatizar: trabajo que no aporta nada por sí mismo y que consiste en trasladar un dato de un sitio a otro.
¿Cuándo conviene usar un webhook?
Un webhook encaja bien cuando se cumplen estas condiciones:
- El suceso es claro y se puede detectar, como un pago o un cambio de estado.
- La reacción debe ser rápida: no sirve esperar a que alguien lo revise al final del día.
- Los sucesos no siguen un horario fijo, por lo que preguntar cada poco tiempo sería un desperdicio.
- El programa de origen lo ofrece, algo que debes confirmar en su documentación o con su soporte.
No es la mejor opción si lo que necesitas es un informe periódico o sincronizar muchos datos de golpe. En esos casos suele ser más simple una consulta programada a la API o una exportación diaria.
¿Qué puede salir mal?
Un webhook mal planteado da la falsa sensación de que todo funciona solo. Conviene tener en cuenta estos riesgos:
- Avisos perdidos. Si el destino está caído en ese momento, algunos programas reintentan y otros no. Hay que saber qué hace el tuyo.
- Avisos repetidos. Un mismo aviso puede llegar dos veces y, sin control, generar un pedido o una factura duplicados.
- Orden alterado. Dos avisos seguidos pueden llegar en distinto orden del que se produjeron.
- Avisos falsos. Sin comprobar quién lo envía, alguien que conociera la dirección podría colarlos.
- Cambios del proveedor. Si el programa de origen modifica el formato de los datos, la conexión puede dejar de funcionar.
- Errores silenciosos. Lo peor no es que falle, sino que falle sin que nadie se entere.
Cómo reducir estos riesgos
- Comprueba el origen de cada aviso, normalmente con una firma o una clave compartida, y usa siempre direcciones HTTPS.
- Guarda un registro de lo que llega, para poder revisarlo y reprocesarlo.
- Ignora los duplicados, identificando cada suceso para no tratarlo dos veces.
- Avisa de los errores a una persona responsable en lugar de dejarlos en un archivo que nadie mira.
- Revisa de vez en cuando que los datos cuadran, comparando origen y destino.
- Envía solo los datos necesarios, sobre todo si incluyen datos personales. Si tienes dudas sobre protección de datos, consulta a tu asesor.
¿Cómo empezar a usar webhooks en tu empresa?
No hace falta plantear un gran proyecto. Lo más sensato es empezar por un único caso:
- Busca un dato que hoy se copie a mano entre dos herramientas, como los cobros o los formularios de la web.
- Identifica el suceso que debería ponerlo en marcha y qué tendría que ocurrir a continuación.
- Comprueba si el programa de origen ofrece webhooks. Búscalo en su documentación o pregunta a su soporte.
- Decide cómo montarlo: con una herramienta de automatización sin código si el caso es sencillo, o con desarrollo propio si es crítico o requiere reglas complejas.
- Prueba con casos reales, incluidos los errores, antes de dejarlo funcionando solo.
Cada webhook suele ser un eslabón de un proceso mayor, así que ayuda tener claro el recorrido completo. Para eso sirve entender qué es un flujo de trabajo y documentar los procesos de la empresa. Si quieres verlo con más perspectiva, cómo automatizar procesos en una empresa ordena los pasos.
En resumen
Un webhook es un aviso automático entre programas que permite reaccionar a un suceso en el momento. Para usarlo con cabeza:
- Recuerda la diferencia: la API pregunta, el webhook avisa.
- Empieza por un dato que hoy se copie a mano.
- Confirma que el programa de origen lo ofrece.
- Prevé los avisos perdidos, repetidos y falsos.
- Asegúrate de que alguien se entere cuando algo falle.
Si tienes varias herramientas que no se hablan entre sí y alguien hace de puente a mano, cuéntanos cuáles son y vemos cómo conectarlas.
Preguntas frecuentes
¿Qué es un webhook en palabras sencillas?
Es un aviso automático que un programa envía a otro cuando ocurre algo concreto, como un pago recibido o un formulario enviado. En lugar de que un programa pregunte una y otra vez si hay novedades, el otro le avisa en el momento y le pasa los datos del suceso, para que pueda actuar sin intervención de nadie.
¿Cuál es la diferencia entre un webhook y una API?
Con una API, tu programa pregunta o pide algo cuando lo necesita, y el otro responde. Con un webhook, el otro programa toma la iniciativa y avisa cuando sucede algo. Se complementan: es habitual recibir un aviso por webhook y después usar la API para consultar más detalles o registrar el resultado.
¿Necesito saber programar para usar webhooks?
No siempre. Muchas herramientas de automatización sin código permiten recibir webhooks y encadenar acciones con unos pocos pasos de configuración. Si el proceso es importante, maneja datos delicados o debe conectarse con programas antiguos, suele compensar que lo prepare alguien técnico, sobre todo para controlar los errores y la seguridad.
¿Son seguros los webhooks?
Pueden serlo si se configuran bien. Conviene usar direcciones cifradas con HTTPS, comprobar que cada aviso viene realmente del programa esperado, normalmente mediante una firma o una clave compartida, y enviar solo los datos imprescindibles. Sin estas comprobaciones, cualquiera que conociera la dirección podría enviar avisos falsos.
¿Qué pasa si un webhook falla?
Depende del programa que lo envía. Algunos reintentan el envío durante un tiempo y otros no. Si no se ha previsto, el aviso puede perderse sin que nadie lo note y un pedido o un cobro quedan sin procesar. Por eso conviene registrar los avisos recibidos, alertar de los errores y revisar de vez en cuando que los datos cuadran.