Identifiants d'expéditeur SMS

Un expéditeur est le from qu'un destinataire voit sur votre SMS. Votre espace de travail contient un expéditeur par identité depuis laquelle il peut envoyer, et chaque pays de destination décide quels types d'expéditeur il accepte et ce qu'il exige d'enregistrer au préalable. Détenir un expéditeur n'est pas la même chose qu'être autorisé à envoyer depuis celui-ci : ce sont deux étapes distinctes, et ce guide couvre les deux.

Les expéditeurs se trouvent sur la page Senders, une ligne par expéditeur, avec son statut et le nombre de destinations actives, en attente ou nécessitant votre attention. L'appel d'envoi lui-même, y compris la validation d'une valeur from, est décrit dans Envoi de SMS.

Types d'expéditeurs

Le sender_type d'un expéditeur est le type d'identité qu'il représente, et il détermine ce que chaque pays exige de lui :

Identifiant d'expéditeur alphanumérique : une courte chaîne de marque telle que BIRD, de 3 à 11 lettres ASCII, chiffres, espaces, tirets, traits de soulignement ou points, avec au moins une lettre. Les espaces, tirets, traits de soulignement et points ne peuvent pas être le premier ou le dernier caractère. Les destinataires voient votre nom au lieu d'un numéro et ne peuvent pas y répondre. De nombreux pays exigent un enregistrement avant tout envoi de trafic, et certains, dont les États-Unis, n'en acceptent aucun. Vous revendiquez ce type vous-même.
Numéro long : un numéro ordinaire que vous détenez, capable d'envoyer et de recevoir. Un numéro long américain nécessite une marque et une campagne enregistrées avant de transmettre du trafic application-vers-personne ; voir 10DLC registration.
Numéro gratuit : un numéro dont le coût est à la charge de l'appelé, qui en Amérique du Nord peut aussi transporter de la messagerie. Envoyer depuis un tel numéro implique de compléter d'abord la vérification de numéro gratuit.
Numéro court : un numéro national court pour un programme de messagerie approuvé, dont la longueur et le débit sont déterminés par le marché et le programme de l'opérateur. Bird attribue les numéros courts au lieu de les vendre, ce type n'est donc pas en libre-service.

Un expéditeur indique aussi source_kind, qui précise ce qui le soutient : alpha pour une chaîne d'expéditeur que vous avez revendiquée, number pour un numéro dédié que vous détenez, et shared_number pour un numéro géré par Bird depuis lequel votre espace de travail envoie. Le tableau de bord les désigne par Alphanumeric, Dedicated number et Shared number. Types de numéros explique comment le type propre d'un numéro est choisi, et Acheter et libérer un numéro couvre l'attribution.

Les types qu'un pays accepte, et s'il les examine, évoluent à mesure que les opérateurs et les régulateurs révisent leurs règles. Destinations SMS publie la situation actuelle par pays ; consultez-la plutôt que de supposer qu'un pays se comporte comme ses voisins.

Revendiquer un identifiant d'expéditeur alphanumérique

Revendiquer une chaîne d'expéditeur est gratuit et prend effet immédiatement. Sur la page Senders, ouvrez Add sender et choisissez Add sender ID, puis saisissez la chaîne. Via API :

Exemple de code

bird sms senders create --type alpha --sender BIRD

La réponse contient l'id du nouvel expéditeur, préfixé snd_, et toutes les autres opérations de ce guide utilisent cet id. Un identifiant revendiqué avec succès peut envoyer là où l'enregistrement est absent ou facultatif, à condition que ces destinations soient activées. Un enregistrement obligatoire doit d'abord être approuvé.

Deux refus peuvent survenir ici. Un 412 signifie que votre organisation n'a pas terminé la vérification d'identité requise par cette opération : complétez-la dans Identity Center, puis réessayez. Un 409 signifie que la chaîne d'expéditeur est déjà revendiquée.

alpha est le seul type créé par cet appel. Un numéro dédié devient un expéditeur lorsque vous l'attribuez depuis l'inventaire : acheter le numéro crée son expéditeur avec lui. Les numéros courts et les numéros partagés arrivent dans un espace de travail par attribution depuis Bird plutôt que par achat.

Vérifier ce qu'un pays exige

Une seule lecture répond à ce que chaque pays exige d'un expéditeur. Elle retourne une ligne par pays que l'expéditeur peut atteindre, et chaque ligne se suffit à elle-même :

Exemple de code

bird sms senders requirements snd_01krdgeqcxet5s7t44vh8rt9mg
bird sms senders requirements snd_01krdgeqcxet5s7t44vh8rt9mg --country-code NL

