Erreurs et nouvelles tentatives

Traitez les erreurs de façon prédictible et idempotente.

Toutes les erreurs applicatives suivent ce contrat :

{
  "error": {
    "code": "rate_limit_exceeded",
    "message": "Too many requests.",
    "retryable": true,
    "request_id": "f8971bc1-4c57-4f65-a846-9a9cebea63cc"
  }
}

HTTP	Action
400 / 422	Corriger la requête ; ne pas réessayer automatiquement
401	Créer un nouveau token ou vérifier les identifiants
403	Vérifier le scope ou la capability
404	Vérifier l’identité et la conversation
409	Utiliser un nouveau client_message_id si le contenu change
413	Réduire le corps de la requête
429	Backoff exponentiel avec jitter
503	Réessayer progressivement

Réutilisez un client_message_id uniquement pour rejouer le même message. Cela permet de reprendre après une coupure sans créer de réponse en double.

En sandbox, daily_message_limit_exceeded signifie que les 50 nouveaux messages de l’application ont été utilisés pour la journée. Le quota se réinitialise à 00:00 UTC. Une reprise idempotente avec le même client_message_id et le même contenu reste autorisée.