Webhook

En pocas palabras

Una consulta normal por API es como llamar y preguntar: «¿hay novedades?». Un webhook es que te llamen en cuanto la novedad aparece. No hace falta comprobar cada minuto: el aviso llega en el momento del evento.

Cómo se ve en la práctica

El cliente paga una factura. El sistema de pagos envía enseguida un webhook: quién pagó, cuánto y por qué contrato. El sistema de gestión lo recibe y cambia el estado del trato, y el vendedor ve el pago en segundos, no al día siguiente.

Del mismo modo llegan los mensajes entrantes a un bot, las solicitudes nuevas del sitio o los cambios de estado de un envío. Ocurre el evento y sale el aviso.

Por qué importa a quien dirige

Los webhooks dan velocidad. Cuanto antes se entera el equipo de un evento, antes reacciona: responde en un minuto y no en una hora, y no manda un recordatorio a quien ya pagó.

Pero un webhook es un punto de fallo. Si la parte receptora no estaba disponible en ese momento, el aviso puede perderse. Algunos emisores reintentan y otros no. Por eso conviene conciliar de vez en cuando los eventos importantes: por ejemplo, comparar cada día la lista de pagos con lo que llegó al registro.

Error típico

No verificar de quién llega el webhook. La dirección de recepción es, en esencia, una puerta abierta. Si no se comprueba la firma o una clave secreta, cualquiera puede enviar un «pago recibido».

Otro riesgo es un webhook roto del que nadie se entera durante semanas, hasta que aparecen solicitudes perdidas.