Saltar al contenido
PHP 8.2 pierde soporte de seguridad el 31 de diciembre.Revise la exposición de su sitio →

¿Qué es un webhook?

¿Qué es un webhook?

Un webhook es un mecanismo basado en HTTP que permite a un sistema avisar automáticamente a otro cuando ocurre un evento específico, enviando los datos en tiempo real en lugar de esperar a que el sistema receptor los pida.

¿Qué es un webhook?

Un webhook es una notificación push entre sistemas de software. Cuando ocurre un evento en un sistema (se cierra un negocio en el CRM, se aprueba un pago en la plataforma de facturación, se registra un usuario nuevo), ese sistema envía una solicitud HTTP POST con los datos del evento a una URL que usted registró. Su sistema recibe los datos y los procesa de inmediato.

A los webhooks a veces se les llama "API inversas", porque los datos fluyen del sistema de origen hacia el suyo, en lugar de que su sistema se los pida al origen.

Cómo funcionan los webhooks

1. Usted registra la URL de un endpoint de webhook en el sistema de origen (por ejemplo, HubSpot o Stripe)

2. Define qué eventos deben disparar el webhook (por ejemplo, "cambió la etapa del negocio" o "pago aprobado")

3. Cuando ocurre el evento, el sistema de origen envía una solicitud HTTP POST a su URL con los datos del evento en JSON en el cuerpo de la solicitud

4. Su sistema recibe la solicitud y procesa el evento

5. Su sistema devuelve una respuesta HTTP 200 para confirmar la recepción

El detalle crítico: su endpoint debe devolver un 200 rápido (en 3 a 5 segundos). Si se agota el tiempo o devuelve un error, el sistema de origen normalmente reintenta y envía el mismo webhook varias veces. Su lógica de procesamiento debe manejar bien las entregas duplicadas (idempotencia).

Por qué los webhooks importan en la integración empresarial

Los webhooks habilitan la integración orientada a eventos: sus sistemas reaccionan a los eventos cuando ocurren, en lugar de descubrirlos después mediante consultas periódicas.

Sin webhooks, la alternativa común es el polling: su sistema le pregunta al sistema de origen "¿cambió algo?" según un horario (cada minuto, cada 5 minutos, cada hora). El polling desperdicia recursos (la mayoría de las consultas no devuelven nada), es lento (los eventos se descubren en el siguiente ciclo, no cuando ocurren) y agota los límites de uso de la API.

Con webhooks, cuando se cierra un negocio en HubSpot, su sistema de aprovisionamiento recibe el aviso en segundos y puede iniciar el flujo de inmediato. Sin polling, sin demoras, sin llamadas desperdiciadas a la API.

Webhooks en DBUGGER

DBUGGER construye integraciones basadas en webhooks para clientes empresariales, como webhooks de eventos de negocios en HubSpot que disparan flujos posteriores de aprovisionamiento, facturación y onboarding. Nuestras implementaciones incluyen verificación de firmas, manejo de idempotencia, colas de mensajes fallidos (dead-letter) y monitoreo de entregas.

Términos relacionados: API REST · WebSocket · Arquitectura orientada a eventos · API Gateway · Idempotencia

Empecemos

¿Listo para escalar sus operaciones de tecnología?

Respuesta a su cotización en 24 horas. Propuesta detallada en 48.