API SMS pour des envois vers la France
Une intégration SMS se juge rarement sur l'appel d'envoi, qui est simple partout. Elle se juge sur ce qui revient : les accusés de réception, les réponses entrantes, et la manière dont les erreurs opérateur remontent jusqu'à votre application.
Pour la France, trois contraintes ne se règlent pas côté code et doivent être connues avant l'intégration : la fenêtre horaire promotionnelle, la mention de désinscription obligatoire, et l'impossibilité d'utiliser des caractères spéciaux dans un nom d'expéditeur.
Les accusés de réception sont la partie utile
Un envoi accepté par l'API n'est pas un message livré. L'information qui compte arrive plus tard, par webhook, sous forme de changement d'état. Sans traitement de ces états, une application ne sait pas distinguer un numéro invalide d'un téléphone éteint.
Le piège classique est de considérer un état livré comme une preuve de lecture. Selon les réseaux, un accusé peut être émis à l'entrée dans le réseau de l'opérateur plutôt qu'à la remise sur le terminal. Une statistique de délivrabilité construite sur cette hypothèse est fausse dans le sens le plus flatteur.
Ce que l’API ne peut pas contourner
La fenêtre 08:00-21:30 de la charte AF2M s'applique au message promotionnel quel que soit le canal d'envoi. Une file d'attente qui dépile à 23 h enverra des messages hors fenêtre : la planification doit donc être gérée dans votre application ou par la plateforme, en heure française.
La mention de désinscription doit être présente dans le corps du message. Elle consomme des caractères et peut faire basculer un message d'un à deux segments : le calcul du coût doit en tenir compte au moment de la composition, pas à la facturation.
Encodage et nom d’expéditeur
Le nom d'expéditeur alphanumérique est recommandé par les opérateurs français pour le trafic A2P, mais les caractères spéciaux n'y sont pas acceptés. Un nom contenant un accent ou un symbole sera refusé ou altéré selon la route.
Côté contenu, un seul caractère hors GSM 7 bits fait passer le message en UCS-2 et réduit le segment à 70 caractères. Une API qui ne renvoie pas le nombre de segments calculé avant envoi laisse cette erreur se répéter à chaque campagne.
Sources, par sujet
| Code pays mobile | www.twilio.com2026-09-22 |
| Expéditeur alphanumérique | api.support.vonage.com2026-09-22 |
| Horaires d’envoi autorisés | af2m.org2026-09-22 |
| SMS bidirectionnel | www.twilio.com2026-09-22 |
| Route SMSPro : marché non encore cartographié | lib/sms/providers/capabilities.ts2026-09-22 |
Cas d’usage
Codes à usage unique
Message attendu, hors fenêtre promotionnelle, avec un besoin de latence et d'états de livraison fiables. Les codes ne doivent pas partager la file d'attente d'une campagne marketing.
Notifications de commande et de livraison
Déclenchées par un événement du système e-commerce, avec un webhook d'état qui met à jour la commande. Le lien entre message et commande doit survivre à un renvoi.
- La contrainte horaire s'applique au canal API comme au canal web pour le trafic promotionnel.
- Nom d'expéditeur sans caractères spéciaux : contrainte opérateur, pas paramètre d'API.
FAQ
Un message accepté par l’API est-il un message livré ?
Non. L'acceptation signifie que la requête est valide et que le message est pris en charge. L'état réel arrive ensuite par webhook. Selon les réseaux, un état de livraison peut être émis à l'entrée dans le réseau de l'opérateur et non à la remise sur le terminal.
Peut-on utiliser des accents dans le nom d’expéditeur en France ?
Non. Les documentations opérateur consultées indiquent que les caractères spéciaux ne sont pas acceptés dans un nom d'expéditeur français, et que seuls les expéditeurs comportant de tels caractères feraient l'objet d'un enregistrement préalable.
Quel est le code MCC de la France ?
208. Ce code identifie le pays dans les échanges entre opérateurs mobiles et sert à router le message vers le bon réseau national.
Comment gérer la fenêtre horaire dans une intégration ?
En planifiant en heure française plutôt qu'en heure du serveur. Une file qui dépile à 23 h heure locale d'Europe centrale enverra à 22 h heure française, donc hors de la fenêtre 08:00-21:30 pour le trafic promotionnel.
Documentation technique et création de compte accessibles ; l'activation commerciale par marché est vérifiée au paiement.
SMSPro · 4 sources consultées · 2026-09-25