Webhook
Un webhook es un mecanismo de devolución de llamada HTTP donde un sistema envía una solicitud HTTP automatizada a una URL específica cada vez que ocurre un evento definido, lo que permite notificación e integración en tiempo real entre servicios sin sondeo.
Comprendiendo Webhook
Los webhooks a menudo se llaman 'APIs inversas'. En lugar de que tu aplicación pregunte periódicamente a un servicio '¿ha cambiado algo?' (sondeo), el servicio llama de forma proactiva a tu aplicación cuando ocurre un cambio. Este modelo orientado a eventos es más eficiente y más en tiempo real. Un webhook se configura proporcionando una URL al servicio del que deseas recibir eventos. Cuando ocurre el evento (llega un email nuevo, se completa un pago, se finaliza una tarea, se envía un formulario), el servicio envía una solicitud HTTP POST a tu URL con una carga útil que describe el evento. Tu servidor procesa esta carga y actúa en consecuencia. Los webhooks impulsan la mayoría de las integraciones modernas. Cuando se fusiona un PR en GitHub, GitHub envía un webhook a tu sistema de CI. Cuando se procesa un pago exitoso en Stripe, los webhooks de Stripe activan el cumplimiento del pedido. Cuando se agenda una cita en Calendly, los webhooks de Calendly pueden actualizar el CRM. La fiabilidad de los webhooks requiere manejar situaciones de error: reintentos cuando el servidor de recepción está inactivo, verificación de firmas para confirmar que el webhook es auténtico, idempotencia para tratar entregas duplicadas y procesamiento basado en colas para manejar altos volúmenes de eventos.
Cómo GAIA usa Webhook
GAIA utiliza webhooks para recibir eventos en tiempo real desde herramientas conectadas. Cuando llega un nuevo correo en Gmail, se actualiza una tarea en Linear o se reserva un evento en Calendly, los webhooks notifican a GAIA de inmediato para que pueda actuar — creando una tarea, enviando una notificación o desencadenando un flujo de trabajo — sin la latencia ni el costo de hacer comprobaciones periódicas.
Conceptos relacionados
Integración de API
La integración de API es el proceso de conectar distintas aplicaciones de software a través de sus Interfaces de Programación de Aplicaciones, permitiendo que compartan datos y funcionalidades de manera fluida.
Automatización basada en eventos
La automatización basada en eventos es un patrón en el que los flujos de trabajo se desencadenan automáticamente en respuesta a eventos específicos, como la llegada de un nuevo correo electrónico, la creación de un evento de calendario o la publicación de un mensaje, permitiendo un procesamiento reactivo en tiempo real.
Automatización de flujos de trabajo
La automatización de flujos de trabajo es el uso de tecnología para ejecutar automáticamente procesos y tareas empresariales repetitivas, reduciendo el esfuerzo manual y los errores humanos.
Automatización disparador-acción
La automatización disparador-acción es un patrón en el que un evento definido (el disparador) inicia automáticamente una o más acciones posteriores, permitiendo flujos de trabajo orientados a eventos que funcionan sin intervención humana.
API REST
Una API REST (Transferencia de Estado Representacional) es una interfaz de servicio web que utiliza métodos HTTP estándar (GET, POST, PUT, DELETE, PATCH) para acceder y manipular recursos identificados por URLs, siguiendo un conjunto de convenciones arquitectónicas que hacen que las APIs sean predecibles e interoperables.
