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 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.

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.

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.

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é.

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.