Omettez --country-code pour obtenir tous les pays pertinents pour l'expéditeur. Un résultat filtré vide signifie que l'expéditeur n'a aucune route vers ce pays.

Lisez six champs sur une ligne avant d'envoyer :

registration_mode vaut none, optional ou required. none ne nécessite aucun enregistrement par pays. Associé à un identifiant d'expéditeur overwritten, l'enregistrement est indisponible. Des enregistrements explicites plus anciens peuvent encore être enregistrés pour les politiques none avec un comportement unknown ou preserved, mais ils ne conditionnent jamais l'envoi. optional permet à l'expéditeur de continuer à envoyer pendant que vous l'enregistrez. required bloque l'envoi jusqu'à l'approbation.
program identifie le flux d'enregistrement lorsque le pays en désigne un, comme alpha ou numeric. Il peut valoir null si aucun programme nommé ne s'applique.
sender_id_behavior vaut unknown, preserved ou overwritten. Il est indépendant de registration_mode : un enregistrement obligatoire peut tout de même laisser l'identifiant d'expéditeur écrasé après approbation. Un enregistrement facultatif indique overwritten avant approbation et preserved après approbation pour les catégories de messages approuvées.
status indique où en est l'expéditeur vis-à-vis du programme d'enregistrement du pays. En mode required, l'envoi attend approved. En mode optional, le statut suit le travail d'enregistrement mais ne bloque pas l'envoi. Statuts d'enregistrement liste chaque valeur.
destination_enabled indique si votre espace de travail a activé ce pays. C'est un paramètre de l'espace de travail et non de l'expéditeur, et il est vérifié en premier : un enregistrement entièrement approuvé refuse tout de même les messages tant que la destination est désactivée. Activez les pays sous Destinations ; Envoi de SMS couvre la liste d'autorisation.
next liste ce qui fait avancer ce pays, dans l'ordre. Une liste vide signifie que rien n'est en attente. Chaque entrée nomme une action et explique pourquoi elle mérite d'être entreprise : un pays en cours d'examen par l'opérateur nomme la ressource à consulter plutôt que de reformuler un verdict qui appartient à cette ressource.

Les lignes portent aussi timeline_min_days et timeline_max_days, les durées minimale et maximale habituelles d'approbation d'un pays en jours ouvrés, et null lorsque le pays ne publie aucune estimation. Lorsqu'un enregistrement a été refusé, rejection_reason en indique la raison.

Les mêmes informations figurent sur la page de détail de chaque expéditeur dans le tableau de bord, sous forme d'un tableau Destinations avec les colonnes Status, Country et Category. Un pays que vous n'avez ni activé ni enregistré est exclu de ce tableau, car rien n'y est en attente.

Enregistrer un expéditeur pour un pays

L'enregistrement est par pays, et l'appel prend l'expéditeur et le pays ensemble :

Exemple de code

bird sms senders registrations create snd_01krdgeqcxet5s7t44vh8rt9mg --country-code NL
bird sms senders registrations create snd_01krdgeqcxet5s7t44vh8rt9mg --country-code NL --category marketing

--category restreint l'enregistrement à transactional, marketing, authentication ou service. Omettez-le pour enregistrer toutes les catégories. Le tableau de bord exécute le même appel depuis le bouton Register sur la ligne pays de l'expéditeur.

La suite dépend du pays. Lorsque le pays examine les enregistrements, l'enregistrement revient pending et rien n'est encore facturé. Lorsque le pays n'examine rien, il est approuvé sur cet appel. Enregistrer un numéro est gratuit ; un expéditeur alphanumérique payant entraîne des frais de mise en service et un abonnement mensuel récurrent, facturés au moment où l'enregistrement est approuvé : un enregistrement soumis à examen est donc créé sans facturation. Ni cet appel ni la lecture des exigences n'affichent de prix, demandez donc au responsable du compte ce que coûte un enregistrement avant de le créer.

Lorsqu'un programme recueille vos réponses sous forme de formulaire, l'enregistrement reste à pending jusqu'à ce que vous le remplissiez. La ligne pays de l'expéditeur propose alors Complete, qui ouvre les questions que le programme pose sur votre activité et vos messages.

Quatre refus à gérer :

Réponse	Signification
402	Le solde du portefeuille ne couvrait pas le montant dû au moment de la facturation. Rechargez-le, puis réessayez.
409	Un enregistrement pour ce pays existe déjà dans un état autre que refusé ou suspendu, y compris un enregistrement encore pending examen. Le statut seul ne détermine pas si l'expéditeur peut envoyer : vérifiez registration_mode, destination_enabled, et si l'enregistrement couvre la catégorie de message.
412	Votre organisation n'a pas satisfait une exigence de vérification d'identité. Complétez-la dans Identity Center, puis réessayez.
422	L'expéditeur est couvert par un programme avec son propre parcours, tel que US 10DLC, la vérification de numéro gratuit ou un numéro court. Voir Programmes avec leur propre parcours.

