Webhook: cómo un sistema te avisa en el momento en que algo ocurre

Qué es

Un webhook es un aviso automático que un sistema envía a otro en cuanto ocurre un evento. Tú registras una dirección web en el sistema donde pasan las cosas —una pasarela de cobro, un proveedor de timbrado— y ese sistema manda ahí un mensaje con los datos del hecho, en el momento en que sucede.

La diferencia con una API está en quién toma la iniciativa: con una API tú preguntas; con un webhook te avisan sin que preguntes. Es la misma tubería recorrida en sentido contrario.

En palabras de contador

Piénsalo con la conciliación bancaria. Hoy la armas por rondas: bajas el estado de cuenta, cruzas movimientos y hasta entonces te enteras. Un webhook invierte ese ritmo: el hecho entra a tu registro en el instante en que ocurre, y el trabajo se organiza por hechos y no por horarios.

Ese aviso no viene de cualquier lado: lo emiten las pasarelas de cobro, los proveedores de timbrado y los servicios de firma electrónica, no la banca. Empieza por las que ya avisan solas.

Ejemplo aplicado

Cobro de una suscripción. La pasarela avisa en cuanto un pago se aplica o una suscripción se cancela. El acceso del cliente se activa o se suspende sin que nadie abra el tablero.

Timbrado de nómina. El proveedor avisa cuando el comprobante queda timbrado o cuando el envío se detiene. Tu control de nómina actualiza el estatus del recibo y registra la hora exacta.

Firma de un contrato. El servicio de firma electrónica avisa en cuanto concluye el último firmante: el expediente se marca como completo y sale el correo con la copia ejecutada.

Para qué sirve en un despacho

• Enterarte de un cobro, una cancelación o un cambio de plan en cuanto ocurre.
• Actualizar el estatus de un trámite sin que alguien revise el portal del proveedor.
• Encadenar tareas: un evento crea el expediente, agenda el recordatorio y avisa al responsable.
• Alimentar a un agente de IA con hechos recién ocurridos y no con información de ayer.

Riesgos o limitaciones

El aviso llega desde afuera, a una dirección accesible por internet: quien la descubra puede enviar un mensaje que aparente venir del proveedor. Por eso los proveedores serios firman cada envío y tu sistema tiene que verificar esa firma antes de hacerle caso. Si no cuadra, descarta el mensaje y deja constancia.

Además, los avisos se repiten y a veces llegan desordenados. Un mismo evento puede entrar dos veces y, si tu sistema no lo reconoce, duplicas el registro o suspendes un servicio ya reactivado. Y si tu servidor está caído en ese instante, todo depende de la política de reintentos del proveedor.

Buena práctica

Antes de conectar el primer webhook resuelve tres cosas: verifica la firma y descarta lo que no la traiga, guarda cada aviso con su identificador y su hora, y trata ese identificador como llave única para que un mensaje repetido no genere dos movimientos.

Filtra en positivo: procesa solo los eventos que reconoces como propios y deja pasar el resto sin actuar. Resulta más seguro ignorar de más que actuar sobre un aviso ajeno.

Preguntas frecuentes

¿Necesito un servidor para recibirlos? Sí. Hace falta una dirección accesible desde internet; un sitio estático no basta, se requiere un backend aunque sea pequeño.

¿Cómo lo pruebo antes de ponerlo en producción? Usa el ambiente de pruebas del proveedor y su botón de reenvío: dispara cada tipo de aviso, incluido uno repetido, y confirma que el resultado sea el mismo.

¿Qué pasa si mi sistema está caído cuando llega el aviso? La mayoría de los proveedores reintenta durante un periodo y conserva el historial en su tablero. Revisa esa política y ten forma de reprocesar lo pendiente.

Escrito y revisado por Ernesto Sobrino, contador.
Última revisión: 24 de agosto de 2026.