Tout ce qui mérite d'être su, rien qui ne le mérite pas.
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.