Messages

Envoi groupé

Le même texte à 1 000 destinataires au plus par requête. Chaque destinataire reçoit son propre message, avec son identifiant et ses événements.

POST/v1/messages/bulk-sendx-api-key · tout ou rien

Requête

tostring[]requis

Liste de 1 à 1 000 numéros au format international.

contentstringrequis

Texte du message, 1 024 caractères au plus.

fromstringrequis

Numéro d’envoi. Le choix automatique dans le parc arrive bientôt pour l’envoi groupé. Ignoré dans le sandbox.

request_idstring

Identifiant commun à tous les messages du lot. Si vous renvoyez le lot avec le même request_id, les destinataires déjà servis dans les 24 h reçoivent leur premier message en réponse, sans nouvel envoi ni nouveau débit.

curl -X POST https://api.getsms.tech/v1/messages/bulk-send \
  -H "x-api-key: $GETSMS_API_KEY" \
  -H "Content-Type: application/json" \
  -d '{"from": "+212661234501",
       "to": ["+212612345678", "+212623456789"],
       "content": "Vos soldes commencent demain à 9 h."}'

await fetch("https://api.getsms.tech/v1/messages/bulk-send", {
  method: "POST",
  headers: { "x-api-key": process.env.GETSMS_API_KEY, "Content-Type": "application/json" },
  body: JSON.stringify({
    from: "+212661234501",
    to: ["+212612345678", "+212623456789"],
    content: "Vos soldes commencent demain à 9 h.",
  }),
});

requests.post(
    "https://api.getsms.tech/v1/messages/bulk-send",
    headers={"x-api-key": os.environ["GETSMS_API_KEY"]},
    json={"from": "+212661234501", "to": ["+212612345678", "+212623456789"],
          "content": "Vos soldes commencent demain à 9 h."},
)

<?php
$payload = ["from" => "+212661234501", "to" => ["+212612345678", "+212623456789"],
            "content" => "Vos soldes commencent demain à 9 h."];
// même appel que pour un SMS, sur /v1/messages/bulk-send