# 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**](https://bird.com/dashboard/w/sms/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](/docs/guides/sms/sending-sms#sender). ## 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](/docs/guides/sms/10dlc). - **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](/docs/guides/numbers/number-types) explique comment le type propre d'un numéro est choisi, et [Acheter et libérer un numéro](/docs/guides/numbers/buying-numbers) 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](/products/sms/destinations) 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**](https://bird.com/dashboard/w/sms/senders), ouvrez **Add sender** et choisissez **Add sender ID**, puis saisissez la chaîne. Via API : ```cli 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**](https://bird.com/dashboard/w/trust), 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 : ```cli 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](#statuts-denregistrement) 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**](https://bird.com/dashboard/w/sms/destinations) ; [Envoi de SMS](/docs/guides/sms/sending-sms#before-you-send-enable-the-destination-country) 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 : ```cli 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**](https://bird.com/dashboard/w/trust), 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](#programmes-ayant-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](/docs/guides/numbers/overview#the-status-of-an-allocated-number) 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**](https://bird.com/dashboard/w/sms/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](#vérifier-ce-quun-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](#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](#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](/docs/guides/sms/10dlc) | | `tfn` | un numéro gratuit américain | Vérification de numéro gratuit, sur la page [**Toll-free verifications**](https://bird.com/dashboard/w/sms/tfn-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](/products/sms/numbers), ou consultez [l'enregistrement d'expéditeur](/products/sms/compliance/sender-id-registration) pour votre déploiement. | Page | Ce qu'elle couvre | | ---------------------------------------------------------------------- | --------------------------------------------------------------------------------------------- | | [Envoi de SMS](/docs/guides/sms/sending-sms) | L'appel d'envoi, les formats `from` qu'il accepte et la liste d'autorisation des destinations | | [10DLC registration](/docs/guides/sms/10dlc) | Le modèle marque, campagne et numéro derrière l'envoi A2P aux États-Unis | | [Types de numéros](/docs/guides/numbers/number-types) | Choisir entre numéros mobiles, locaux, nationaux, gratuits et courts | | [Destinations SMS](/products/sms/destinations) | Quels types d'expéditeur chaque pays accepte et lesquels nécessitent un enregistrement | | [Désinscriptions et mots-clés](/docs/guides/sms/opt-outs-and-keywords) | Les réponses par mot-clé qu'un expéditeur doit respecter et les suppressions qu'elles créent | ## Related resources - [Registering your SMS sender ID](/learn/sms/registering-your-sms-sender-id) (video) - [What is sender ID registration, and why do some countries require it?](/explained/sms/what-is-sender-id-registration) (answer) - [Build your first integration](/learn/paths/integration) (course) [Get an implementation brief](/learn/workspace?topic=sms-senders)