Skip to main content

Requisitos del endpoint receptor

  • Debe aceptar solicitudes HTTP POST.
  • Debe leer el cuerpo como JSON (Content-Type: application/json).
  • Debe responder con HTTP 200 para confirmar la recepción.
  • Debe ser accesible públicamente desde Internet. La URL debe usar HTTPS.

💻 Ejemplos


Buenas prácticas

  • Diseñar el modelo de datos de forma flexible: no rechazar payloads por tener campos desconocidos.
  • Responder 200 siempre y rápido: procesar el evento de forma asíncrona si la lógica es costosa.
  • Implementar idempotencia: usar task_id + participation_id como clave de deduplicación.
  • Registrar todos los payloads recibidos antes de procesarlos para facilitar la depuración.
  • No bloquear el hilo de procesamiento: delegar la lógica de negocio a una cola de tareas.

Limitaciones y consideraciones

  • El webhook solo puede configurarse al crear la tarea; no es modificable después.
  • Cada tarea tiene un único webhook. No es posible configurar múltiples URLs.
  • El evento PARTICIPATION_STATUS_CHANGED actualmente solo se emite cuando la participación requiere validación manual.
  • No existe reintento automático documentado en caso de fallo del endpoint receptor.