Un commerce peut notifier de nombreux clients d'un même événement tout en personnalisant chaque texte. Chaque destinataire a toujours besoin d'une autorisation et d'un chemin de livraison valide.
Qu'est-ce qui change quand j'envoie à de nombreux destinataires ?
Vous coordonnez de nombreux envois indépendants au lieu de traiter une seule requête comme la campagne complète.
Chaque destinataire peut avoir une destination, une exigence d'expéditeur ou un état de consentement différent. Une livraison réussie à une personne ne dit rien du téléphone d'une autre personne.
La personnalisation modifie aussi le texte réel. Un nom plus long ou un emoji peut changer l'encodage et le nombre de segments. Comptez les corps de message finalisés pour estimer le volume facturable.
Dois-je utiliser un broadcast ou des lots API ?
Utilisez un broadcast pour coordonner une campagne autour d'une audience, d'un contenu partagé et d'un calendrier d'envoi. Utilisez les lots pour soumettre des messages indépendants depuis votre application.
Le workflow de campagne SMS relie la préparation de l'audience, la personnalisation, la revue avant lancement et les résultats par destinataire. Le endpoint de lot offre une opération plus restreinte : accepter des requêtes individuelles ensemble.
Un identifiant de lot ne remplace ni la gestion de campagne, ni les enregistrements de consentement, ni un calendrier.
Comment Bird accepte-t-il un lot ?
Vous soumettez entre 1 et 100 messages indépendants via POST /v1/sms/batches.
Placez chaque objet message dans le tableau messages. Une campagne de 250 destinataires nécessite au moins trois requêtes, car chaque lot contient au maximum 100 éléments.
Bird valide chaque élément avant d'en mettre un seul en file d'attente. Un message invalide fait échouer l'ensemble de la requête avec 422. Corrigez l'élément invalide avant de resoumettre le lot.
En cas de succès, data contient les messages acceptés dans l'ordre de soumission. summary.accepted_count indique le nombre accepté. La référence du lot documente cette réponse.
Conservez l'identifiant de chaque message retourné associé à son destinataire. Les événements de livraison ultérieurs appartiennent à ces messages individuels, pas à un résultat de lot partagé.
Un lot accepté signifie-t-il que tout le monde a reçu le texte ?
Une réponse 202 signifie que Bird a accepté les messages pour traitement.
La facturation, la soumission à l'opérateur et la livraison interviennent ensuite. Un message accepté peut échouer tandis que d'autres atteignent leurs destinataires. Mettez à jour la campagne à partir des événements de livraison de chaque message.
Ne renvoyez pas un lot accepté entier parce qu'un destinataire a échoué. Examinez l'erreur de ce message. Décidez si une tentative séparée est appropriée.
Comment estimer le temps d'envoi ?
Estimez chaque destination séparément en utilisant les limites et la capacité qui s'appliquent à son chemin d'envoi.
Une limite de requêtes API contrôle la vitesse à laquelle vous soumettez du travail. Le débit de livraison contrôle une étape ultérieure. Augmenter la concurrence de soumission ne peut pas supprimer la limite d'un opérateur.
Vérifiez l'unité avant de calculer la capacité. Une limite basée sur les segments compte un texte multipart plus d'une fois. Une limite basée sur les requêtes compte l'appel de lot à la place.
Bird affecte les requêtes de lot à sms_batch, séparément des envois unitaires sous sms_send. Le guide de limitation du débit explique ces politiques de requêtes. Le débit SMS traite la question distincte de la livraison.
Que vérifier avant de lancer la campagne ?
Vérifiez le consentement, l'éligibilité de l'expéditeur et le message finalisé pour chaque destinataire.
Utilisez l'état de désinscription récent lors de l'envoi du travail en file d'attente. Une liste exportée précédemment peut inclure une personne qui a depuis retiré son autorisation.
Vérifiez les exigences d'expéditeur de la destination avant de regrouper ses destinataires en lot. Un seul élément invalide peut sinon entraîner le rejet d'un lot contenant de nombreux messages valides.
Commencez par un groupe restreint. Inspectez les résultats retournés avant d'élargir l'envoi. Cela permet de repérer plus facilement un expéditeur ou un message erroné avant qu'il n'atteigne toute la liste.
- Appliquez les règles de la destination et l'autorisation de chaque destinataire.
- Validez les corps de message finalisés.
- Comptez leurs segments.
- Soumettez les lots dans les limites de requêtes.
- Suivez les résultats de livraison par message. Examinez chaque échec séparément.
En bref
Chaque destinataire conserve un message indépendant.
L'acceptation d'un lot ne fait pas partager un même résultat de livraison à tous les destinataires.
Un lot Bird contient au maximum 100 messages.
Utilisez les lots pour des envois API indépendants. Un broadcast d'audience gère le workflow de campagne coordonné.
La validation s'applique à l'ensemble du lot.
Un seul élément invalide amène Bird à rejeter la requête avant qu'aucun élément ne soit mis en file d'attente.
Le consentement et l'éligibilité de l'expéditeur restent des vérifications individuelles.
Revérifiez les autorisations et les exigences de destination lors de l'envoi de chaque partie d'une campagne.