Webhook
Un webhook es una URL HTTP que un sistema A llama automáticamente cuando ocurre un evento, para que un sistema B lo procese al instante sin tener que consultar repetidamente.
Un webhook (también llamado callback HTTP o push notification API) es el mecanismo estándar para que dos sistemas se comuniquen en tiempo real. En vez de que tu sistema le pregunte cada minuto "¿pasó algo nuevo?" (técnica llamada polling, costosa y lenta), el otro sistema te avisa cuando pasa: hace un POST a una URL que tú configuraste y te entrega el dato.
Ejemplo concreto en WhatsApp
Cuando un cliente te escribe a tu número Cloud API:
- Meta recibe el mensaje en sus servidores
- Meta hace POST a la URL webhook que tu Tech Provider registró (por ejemplo
https://app.kharyo.com/webhooks/whatsapp/123) - El payload del POST incluye el texto, el número del cliente, la timestamp y el message_id
- Tu plataforma procesa el evento y dispara el agente IA, o asigna a un humano, o lanza un workflow
Todo esto ocurre en milisegundos, sin polling, sin esperas.
Webhooks comunes en automatización
- WhatsApp / Instagram / Telegram: mensaje entrante
- Stripe / Mercado Pago: pago recibido, suscripción cancelada
- Bancos con notificación oficial: transferencia entrante (en Venezuela vía SMS interpretado, en otros mercados vía API)
- Google Calendar: evento creado, modificado o cancelado
- Shopify / WooCommerce: orden creada, abandono de carrito
Por qué importa la firma del webhook
Una URL pública puede recibir requests de cualquiera. Para confirmar que el POST realmente viene del proveedor (no de un atacante), los proveedores serios firman el payload con HMAC SHA-256 y un secreto compartido. Tu plataforma verifica la firma antes de procesar. Sin verificación, alguien podría inyectar pagos falsos o mensajes fantasma.
Webhook vs API REST
No son opuestos: se complementan. La API REST la usas para hacer requests salientes (enviar un mensaje, crear una cita). El webhook lo recibes para enterarte de cosas que pasan del otro lado sin tener que preguntar. Toda integración seria usa ambos.
En Kharyo, los webhooks de WhatsApp, Instagram, Stripe y bancos están preconfigurados y firmados. No tienes que escribir el handler ni gestionar la firma: el sistema dispara el workflow correspondiente apenas el evento llega.
