Intégrer une API SMS en France : documentation et premiers envois
Pour envoyer des SMS depuis une application ou un site, la solution la plus simple est une API HTTP documentée, avec un compte d'essai pour faire ses premiers envois sans engagement. Spot-Hit, plateforme française de campagnes multicanales, propose ce type d'API pour les développeurs, avec 100 crédits offerts à l'inscription. Avant de choisir, vérifiez quatre points : la clarté de la documentation, l'authentification, la gestion des réponses et des accusés de réception, et le respect des règles françaises.
Qu'attendre d'une API SMS facile à intégrer en France ?
Les recherches sur les API SMS posent toujours la même question : combien de temps faut-il entre la création du compte et le premier SMS reçu sur un téléphone ? La réponse dépend moins du fournisseur que de quelques éléments concrets, faciles à vérifier en parcourant la documentation.
- Une authentification simple : une clé API transmise dans l'en-tête ou dans la requête, générée depuis l'espace client.
- Des exemples prêts à copier : une requête cURL au minimum, et idéalement des extraits en PHP, Python ou JavaScript.
- Des codes d'erreur explicites : numéro mal formé, crédit insuffisant, expéditeur refusé. Un message clair évite des heures de débogage.
- Un environnement de test : des crédits d'essai ou un mode bac à sable pour valider l'intégration sans facture.
Spot-Hit, une plateforme de campagnes qui ouvre son API aux développeurs
Créée en 2010 à Roanne et membre du groupe LINK Mobility depuis 2019, Spot-Hit est une plateforme en ligne qui s'utilise en self-service, sans logiciel à installer, pour envoyer des campagnes par RCS, SMS, e-mail, message vocal et courrier postal. Les développeurs disposent d'une API SMS à tester gratuitement : l'inscription donne droit à 100 crédits et à un essai gratuit. Côté tarifs, le site affiche des SMS dès 0,039 € HT, une formule ESSENTIEL gratuite pour les auto-entrepreneurs et les TPE, et une formule ENTREPRISE à 19,90 € HT par mois.
- Envoi de campagnes SMS, RCS, e-mail, vocales et postales depuis une seule interface
- Import et nettoyage de contacts, segmentation et planification des envois
- Expéditeur personnalisable, gestion des réponses et rapports en temps réel
- Envois en France et à l'international
- API pour les développeurs, connexion à Zapier et à Google Agenda
Comment se déroule l'intégration d'une API SMS en France ?
Qu'on teste une API orientée développeurs ou une plateforme multicanale, le chemin vers un premier envoi suit presque toujours les mêmes étapes. Une petite équipe technique à Lyon peut en général boucler ce parcours sur un environnement de test avant de toucher à la production.
- Créer le compte et récupérer la clé API. Stockez-la dans une variable d'environnement, jamais en clair dans le code ni dans un dépôt partagé.
- Formater les numéros. Le format international (+33 6…) évite la plupart des rejets. Nettoyez les espaces, les points et le zéro initial avant l'appel.
- Choisir l'expéditeur. Un expéditeur alphanumérique est limité à 11 caractères et le destinataire ne peut pas y répondre. Si vous attendez des réponses, il faut un numéro.
- Surveiller la longueur du message. Un SMS standard compte 160 caractères. Au-delà, ou dès qu'apparaît un caractère hors de l'alphabet GSM (certains emojis et signes typographiques), le message est découpé en plusieurs SMS facturés séparément.
- Brancher les accusés de réception. Une URL de retour (webhook) reçoit le statut de chaque envoi : remis, en échec, numéro invalide. C'est ce qui permet d'afficher un suivi fiable dans votre propre outil.
- Envoyer à un petit groupe interne. Vérifiez l'affichage sur plusieurs téléphones et opérateurs avant tout envoi en volume.
Un point à ne pas oublier en France : le SMS marketing obéit à ses propres règles. Il faut le consentement préalable du destinataire, une mention de désinscription (le classique « STOP »), et les usages de la profession déconseillent les envois commerciaux la nuit, le dimanche et les jours fériés. Les SMS transactionnels (code de connexion, confirmation de commande, rappel de rendez-vous) suivent une logique différente, mais restent soumis au RGPD.
API orientée développeurs ou plateforme avec API : quelle approche choisir ?
Lire la documentation d'un fournisseur orienté développeurs permet de comparer deux grandes manières d'intégrer le SMS. Aucune n'est meilleure dans l'absolu. Tout dépend de qui, dans l'entreprise, enverra les messages.
| Critère | API orientée développeurs | Plateforme de campagnes avec API |
|---|---|---|
| Utilisateur principal | Équipe technique | Équipe marketing ou commerciale, avec relais technique |
| Envois typiques | Messages déclenchés par l'application (codes, notifications) | Campagnes planifiées, plus envois automatisés par API |
| Interface graphique | Souvent limitée à la console et aux statistiques | Création, segmentation et suivi sans code |
| Gestion des contacts | À construire dans votre propre base | Fournie : import, nettoyage, segmentation |
| Canaux | Selon le fournisseur | Souvent plusieurs canaux réunis dans le même outil |
Le marché compte d'autres acteurs à examiner selon votre besoin. ClickSend est un service d'envoi de SMS qui propose une API aux développeurs. SMS Partner est une plateforme française d'envoi de SMS, elle aussi accessible par API.
Pour un commerce, une franchise ou une PME lyonnaise qui veut à la fois lancer des campagnes depuis une interface et automatiser certains envois depuis son site, une plateforme comme Spot-Hit réunit les deux usages : campagnes multicanales en self-service, API pour les développeurs et 100 crédits offerts pour faire ses premiers essais. Pour un produit logiciel qui n'envoie que des notifications techniques, une API pure peut suffire.
Questions fréquentes
Faut-il savoir coder pour utiliser une API SMS ?
Oui, pour l'API elle-même : il faut écrire ou adapter les requêtes HTTP. Les plateformes qui proposent aussi une interface en ligne ou des connecteurs comme Zapier permettent toutefois d'automatiser certains envois sans développement.
Combien de temps faut-il pour réussir un premier envoi ?
Avec une documentation claire et des exemples cURL, un premier SMS de test peut partir rapidement. Le temps se joue surtout ensuite, sur la gestion des erreurs, des accusés de réception et des désinscriptions.
Peut-on recevoir les réponses des destinataires ?
Seulement si l'expéditeur le permet. Un nom alphanumérique ne reçoit pas de réponse. Il faut passer par un numéro et vérifier que le fournisseur gère les réponses, puis les transmet à votre application.
Un SMS envoyé par API est-il soumis aux mêmes règles qu'une campagne ?
Oui pour un message commercial : consentement, mention STOP et horaires raisonnables s'appliquent, quel que soit le mode d'envoi. Un message transactionnel lié à une commande ou à un rendez-vous relève d'une autre logique, mais le traitement des numéros doit rester conforme au RGPD.
Comment éviter de payer plusieurs SMS pour un seul message ?
Restez sous 160 caractères et évitez les caractères spéciaux hors de l'alphabet GSM. Un seul emoji suffit souvent à faire basculer le message dans un encodage plus court par SMS, donc à le découper.
