Segments SMS et crédits

Un message peut utiliser deux crédits

L’API limite chaque texte à deux segments. Un segment représente une unité de crédit par destinataire : un message de deux segments adressé à trois destinataires nécessite six crédits.

Le champ segments d’un message décrit le calcul retenu par le service. La taille du texte affiché dans votre interface ne suffit pas à retrouver ce nombre.

Les règles du calcul actuel

Le service normalise le texte en NFC pour le calcul. Pour la branche compatible GSM, il traite aussi certaines ponctuations typographiques comme leurs équivalents simples : par exemple une apostrophe courbe comme une apostrophe droite, ou … comme trois points.

Les caractères de l’alphabet principal comptent pour une unité ; ceux de l’extension comptent pour deux. Le calcul du service inclut notamment €, ^, {, } et ê parmi les caractères à deux unités. Il ne faut donc pas assimiler « un caractère visible » à « une unité ».

Défilement horizontal si nécessaire. Au clavier : Tab, puis les flèches gauche et droite.

Calcul	Un segment	Au-delà d’un segment
Branche GSM du service	Jusqu’à 160 unités	153 unités par segment
Branche Unicode du service	Jusqu’à 70 points de code après NFC	67 points de code par segment

Dès qu’un caractère n’appartient pas à l’alphabet reconnu, le message entier passe dans la branche Unicode. Celle-ci est désignée UCS-2 par le compteur interne ; le calcul actuel compte les points de code normalisés et ne constitue pas un compteur universel d’unités UTF-16.

Les exemples suivants utilisent des caractères dont le résultat est déterminé par le calcul actuel :

Défilement horizontal si nécessaire. Au clavier : Tab, puis les flèches gauche et droite.

Texte	Résultat	Admission v2
A répété 160 fois	1 segment	Accepté si les autres conditions sont réunies
A répété 161 fois	2 segments	Accepté si les autres conditions sont réunies
A répété 306 fois	2 segments	Accepté si les autres conditions sont réunies
A répété 307 fois	3 segments	Refusé
€ répété 80 fois	1 segment	Accepté si les autres conditions sont réunies
€ répété 81 fois	2 segments	Accepté si les autres conditions sont réunies
ā répété 70 fois	1 segment	Accepté si les autres conditions sont réunies
ā répété 71 ou 134 fois	2 segments	Accepté si les autres conditions sont réunies
ā répété 135 fois	3 segments	Refusé

La normalisation décrite sert au calcul. N’en déduisez pas que le texte soumis sera réécrit dans le message reçu. Pour les textes mêlant emoji, séquences combinées et signes inhabituels, n’appliquez pas un simple seuil au nombre de caractères affichés.

Limites de validation

text doit être une chaîne non vide et ne pas contenir seulement des espaces. Le champ a également un plafond de 320 caractères avant le calcul des segments. Ce plafond ne permet pas d’envoyer 320 lettres GSM : A répété 307 fois dépasse déjà deux segments.

SMS v2 ne fournit pas d’endpoint public de simulation du coût. Un appel de création peut réserver ou consommer des crédits et envoyer un SMS ; ne l’utilisez pas comme calculateur sans effet.

Réservation et consommation

Une programmation ou un lot réserve les crédits nécessaires dès l’admission. Pour un lot, le montant initial est segments du texte × nombre de destinataires. Le champ credits_reserved du lot conserve ce montant initial.

L’acceptation par le fournisseur et la livraison au téléphone sont distinctes. N’attendez pas delivered pour considérer que des crédits ont pu être consommés. Un résultat incertain peut garder des crédits réservés ; ne le traitez pas comme un remboursement.

Consultez GET /api/sms/v2/balance/ avec balance.read pour les valeurs total, available et reserved. Les crédits expirés ne financent pas un nouvel envoi. Une lecture favorable n’empêche pas un 409 insufficient_credits si d’autres opérations utilisent le solde entre-temps.

Retrouvez les crédits et contacts, les lots et la gestion des erreurs.