Un enregistrement refusé est soumis de nouveau, et un enregistrement suspendu est réactivé, en appelant cette même opération plutôt qu'une opération distincte.

Statuts d'enregistrement

Un enregistrement de pays passe par les états ci-dessous. Le tableau de bord affiche chacun sous forme d'un libellé en casse de phrase sur la ligne de l'expéditeur :

Statut	Ce que cela signifie et ce qu'il faut faire
registration_required	Le registration_mode du pays est required et aucun enregistrement n'a été lancé. Enregistrez l'expéditeur pour le pays.
pending	Le travail d'enregistrement a commencé. Si le programme demande un formulaire, complétez-le via Complete sur la ligne du pays.
under_review	Les informations soumises sont en cours d'examen ou nécessitent des modifications. Le champ program_ref de la ligne pointe vers la ressource propre au programme, le seul endroit où un examen en cours se distingue d'un examen qui attend votre intervention.
bird_approved	L'examen de Bird est passé et l'approbation par l'opérateur est en attente. Aucune action n'est requise de votre part.
carrier_pending	Soumis à l'opérateur ou au registre approbateur. Aucune action n'est requise de votre part.
approved	Enregistrement approuvé.
rejected	L'enregistrement a été refusé. Consultez rejection_reason, corrigez-le et enregistrez à nouveau via Resubmit.
suspended	Un enregistrement précédemment actif est suspendu. Enregistrez à nouveau via Register again pour le réactiver.
not_required	Aucun enregistrement actif ne conditionne l'envoi. Vérifiez registration_mode et sender_id_behavior : none ne nécessite aucun enregistrement par pays et le rend indisponible lorsque l'identifiant d'expéditeur est écrasé ; optional propose l'enregistrement sans bloquer le trafic.

De nouveaux statuts sont ajoutés à mesure que les programmes d'enregistrement évoluent : traitez une valeur inconnue comme un cas que votre code ne gère pas encore plutôt que comme une erreur, et lisez le next de la ligne pour savoir quoi faire pour ce pays.

Certains programmes couvrent plusieurs pays avec un seul enregistrement : une même vérification de numéro gratuit ou un même enregistrement de campagne peut être ce qui autorise plusieurs destinations.

Statut de l'expéditeur et actions suivantes

Le status propre d'un expéditeur couvre ce que l'expéditeur détient, ce qui est une question différente de savoir si un pays donné acceptera un message :

active : rien de ce que cet expéditeur détient n'est en attente. Un expéditeur qui n'est enregistré nulle part affiche active, même si chaque pays qu'il peut atteindre exige un enregistrement.
pending_number_ownership : les documents prouvant que vous détenez le numéro de cet expéditeur ne sont pas en place, soit parce qu'ils n'ont pas été fournis, soit parce que le pays qui a émis le numéro ne les a pas encore acceptés. Tout envoi depuis cet expéditeur est refusé tant que la situation n'est pas réglée. Vue d'ensemble des numéros couvre ce cycle de vie.
pending_registrations : l'expéditeur détient des enregistrements de pays et aucun n'est encore approuvé. Cela couvre un enregistrement en cours d'examen et un enregistrement refusé : lisez next pour savoir lequel.

En parallèle, destinations regroupe les pays pour lesquels l'expéditeur est configuré selon à qui revient la prochaine action, et la liste Senders affiche les trois groupes sous forme de colonnes :

"Active" : pays vers lesquels vous pouvez envoyer aujourd'hui, activés dans vos paramètres de destination et ne nécessitant soit aucun enregistrement obligatoire, soit disposant d'un enregistrement approuvé. Un enregistrement facultatif peut encore être en attente alors que l'envoi reste possible avec l'identifiant d'expéditeur écrasé.
"Pending" : pays dont l'enregistrement est en cours et en attente de Bird ou d'un opérateur. Rien ne vous est demandé ; ils passent à "Active" une fois approuvés.
"Needs attention" : pays pour lesquels vous avez un enregistrement qui ne fonctionne pas et qui sont en attente de votre action, parce que l'enregistrement a été refusé ou retiré, ou parce qu'il est approuvé alors que la destination est désactivée.

Ces trois groupes ne couvrent que les pays pour lesquels vous détenez un enregistrement : un pays que vous pourriez enregistrer mais ne l'avez pas fait n'apparaît dans aucun d'eux. Pour tout ce que l'expéditeur peut atteindre et ce que chaque pays exigerait, consultez ce qu'un pays exige.

