Logo de Think²Think²
Entrar

Guías

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

  1. 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.
  2. 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.
  3. 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.
  4. 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

Sigue explorando

Lista de espera: no garantiza acceso inmediato ni un plan gratuito.