Envoi en masse (bulk) via l'API
Pour envoyer à de nombreux destinataires simultanément, utilisez l'endpoint bulk plutôt que d'appeler l'endpoint unitaire en boucle.
Endpoint
POST /v1/messages/bulk
Exemple de requête
{
"from": "ENVOISMS",
"channel": "sms",
"message_type": "eco",
"recipients": [
{ "to": "+212661111111", "variables": { "prenom": "Yassine" } },
{ "to": "+212662222222", "variables": { "prenom": "Salma" } }
],
"template": "Bonjour {{prenom}}, profitez de -20% ce week-end !"
}
Limites
Jusqu'à plusieurs milliers de destinataires par requête (voir la limite exacte dans la documentation technique selon votre plan). Pour des volumes plus importants, préférez l'envoi via l'interface Campagnes ou une connexion SMPP dédiée.
Suivi
Chaque destinataire reçoit un message_id individuel dans la réponse, permettant un suivi de statut granulaire via webhook ou l'endpoint /messages/{id}.