Noms d’expéditeur

Gérer le nom dans Cloud

Un nom d’expéditeur permet d’identifier l’origine du SMS. Sa demande, sa validation et sa gestion restent dans BEFIANA Cloud. SMS v2 ne fournit pas d’endpoint public pour créer, lister, approuver ou modifier ces noms.

Avant une intégration, vérifiez dans Cloud que le nom souhaité est actif pour l’organisation à laquelle appartient la clé.

Fournir sender_name

Le champ facultatif sender_name est accepté pour les messages et les lots. Envoyez le nom exact, avec la même casse que dans Cloud.

Le nom validé contient entre 1 et 11 caractères : lettres ASCII, chiffres et espaces internes. Les espaces de début et de fin sont retirés lors de la validation. Un nom vide, null, accentué ou contenant de la ponctuation est refusé.

Un format correct ne suffit pas : le nom doit appartenir à l’organisation et être actif. Un nom inconnu, en attente, bloqué ou appartenant à une autre organisation n’est pas utilisable. L’API renvoie alors 403 avec sender_name_unavailable. Une erreur de format peut être renvoyée comme 400 validation_error.

Omettre le champ

Pour un nouveau message ou lot sans sender_name, la sélection suit cet ordre :

1. Le Sender Name défini par défaut pour l’organisation, s’il existe et est actif.
2. S’il n’existe aucun défaut, le nom historique associé à l’activation SMS.
3. Si ce nom historique est vide, BEFIANA.

Un défaut existant mais inactif provoque un refus ; le service ne choisit pas silencieusement le nom historique à sa place.

Ne supposez donc pas que l’absence du champ signifie toujours BEFIANA. Pour omettre le nom, retirez le champ de la requête ; n’envoyez pas une chaîne vide ou null.

Garder une sélection stable

Le nom choisi est enregistré lors de l’admission. Modifier le défaut dans Cloud ne change pas le nom d’un message déjà créé. Une reprise idempotente conserve la réponse initiale et ne choisit pas le nouveau défaut.

Lors d’une reprise, ne remplacez pas un champ omis par le nom retourné et ne changez pas un nom explicite : conservez la requête initiale. Un contenu différent avec la même clé produit un conflit d’idempotence.

Un nom approuvé peut devenir indisponible avant la soumission au fournisseur. Surveillez le statut du message, y compris blocked, au lieu de considérer l’admission comme une garantie d’envoi ou de livraison.

Pour résoudre un problème de validation ou d’activation du nom, utilisez l’assistance. Ne tentez pas un autre expéditeur pour contourner un refus.