API Soumission d'envois SMS par lot

Si vous soumettez des messages à l'aide de l'API, vous ignorez peut-être que nous offrons la possibilité d'envoyer plusieurs messages en un seul appel, plutôt que d'effectuer plusieurs envois uniques.

L'envoi par lot offre de nombreux avantages, notamment :

• Une réduction des appels réseau nécessaires,
• Une acceptation plus rapide de vos messages,
• Un débit optimisé vers notre passerelle.

Les options d'envoi par lot à votre disposition diffèrent en fonction de l'API sous-jacente utilisée par votre code. Votre code peut utiliser un service Web SOAP ou effectuer des appels HTTP vers une page ASPX.

Service Web SOAP

Si vous effectuez des appels API vers le service Web SendService, vous avez un accès total aux méthodes par lot que nous proposons. Ces méthodes vous permettent :

• D'envoyer le même message texte à plusieurs numéros mobiles,
• D'envoyer une collection d'objets de message pouvant contenir différents numéros de mobile et textes de message.

Si vous soumettez le même texte de message à plusieurs numéros de mobiles (par exemple, un message marketing destiné à un groupe d'abonnés), tirez parti des méthodes SendMessageMultipleRecipients et SendMessageMultipleRecipientsFull. Elles prennent en charge une collection de numéros de mobiles au lieu d'un numéro unique.

Si vous devez soumettre un certain nombre de messages simultanément, mais que le contenu des messages diffère (par exemple, envoi de messages personnalisés à vos clients), vous pouvez utiliser la méthode SendMessageBatch. Cette méthode prend en charge une collection d'objets messagesubmission. Un objet messagesubmission contient l'ensemble des informations de message d'un message unique.

HTTP Post

Si vous utilisez l'interface HTTP Post pour envoyer des messages, la seule option de traitement par lot disponible consiste à envoyer le même texte de message à une collection de numéros de mobiles. Pour ce faire, il vous suffit de séparer par une virgule les numéros de mobiles du paramètre Destinataire d'un appel HTTP SendSMS.aspx.

Gestion de la réponse

L'appel de l'une de ces méthodes entraîne le renvoi d'un certain nombre d'identifiants de message, plutôt que l'identifiant unique que vous obtenez lorsque vous soumettez un message unique. Cette collection d'identifiants est classée dans le même ordre que les messages envoyés à l'origine.

Remarques importantes

• Nos tests indiquent que le nombre optimal de messages par lot ne doit pas être supérieur à 50.
• Les accusés de réception et les réponses entrantes à un message transmis par lot sont traités de la même manière que les envois uniques normaux
• Si jamais un message individuel d'un lot n'est pas accepté (et que le reste du lot est correct), l'identifiant de message renvoyée pour ce message sera un Guid vide (00000000-0000-0000-0000-000000000000)