Une lecture d'expéditeur qui calcule les actions suivantes les renvoie dans next, le même champ de routage que portent les lignes d'exigences. Un expéditeur ne connaît que lui-même, donc lorsque le travail est par pays, il nomme la lecture des exigences au lieu de deviner quel pays vous visiez.

Programmes ayant leur propre parcours

Le program d'un pays nomme le programme d'enregistrement qu'il applique à un type d'expéditeur. Deux d'entre eux sont traités par l'appel d'enregistrement de ce guide, et trois ont leur propre parcours :

Programme	Ce à quoi il s'applique	Où cela se passe
alpha	un identifiant d'expéditeur alphanumérique	Enregistrer un expéditeur pour un pays, plus le formulaire que le pays demande
numeric	un numéro long	Enregistrer un expéditeur pour un pays, plus le formulaire que le pays demande
10dlc	un numéro long américain	Enregistrer une marque et une campagne, puis lier le numéro : 10DLC registration
tfn	un numéro gratuit américain	Vérification de numéro gratuit, sur la page Toll-free verifications
ctia_short_code	un numéro court américain	Bird gère la demande ; aucune action ne vous est demandée

Appeler l'opération d'enregistrement pour un expéditeur couvert par 10dlc, tfn ou ctia_short_code renvoie 422. Utilisez le programme correspondant.

La vérification de numéro gratuit commence par un brouillon que vous remplissez en une ou plusieurs mises à jour, puis soumettez à l'opérateur pour examen. Elle passe par draft, submitted, under_review, info_requested, approved et rejected. Une vérification à info_requested peut être modifiée et soumise de nouveau ; une vérification refusée peut être soumise de nouveau tant que la fenêtre de nouvelle soumission est ouverte. La soumission transmet le dossier à l'opérateur pour examen : une personne autorise donc cette étape. Le CLI et le serveur MCP de Bird peuvent créer un brouillon et corriger une vérification, et la soumission elle-même se fait dans le tableau de bord.

Cesser d'envoyer depuis un expéditeur

Trois opérations de retrait diffèrent par ce qu'elles conservent, et toutes trois sont des actions du tableau de bord sur la page de détail de l'expéditeur. Les frais de mise en service déjà facturés ne sont remboursés par aucune d'elles :

Action	Ce qu'elle fait
Deregister un pays	Annule l'abonnement récurrent et conserve l'enregistrement. Enregistrer de nouveau ce pays reprend le même enregistrement sans payer les frais de mise en service une deuxième fois. Si le pays exige un enregistrement, les envois cessent ; si l'enregistrement est optionnel, les envois continuent, car l'enregistrement ne les conditionnait pas.
Remove un enregistrement	Supprime entièrement l'enregistrement du pays, annule l'abonnement récurrent et cesse de lister la destination pour l'expéditeur. Enregistrer de nouveau le pays crée un nouvel enregistrement et facture les frais de mise en service une nouvelle fois.
Supprimer l'expéditeur	Libère un expéditeur alphanumérique. Tous les enregistrements de pays associés sont supprimés, l'abonnement récurrent est annulé et l'expéditeur cesse d'être utilisable. Revendiquer la même chaîne ultérieurement crée un nouvel expéditeur avec de nouveaux enregistrements, et facture les frais de mise en service une deuxième fois.

Un expéditeur adossé à un numéro n'est pas supprimé ici : libérez plutôt le numéro dédié, ce qui démonte son expéditeur avec lui. Un expéditeur sur un numéro partagé géré par Bird ne peut pas être supprimé.

Une ligne 10DLC ou de numéro gratuit est annulée via son propre programme, en déliant la campagne ou en annulant la vérification, plutôt qu'en désenregistrant.

Étapes suivantes

Comparez les numéros et identifiants d'expéditeur SMS, ou consultez l'enregistrement d'expéditeur pour votre déploiement.

Page	Ce qu'elle couvre
Envoi de SMS	L'appel d'envoi, les formats from qu'il accepte et la liste d'autorisation des destinations
10DLC registration	Le modèle marque, campagne et numéro derrière l'envoi A2P aux États-Unis
Types de numéros	Choisir entre numéros mobiles, locaux, nationaux, gratuits et courts
Destinations SMS	Quels types d'expéditeur chaque pays accepte et lesquels nécessitent un enregistrement
Désinscriptions et mots-clés	Les réponses par mot-clé qu'un expéditeur doit respecter et les suppressions qu'elles créent

Ressources associées

Poursuivez avec la documentation, les guides et les exemples sur ce sujet. Les ressources sont en anglais.

Regarder le guideRegistering your SMS sender ID Comprendre le conceptWhat is sender ID registration, and why do some countries require it?Suivre le parcours d'apprentissageBuild your first integration

Obtenir un guide d'implémentation