Si manejas procesos que tardan minutos u horas —por ejemplo investigación profunda, generación de videos largos o miles de prompts en lote— seguro conoces la molestia de tener que hacer polling continuo para saber cuándo termina una tarea. Google anuncia una solución que cambia ese flujo: Webhooks orientados a eventos en la Gemini API.
Qué cambia con los Webhooks de Gemini API
En vez de preguntar repetidamente "¿ya terminó?", la Gemini API ahora puede empujar un HTTP POST a tu servidor justo cuando una tarea finaliza. Eso significa menos fricción, menos llamadas inútiles y una latencia perceptible menor para que tu aplicación reaccione en tiempo real.
¿Para qué sirve en la práctica? Imagina un pipeline que procesa miles de prompts o genera videos largos: ya no necesitas mantener sockets abiertos o ejecutar cron jobs para verificar estados. El resultado llega a tu endpoint y puedes continuar con el siguiente paso inmediatamente.
Cómo funciona (resumen práctico)
- Configuración global por proyecto: defines un webhook asegurado vía HMAC para recibir todos los eventos relevantes.
- Sobrescritura por solicitud: puedes indicar un webhook distinto por cada job, útil para enrutamiento dinámico o multi-tenant, asegurado con JWKS.
- Entrega garantizada: la plataforma ofrece entrega al menos una vez y reintentos automáticos por hasta 24 horas.
Seguridad y fiabilidad
No es solo un POST sin control. Cada petición incluye cabeceras firmadas para ayudarte a verificar origen y evitar replays: webhook-signature, webhook-id y webhook-timestamp.
Las peticiones están firmadas y la entrega es repetida hasta 24 horas, lo que mejora tanto la seguridad como la resiliencia frente a fallos transitorios.
Ese diseño sigue la especificación estándar de Webhooks, así que puedes aplicarlo con buenas prácticas comunes: validar firmas, implementar idempotencia en tu receptor y manejar entregas duplicadas.
Casos de uso concretos
- Deep Research: recibir resultados parciales o finales cuando un proceso de análisis intensivo termina.
- Generación de video largo: procesamientos que toman mucho tiempo ahora notifican automáticamente al servicio que orquesta la conversión o la entrega.
- Batch API: envías miles de prompts y cada lote te notifica al terminar, evitando comprobaciones constantes.
Cómo empezar hoy
- Lee la guía oficial para ver todo el catálogo de eventos y ejemplos de seguridad.
- Prueba el Cookbook con una integración end-to-end: trae tu endpoint, valida la firma y procesa el payload.
Si usas el SDK de Python puedes configurar webhooks por petición en segundos; si prefieres control centralizado, la opción por proyecto con HMAC mantiene todo ordenado y seguro.
Esta actualización no es solo una mejora técnica: cambia cómo diseñas flujos largos y distribuidos. Menos polling significa menos costos, menos complejidad y respuestas más rápidas para usuarios y servicios.
Fuente original
https://blog.google/innovation-and-ai/technology/developers-tools/event-driven-webhooks