# Comment envoyer un SMS via une API ?

> L'envoi d'un SMS via une API HTTP consiste à transmettre le numéro du destinataire, l'identifiant de l'expéditeur et le texte du message à un point de terminaison REST qui transmet le message aux réseaux des opérateurs et renvoie un identifiant de message permettant de suivre sa livraison.

- URL canonique: https://www.broadnet.me/fr/answers/how-to-send-sms-via-api
- Langue: fr
- Dernière révision: 2026-09-24
- Éditeur: BroadNet (https://www.broadnet.me)

## La demande

La passerelle BroadNet accepte une requête POST vers https://api.broadnet.me/sms/sendSms avec un jeton dans l'en-tête Authorization: Bearer et un corps JSON : senderId (l'identifiant d'expéditeur), destinationNumber (le numéro de destination au format international, chiffres uniquement, sans signe +), message (le texte) et messageType (TEXT pour le GSM-7, UNICODE pour l'arabe, les emojis et les autres alphabets non latins). Un appel réussi renvoie 200 OK avec l'identifiant du message dans le corps de la réponse.

## Encodage et longueur

Un message GSM-7 contient 160 caractères par segment (153 lorsqu'il s'étend sur plusieurs segments) ; le passage à l'Unicode pour les emojis ou les alphabets non latins réduit ce nombre à 70 (67 en concaténé). Utilisez messageType TEXT pour du GSM-7 simple et UNICODE lorsque le corps nécessite de l'Unicode ou de l'arabe, afin d'éviter les caractères corrompus ; POST /sms/identify renvoie l'encodage et le nombre de segments avant l'envoi.

## Suivez la livraison, ne la présumez pas.

L'identifiant du message renvoyé correspond à l'accusé de réception (DLR). Configurez un webhook pour recevoir le statut final de l'opérateur (livré, échec ou expiré) plutôt que de considérer un code 200 comme preuve de réception du message par le terminal.

## Passage à la production

Utilisez des numéros E.164 internationaux, enregistrez votre identifiant d'expéditeur sur chaque marché de destination avant d'augmenter votre volume d'envoi, et privilégiez les routes directes des opérateurs pour une latence constante. En cas de volume élevé, le même compte est accessible via SMPP et REST ; vous pouvez ainsi commencer par HTTP et changer de type de liaison sans avoir à le réintégrer.

## Questions fréquentes

### Puis-je envoyer un SMS avec une requête GET, ou ai-je besoin d'une requête POST ?

Utilisez POST. Le point de terminaison REST POST /sms/sendSms reçoit un corps JSON et un jeton Bearer, de sorte que le texte du message et les identifiants n'apparaissent jamais dans les URL ni dans les journaux du serveur. L'API HTTP historique (/websmpp/websms) accepte encore GET pour les intégrations existantes de l'ère SMPP, mais les nouvelles intégrations doivent utiliser l'API REST.

### Ai-je besoin SMPP, ou l'API HTTP est-elle suffisante ?

L'API REST/HTTP est suffisante pour la plupart des volumes et s'intègre très rapidement. Le SMPP est adapté aux débits soutenus très élevés et aux liaisons persistantes. Un même compte BroadNet fonctionne avec les deux protocoles ; vous pouvez donc commencer par HTTP et ajouter SMPP ultérieurement sans avoir à vous réinscrire.

### Comment savoir si un message a bien été délivré ?

L'envoi renvoie un identifiant de message ; le statut final du terminal est transmis de manière asynchrone sous forme d'accusé de réception (DLR) via votre webhook : livré, échec ou expiré. Ne considérez pas la réponse d'envoi comme une preuve de livraison.

## Voir aussi

- [Toutes les réponses](https://www.broadnet.me/fr/answers)
- [Glossaire](https://www.broadnet.me/fr/answers)
- [Qu'est-ce qu'une API SMS ?](https://www.broadnet.me/fr/answers/what-is-sms-api)
- [Qu'est-ce que le SMS A2P ?](https://www.broadnet.me/fr/answers/what-is-a2p-sms)
- [Qu'est-ce qu'un DLR (Delivery Receipt) ?](https://www.broadnet.me/fr/answers/what-is-dlr)
- [Comment améliorer les taux de délivrabilité des SMS ?](https://www.broadnet.me/fr/answers/how-to-improve-sms-delivery-rates)
- [SMS API](https://www.broadnet.me/fr/products/sms-api)
- [A2P SMS](https://www.broadnet.me/fr/products/a2p-sms)