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.

