API SMS professionnel : envoyez, programmez et suivez vos messages
Envoyez un SMS par requête, connaissez le nombre de segments avant de facturer et recevez chaque changement de statut. Tarification sur devis.
Sur devis
L’API SMS envoie des messages texte à vos contacts depuis votre application. Vous indiquez l’expéditeur, le destinataire, le texte et la nature du message : transactionnel ou marketing.
Un SMS n’est pas toujours un seul message pour le réseau. Un texte long, ou contenant certains caractères comme les émojis, est découpé en segments, et chaque segment compte. L’API vous renvoie l’encodage retenu (GSM-7 ou UCS-2) et le nombre de segments.
Les statuts remontent au fil du traitement : queued, sent, delivered, undelivered ou unknown. « Livré » signifie que l’opérateur a remis le message au téléphone, pas que la personne l’a lu.
Comment ça circule
Usages concrets
Codes et alertes
Envoyez des codes de confirmation, des notifications de livraison ou des alertes de service.
Rappels de rendez-vous
Programmez un message la veille, à l’heure locale du destinataire.
Messages commerciaux encadrés
Distinguez les messages marketing des messages transactionnels pour appliquer les bonnes règles.
Réponses des clients
Recevez les réponses sur un numéro compatible et traitez-les dans votre application.
Fonctionnalités
- Envoi unitaire ou programmé, avec fuseau horaire
- Estimation des segments et de l’encodage avant envoi
- Choix de la nature du message : transactionnel ou marketing
- Vérification de l’expéditeur et test vers une destination vérifiée
- Statuts queued, sent, delivered, undelivered et unknown
- Réception de SMS entrants sur un numéro compatible
Limites à connaître
- Un SMS long est facturé en plusieurs segments. Un texte avec émojis ou accents peu courants bascule en UCS-2 et réduit la taille de chaque segment.
- « Livré » ne veut pas dire « lu ». Aucune livraison n’est garantie : elle dépend de l’opérateur du destinataire.
- La réception de SMS exige un numéro et un pays compatibles. Un numéro qui sait appeler ne sait pas forcément recevoir des SMS.
- L’expéditeur personnalisé, son format et son enregistrement varient selon le pays et l’opérateur.
- Le statut unknown signifie que l’opérateur n’a pas donné de réponse finale. Il ne vaut ni succès ni échec.
curl -X POST "https://api.example.test/v1/messages" \
-H "Authorization: Bearer tq_test_EXEMPLE" \
-H "Idempotency-Key: 7b1d2c4e-0000-4000-8000-000000000003" \
-H "Content-Type: application/json" \
-d '{
"from": "+33199001234",
"to": "+33199001235",
"text": "Votre rendez-vous est confirmé demain à 10 h.",
"nature": "transactional",
"scheduled_at": "2026-11-20T09:00:00",
"timezone": "Europe/Paris"
}'
# => { "id": "msg_exemple", "status": "queued", "segments": 1,
# "encoding": "GSM-7", "simulated": true }Éléments techniques
| Envoi | POST /messages, Idempotency-Key obligatoire |
|---|---|
| Nature | transactional ou marketing |
| Encodage | GSM-7 ou UCS-2, renvoyé avec le nombre de segments |
| Programmation | scheduled_at et timezone |
| Événements | message.sent, message.delivered, message.undelivered |
Questions fréquentes
Pourquoi mon message compte-t-il plusieurs segments ?
Parce que le texte dépasse la taille d’un segment, ou contient des caractères qui imposent l’encodage UCS-2, plus restrictif. L’API renvoie le nombre de segments dès la création.
Que signifie le statut unknown ?
L’opérateur n’a pas communiqué de statut final. Le message peut être arrivé ou non. Ne le traitez ni comme un succès ni comme un échec définitif.
Puis-je recevoir les réponses de mes contacts ?
Oui, si le numéro et le pays le permettent. La réception de SMS n’est pas disponible partout. Elle se vérifie au moment de la recherche du numéro.
Usages associés
Documentation
Services associés
Planifions vos envois de SMS
Précisez les pays, le type de messages et les volumes. Nous préparons un devis qui détaille les conditions par destination.