Skip to main content
La réponse de sendbatch ne confirme que l’acceptation. Elle porte un batchId, un compte, et aucun id par-message. Les résultats par-message arrivent en callbacks.

​
Ce qui arrive

Un simple GET avec une query string. Il n’y a pas de corps.
statusText porte le messageId en cas de succès. C’est le seul endroit où un batch vous en donne un, donc si vous devez corréler plus tard des accusés à des membres individuels d’un batch, c’est dans ce callback que vous les capturez.

​
Un résultat par message, pas un par batch

Un batch de 500 produit jusqu’à 500 callbacks. Votre endpoint doit être bon marché et idempotent : les mêmes règles de retry que pour les accusés s’appliquent, donc un handler lent sera rappelé.

​
L’échec silencieux

Les clés inconnues dans batch_config sont ignorées, pas refusées.errback_url mal orthographié en errBack_url ou error_url ne produit pas de 400. Le batch est accepté, les messages sont envoyés, et chaque résultat par-message ne va nulle part. De l’extérieur, cela ressemble exactement à un batch où rien n’a échoué.C’est le seul endroit de l’API où une faute de frappe ne produit pas d’erreur, donc vérifiez-le délibérément : envoyez un batch contenant un message dont vous savez qu’il sera refusé — un sender ID non approuvé est le plus facile — et confirmez que le callback arrive.

​
Succès, retries et timeouts

Identiques aux accusés de livraison : Au budget par défaut, un endpoint inaccessible occupe un thread pendant vingt minutes par callback. Un endpoint down pendant un gros batch est donc coûteux pour votre fournisseur autant qu’inutile pour vous.

​
Ce que ceci n’est pas

  • Ce n’est pas un accusé de livraison. Un callback de batch dit que le message a été accepté ou refusé à l’entrée. Savoir s’il a été livré passe toujours par un dlr_url, que vous placez dans globals pour qu’il s’applique à chaque message du batch.
  • Non ordonné. Les résultats arrivent au fur et à mesure du traitement, pas dans l’ordre où vous les avez listés.

​
Voir aussi

Batches

Planification, globals et plafond d’expansion.

Accusés de livraison

L’issue, par opposition à l’acceptation.