¿Qué es un webhook?

Un webhook es un aviso automático que un sistema envía a otro en cuanto ocurre algo: una llamada que termina, un pago confirmado o una cita creada. En lugar de preguntar cada poco, recibes el evento en el momento en que pasa.

Es una de las piezas que hace que tus herramientas dejen de trabajar aisladas. Cuando un agente de voz cierra una llamada, un webhook puede avisar al CRM, a la agenda o a la persona de guardia sin que nadie esté pendiente.

Webhook frente a API

Una API funciona cuando tú preguntas: «¿hay citas nuevas?». Un webhook funciona al revés: el otro sistema te avisa en cuanto hay una. Es la diferencia entre llamar cada hora para comprobar y que te llamen solo cuando hay novedad.

Por eso se dice que la API es «pull» y el webhook es «push». Para eventos que pasan en cualquier momento, esperar el aviso es más rápido y más barato que sondear sin parar.

Cómo encaja en un agente de voz

Una llamada genera eventos: ha empezado, ha terminado, la transcripción está lista, se ha creado una cita, se ha derivado a una persona. Cada uno puede disparar un webhook hacia el sistema que tenga que enterarse.

Así, cuando el agente registra una avería, el aviso entra en el sistema de partes; cuando agenda una visita, aparece en el calendario del técnico. La llamada deja de ser una nota suelta y se convierte en acción.

Por qué importa para integrar

Sin webhooks, integrar la IA con tu CRM obliga a estar consultando constantemente o a sincronizar a mano. Con webhooks, el dato fluye solo en el momento justo y llega fresco a cada sistema.

Eso reduce el desfase entre lo que pasó en la llamada y lo que ve tu equipo, que es donde se pierden seguimientos y se enfrían oportunidades.

Fiabilidad: reintentos e idempotencia

Un webhook puede llegar dos veces o no llegar a la primera. Por eso el sistema que lo recibe debe ser idempotente: procesar el mismo evento dos veces no debe crear dos citas ni cobrar dos veces.

También conviene aceptar reintentos y responder rápido. Si el receptor tarda o falla, el emisor suele reintentar; sin control de duplicados, esos reintentos hacen daño.

Seguridad y observabilidad

Un webhook es una puerta abierta hacia tus sistemas, así que hay que verificar que el aviso viene de quien dice. Lo normal es validar una firma y aceptar solo orígenes conocidos antes de actuar sobre el evento.

Y conviene registrar cada entrega. Esa observabilidad permite saber qué eventos llegaron, cuáles fallaron y por qué, en lugar de descubrir el problema cuando un cliente se queja.

Por qué importa para el negocio

Los webhooks son lo que mantiene tus sistemas hablando entre sí en tiempo real. Bien montados, evitan trabajo manual y desfases; mal montados, duplican acciones o pierden eventos en silencio.

Como con cualquier herramienta del agente, conviene tratarlos con un contrato claro: qué evento es, qué datos trae y qué pasa si falla.

También te puede interesar:

¿Qué es una API?

Integrar IA con tu CRM

Contratos de herramientas en agentes de voz

Observabilidad en IA