Recibir un aviso no significa completar el trabajo
Un webhook avisa cuando el proveedor envía un evento; el sondeo pregunta por cambios en intervalos definidos. Elegir exige revisar eventos, acceso, recuperación y límites de la API concreta, no prometer tiempo real universal. Think² organiza colaboradores con grupos, contexto, la posibilidad de un computador propio por colaborador, modelos compatibles y herramientas autorizadas; esta guía no acredita que implemente endpoints GitHub o Stripe ni una integración probada.
Lista de espera: no garantiza acceso inmediato ni un plan gratuito.
Situaciones para revisar
Existe el evento que necesitas y puedes recibirlo de forma segura
Evalúa webhooks con verificación de origen, recepción conforme al proveedor y procesamiento separado. GitHub documenta respuesta 2XX dentro de 10 segundos; ese es un requisito de recepción GitHub, no tiempo de finalización de todo el trabajo ni SLA de Think².
Puedes distinguir aviso recibido de decisión preparada, acción aprobada y ejecución comprobada. Un 2XX no acredita el resultado de negocio.
No existe el evento adecuado o necesitas comprobar el estado actual
Evalúa consultas periódicas al recurso pertinente. Antes de fijar intervalos, confirma permisos, cuota, paginación, cursores, filtros, historial disponible y recuperación cuando se interrumpe la consulta.
La elección responde a la documentación del endpoint, no a una frecuencia o coste inventados. Una lectura del estado actual puede omitir transiciones intermedias; no demuestra todo el historial.
Llegan avisos repetidos o fuera de orden
Define identidad y ámbito del evento, estados de procesamiento, recuperación y reconciliación con la fuente. Stripe documenta entregas duplicadas y ausencia de orden garantizado; esas condiciones no se extrapolan a todos los proveedores.
No se vuelve a ejecutar una acción por repetir un aviso ni se elige el estado actual por el último mensaje recibido. Guardar un ID por sí solo no demuestra protección atómica frente a concurrencia.
Lista de espera: no garantiza acceso inmediato ni un plan gratuito.
Cómo evaluar el trabajo
- Delimita objeto, evento, resultado buscado y documentación del proveedor. Distingue información del evento de estado actual. No actives eventos extra sin necesidad ni concedas permisos por disponer de un computador o un endpoint.
- Elige recepción de eventos, sondeo o combinación según disponibilidad y recuperación comprobables. Para sondeo, documenta paginación y cursor, cuándo avanza, filtros y periodo de recuperación; no afirmar una cuota, ventana o intervalo sin la API concreta. En esta guía no se midieron costes, carga ni latencia.
- Verifica el origen conforme al proveedor y protege secretos fuera de URLs y registros. En GitHub se documenta respuesta 2XX en 10 segundos; Stripe recomienda respuesta exitosa rápida antes de lógica compleja. Esto no prescribe aceptar una firma inválida ni garantiza persistencia del trabajo. El acuse debe corresponder al mecanismo de recepción implementado y comprobado, separado del resultado posterior. Si usas una cola, comprueba la persistencia fiable antes de acusar recepción: responder 2XX y perder después el evento no demuestra una recepción recuperable. No se prescribe una implementación universal ni se afirma que Think² ya la tenga.
- Plantilla reutilizable: proveedor/versión; objeto/evento; ámbito/ID; verificación de origen; recepción/evidencia; estado de procesamiento; política de duplicados y concurrencia; cursor/recuperación; fuente actual/corte; propuesta; aprobación externa; ejecución/evidencia. Ejemplo ficticio no ejecutado: llega evento EV7 del objeto S1 dos veces y después EV6 del mismo objeto. No usar orden de llegada como versión vigente. Conservar referencias, comprobar estado en la fuente autorizada y preparar una decisión revisable; si el estado de EV7 es desconocido, no tratar “ID visto” como "trabajo completado" ni repetir una acción a ciegas. Toda acción externa requiere aprobación previa específica, aunque el disparador sea automático. No hubo webhook configurado, sondeo ejecutado, envío ni integración Think² probados; no se demostró exactamente una ejecución. Ejemplo de decisión adicional, ficticio y no ejecutado: un proveedor documenta un evento para ‘pedido actualizado’, pero no entrega historial completo; la tarea necesita preparar un resumen del estado actual, no reconstruir todas sus transiciones. Si el endpoint autorizado permite comprobar ese estado, evalúa evento como aviso y consulta como reconciliación. Si no existe el evento y hay un recurso consultable, evalúa sondeo con sus límites y recuperación; no fijes una frecuencia sin esa documentación. Si necesitas historial completo y ninguna fuente lo ofrece, este diseño no satisface el requisito: conserva el vacío. Registro propuesto de EV7/S1: recibido → persistencia por comprobar → resultado desconocido. El duplicado de EV7 no autoriza otra acción ni demuestra éxito; EV6 tardío no sustituye la versión vigente por llegar después. Una fila de control debe identificar evidencia de recepción, estado de procesamiento y fuente actual por separado. No es un webhook, cola, deduplicación o consulta implementados por Think².
Preguntas frecuentes
¿Webhook significa que todo termina en tiempo real?
No. La recepción HTTP y la ejecución posterior son estados distintos. Los requisitos citados pertenecen a cada proveedor; no constituyen una latencia universal ni una promesa de rendimiento de Think².
¿Todos los proveedores reenvían avisos fallidos?
No lo asumas. Stripe documenta intentos hasta tres días en modo live y tres reintentos en sandbox durante unas horas. Verifica la política vigente y el tipo de destino antes de diseñar recuperación; no aplicarla automáticamente a GitHub u otros servicios.
¿Con webhooks ya no necesito consultar la API?
Puede seguir siendo necesario para confirmar estado o recuperar información ausente. Hay que verificar alcance, límites, paginación e historial del endpoint. Leer el estado actual tampoco reconstruye todas sus transiciones.
Fuentes y alcance
- GitHub — Best practices for webhooks — Respuesta 2XX en 10 segundos, verificación, secreto e ID de entrega; no SLA de Think².
- GitHub — Handling webhook deliveries — Tratamiento de entregas GitHub; no política universal de otros proveedores.
- Stripe — Webhooks — Respuesta rápida, reintentos propios, duplicados y orden no garantizado. No prueba integración Think².
Sigue explorando
Lista de espera: no garantiza acceso inmediato ni un plan gratuito.