Responde con 2xx en hasta 5 segundos
La entrega tiene éxito cuando tu endpoint responde con un status2xx en hasta 5 segundos.
Recibe el evento, guárdalo y responde. Haz el procesamiento pesado después, fuera de la petición. Una respuesta lenta cuenta como fallo, y el evento se envía de nuevo.
Cuándo el evento se envía de nuevo
Cada espera cuenta desde el intento anterior:
Son hasta 7 intentos, dentro de 23 horas desde el evento. Pasado ese plazo, el evento ya no se envía.
Si tu endpoint falla una y otra vez, Omni Z-API pausa los envíos a tu dirección por un tiempo y luego los retoma. Los eventos de esa pausa no se pierden: siguen los mismos intentos, dentro del plazo de 23 horas.
Headers de cada entrega
Deduplica por x-webhook-delivery-id
La misma entrega puede llegar más de una vez. Esto ocurre, por ejemplo, cuando tu endpoint procesó el evento, pero tardó más de 5 segundos en responder.
Guarda los x-webhook-delivery-id ya procesados durante al menos 24 horas y descarta los repetidos.
El orden de llegada no está garantizado
Los eventos salen en el orden en que ocurren. Pero un evento que falló se envía de nuevo minutos u horas después, mientras los eventos siguientes se siguen entregando. Así, el status “leído” de un mensaje puede llegar antes del “entregado” que falló en el primer intento.- Ordena por la hora del evento, que viene en el cuerpo (en el formato por defecto, el campo
moment), y no por la hora de llegada. - Para los status, solo avanza: ignora un status más antiguo que el que ya guardaste.