# Présentation des numéros Un numéro de téléphone est l'origine de vos messages et de vos appels. Bird vend des numéros dans les pays qu'il couvre, et un numéro attribué à votre espace de travail peut transporter des SMS, des MMS ou de la voix selon ce que le numéro prend en charge. La page [**Numbers**](https://bird.com/dashboard/w/numbers) du tableau de bord affiche les numéros qui vous sont attribués, et le même cycle de vie est disponible via la API : rechercher ce qui est en vente, en commander un, consulter ce que vous avez, et libérer ce dont vous n'avez plus besoin. ## Numéros dédiés et partagés Chaque numéro qui vous est attribué possède un `kind`, et c'est lui qui détermine ce que vous pouvez faire avec le numéro. Un numéro `dedicated` appartient exclusivement à votre espace de travail. Vous l'avez acheté, vous êtes facturé mensuellement pour celui-ci, et vous pouvez le libérer quand vous avez terminé. C'est ce que vous obtenez en commandant un numéro. Un numéro `shared` est un numéro court sur l'infrastructure gérée par Bird. Vous en recevez l'usage plutôt que de l'acheter, il n'y a donc pas de frais mensuels à votre charge et vous ne pouvez pas le libérer. Toute tentative de libération échoue avec [`E14002`](/docs/api/errors/E14002). ## Ce qu'un numéro peut transporter Deux champs décrivent ce qu'est un numéro, et ils répondent à des questions différentes. `number_type` est le type physique du numéro : `mobile`, `local`, `national`, `toll_free`, ou un numéro court. Il détermine le comportement du numéro sur le réseau et, dans plusieurs pays, les formalités administratives nécessaires. `capabilities` est ce que le numéro peut réellement faire : `sms`, `mms`, `voice`, ou une combinaison. Un numéro qui inclut `voice` peut transporter des appels ; un numéro qui ne l'inclut pas ne le peut pas. Filtrez une recherche par capacité quand vous en avez besoin d'une en particulier, et vérifiez le champ avant de construire quoi que ce soit sur un numéro que vous possédez déjà. Un numéro attribué ne suffit pas toujours pour envoyer depuis celui-ci. Certains pays de destination exigent également un enregistrement approuvé pour l'expéditeur, qui est une approbation distincte du numéro lui-même. ## Le statut d'un numéro attribué `status` indique si un numéro peut transporter du trafic. `active` signifie que le numéro vous est attribué et utilisable. `pending_ownership_registration` signifie que le numéro vous est attribué et facturé, mais qu'un pays exige des documents de propriété qui n'ont pas encore été acceptés. Le champ `ownership` indique ce qui reste en suspens et quel appel le fait avancer. La plupart des numéros n'entrent jamais dans cet état, car la plupart des pays ne demandent rien : leur `ownership` est `null`. `released` signifie que le numéro ne vous est plus attribué. ## La commande est asynchrone Commander un numéro crée une commande, et c'est la commande que vous suivez. La plupart se terminent dans la requête et renvoient le numéro immédiatement. Une commande qui doit attendre un opérateur revient encore en cours, et vous l'interrogez jusqu'à ce qu'elle atteigne `completed` ou `failed`. Cela compte pour deux raisons. Un numéro n'est à vous qu'une fois sa commande `completed`, donc rien ne doit supposer que le numéro existe avant cela. Et des frais de mise en service déjà facturés ne sont pas remboursés quand une commande échoue, c'est pourquoi la recherche et la commande sont des appels séparés : la recherche vous indique ce qui est disponible avant que vous ne vous engagiez à l'acheter. ## Étapes suivantes - [Acheter et libérer un numéro](/docs/guides/numbers/buying-numbers) décrit le cycle de vie complet via la API. - [Référence API des numéros](/docs/api/reference/list-available-numbers) documente chaque opération et chaque champ. - [Idempotence](/docs/guides/idempotency) explique comment sécuriser une commande réessayée. ## Related resources - [What is a virtual phone number (VMN)?](/explained/numbers/what-is-a-virtual-phone-number) (answer) - [SMS numbers](/sms-api/features/numbers) (product) - [Number types](/docs/guides/numbers/number-types) (docs) [Get an implementation brief](/learn/workspace?topic=phone-numbers)