Los eventos suscritos reducen el sondeo, pero requieren una respuesta rápida, deduplicación y puesta en cola. Vea cómo operar automatizaciones de IA de manera confiable.
respuesta directa
Los webhooks de OpenAI envían POST a un punto final controlado por la empresa cuando ocurren eventos seleccionados. El receptor debe verificar la firma con el secreto proporcionado, responder rápidamente con el estado 2xx y mover el procesamiento relevante a una cola. Las entregas no confirmadas pueden repetirse hasta 72 horas con un retraso exponencial, por lo que cada consumidor debe ser idempotente y tolerar eventos duplicados.
La firma autentifica el origen
Verifique el cuerpo sin formato con el secreto en el servidor antes de aceptar el evento; El secreto expuesto debe rotarse.
La respuesta rápida separa la recepción del procesamiento
Confirme el recibo y haga cola para el trabajo pesado. Ejecutar todo antes de 2xx aumenta el tiempo de espera y la repetición.
La duplicación es un comportamiento esperado.
Los reintentos protegen contra fallas transitorias. Almacene el identificador del evento y haga que cada efecto sea idempotente.
La observabilidad cierra el círculo
Registre la recepción, verificación, deduplicación, procesamiento, resultado y eventual cola muerta sin exponer datos confidenciales.
Lectura del nexo
Utilice el webhook como una entrada confiable para un flujo de trabajo, no como una ejecución directa de acciones irreversibles sin validación ni autorización.
Preguntas frecuentes
¿Es obligatorio verificar la firma?
Sí, para confirmar que el POST fue emitido por OpenAI y no por un tercero.
¿Por qué responder 2xx rápidamente?
Para confirmar la recepción antes del tiempo de espera y evitar reintentos innecesarios.
¿Puede llegar el mismo evento más de una vez?
Sí. El consumidor debe deduplicar y ejecutar efectos de forma idempotente.
Guías imprescindibles para profundizar en la decisión
Este análisis editorial fue elaborado por Nexus a partir de las fuentes oficiales a continuación, consultadas el 31 de octubre de 2026. El texto es original e interpreta implicaciones prácticas para las empresas.
- Desarrolladores de OpenAI: webhooks: configuración, firma, respuesta 2xx, reintentos y rotación de secretos.
- Webhooks estándar: especificación: formato de firma interoperable al que hace referencia la documentación oficial.
Fecha reportada por fuente principal: documentación oficial consultada el 31 de octubre de 2026; análisis técnico.