Skip to main content
/secure/sendbatch met plusieurs messages en file en un seul appel.
Chaque élément prend les mêmes champs qu’un envoi unique. Le to d’un message peut lui-même être un tableau, ce qui multiplie.

​
La réponse ne confirme que l’acceptation

Il n’y a pas d’id par-message dans cette réponse, et pas de résultat par-message. messageCount est le nombre après expansion, pas le nombre qui a réussi.Les issues par-message arrivent sur votre URL d’errback en callbacks séparés. Un client qui traite un 200 ici comme “les trois ont été envoyés” se trompe précisément dans les cas qui comptent.

​
Valeurs par défaut et configuration

globals est fusionné sous chaque message, donc un champ défini sur un message individuel l’emporte.
Les clés inconnues dans batch_config sont ignorées, pas refusées. Une faute de frappe dans errback_url vous coûte chaque résultat par-message, silencieusement. Le batch est accepté et les callbacks n’arrivent simplement jamais.C’est le seul endroit de l’API où un champ mal orthographié ne produit pas de 400, donc vérifiez-le en envoyant un message délibérément en échec et en confirmant que le callback arrive.

​
Planification

schedule_at prend exactement deux formes : Tout le reste est 412 Got unknown format. Une date dans le passé est aussi refusée, plutôt qu’envoyée immédiatement.
Les batches planifiés ne survivent à un redémarrage que si la passerelle fonctionne avec un broker RabbitMQ, et pas même là quand la connexion au broker est dégradée. Si la planification durable compte pour vous, demandez à votre fournisseur quel fournisseur de queue il exploite et s’il alerte sur amqp.bridge.degraded.

​
Limites

Les destinations sous forme de tableau multiplient : 100 messages ayant chacun 200 destinataires font 20 000, et sont refusés.

​
Cadencement

Les batches se cadencent contre la profondeur de la queue du router, en pausant au-dessus d’un seuil haut. Vous n’avez pas à limiter vous-même la soumission d’un batch. Mais vous devez toujours respecter la limite messages-par-seconde de votre compte sur les envois ordinaires, qui est un plafond distinct et renvoie 429.

​
Voir aussi

Envoyer un batch

Chaque champ, avec les refus.

Callbacks de batch

Ce qui arrive sur callback_url et errback_url.