Questions et réponses sur l'API Bulk SMS

Une API SMS en masse pour les développeurs : envoyez un texte ou un lot de jusqu'à 10 000 numéros par requête à 227 pays via REST, suivez chaque message avec des webhooks signés, et payez par message depuis un solde prépayé. Une console web envoie des campagnes à partir d'une liste collée ou d'un CSV sans code.

Les équipes produit et ingénierie qui envoient des SMS depuis leurs propres systèmes : codes de connexion et d'inscription, mises à jour de commandes et de livraisons, rappels de rendez-vous, alertes de paiement, avis de service et campagnes marketing. Toute personne pouvant faire une requête HTTPS peut l'utiliser.

227 pays et territoires, listés avec leurs prix sur la page des tarifs et les pages des pays. Une requête peut mélanger des pays : chaque numéro est tarifé selon le pays auquel il appartient.

Non. Vous payez par segment de message depuis un solde prépayé, et il n'y a pas de frais mensuels, de frais d'installation ou de volume minimum. Le solde n'a pas de date d'expiration.

Les comptes commencent avec un solde à zéro et la première recharge débloque tout. La première recharge ajoute un bonus allant jusqu'à 40%, donc les premiers messages coûtent moins cher. Les prix sont publics, et le point de terminaison d'estimation ainsi que la console montrent le coût exact avant tout envoi.

POST /v1/batches accepte jusqu'à 10 000 numéros par requête, soit un texte pour tout le monde, soit un texte personnalisé par numéro. La console accepte 50 000 numéros par campagne. Les listes plus longues sont divisées en plusieurs requêtes.

La file d'attente s'exécute toutes les deux secondes et transmet jusqu'à 1 200 messages par minute par compte au réseau, dans l'ordre où ils ont été acceptés. Un message unique part généralement quelques secondes après la requête.

Format international E.164 : un signe plus, l'indicatif téléphonique et le numéro national, par exemple +14155550123. Les espaces, tirets, parenthèses et le préfixe 00 sont nettoyés automatiquement ; les doublons et les numéros illisibles sont mis de côté et non facturés.

Jusqu'à 10 segments : 1 530 caractères en GSM-7 ou 670 en Unicode. Un segment contient 160 caractères GSM-7 ou 70 caractères Unicode ; les textes plus longs sont divisés en parties de 153 ou 67 caractères et réassemblés sur le téléphone.

Un caractère en dehors de l'alphabet GSM-7, comme une guillemet bouclé, un emoji ou une lettre comme á ou ç, bascule tout le texte en Unicode à 70 caractères par segment. Le compositeur de la console identifie ces caractères, et POST /v1/estimates renvoie l'encodage avant l'envoi.

Oui. Ajoutez send_at à une requête API, ou choisissez une heure dans la console, de 2 minutes à 45 jours à l'avance. Un lot programmé peut être annulé jusqu'à son démarrage, et son coût total est restitué au solde.

Oui. Via l'API, envoyez un lot avec des messages, un {to, text} par destinataire. Dans la console, collez ou téléchargez une liste avec des colonnes supplémentaires et utilisez les champs de fusion {{1}} à {{9}} dans le texte.

Définissez votre texte de désinscription une fois dans les Paramètres, par exemple un lien ou une adresse e-mail, et la console l'ajoute aux textes de campagne lorsque vous cochez la case. Via l'API, vous contrôlez le texte complet, ajoutez donc vous-même la ligne aux messages marketing. Les numéros de votre liste de non-envoi sont ignorés par la console et l'API, et ne sont pas facturés.

Oui. La console propose un envoi test à un numéro avant une campagne, et via l'API, vous pouvez envoyer un message unique à votre propre téléphone avec POST /v1/messages.

Chaque message passe de 'queued' à 'sent' puis 'delivered' ou 'failed'. Ajoutez une URL de webhook dans la console pour recevoir un événement signé pour chaque statut final, ou consultez GET /v1/messages/{id} et GET /v1/batches/{id}.

Au format Standard Webhooks : en-têtes webhook-id, webhook-timestamp et webhook-signature, où la signature est un HMAC-SHA256 de l'id, timestamp et corps brut avec votre secret whsec_. La documentation fournit du code de vérification pour Node.js, Python, PHP et Go.

Chaque événement bénéficie de 10 tentatives sur environ 24 heures, et chaque tentative est listée dans la console avec son statut HTTP. Vous pouvez aussi interroger les endpoints de message à tout moment.

Le téléphone portable peut être éteint pendant trop longtemps, le numéro peut ne plus être en service ou le réseau peut refuser le message. Le statut d'échec inclut un code d'erreur, et le prix est remboursé.

Les lots, messages et registre de solde restent dans votre compte et dans l'API. Le journal des requêtes conserve vos 500 derniers appels API et le journal webhook vos 500 dernières livraisons.

Oui. Dans la console, collez des numéros ou importez un fichier CSV de jusqu'à 50 000 lignes, rédigez le texte avec des champs de fusion, vérifiez l'aperçu pour chaque destinataire et le coût par pays, puis envoyez immédiatement ou à une heure programmée.

Solde, lots récents avec compteurs en direct, chaque lot avec ses messages et statuts, recharges et registre, clés API, paramètres et livraisons des webhooks, journal des requêtes, liste des prix, tickets de support et paramètres.

Depuis la page Support de la console. Les questions de paiement peuvent être posées dès le premier jour ; les autres sujets sont accessibles après le premier rechargement crédité.