Nummern – Übersicht

Eine Telefonnummer ist der Absender Ihrer Nachrichten und Anrufe. Bird verkauft Nummern in den abgedeckten Ländern, und eine Ihrem Workspace zugewiesene Nummer kann SMS, MMS oder Sprache übertragen, je nachdem, was die Nummer unterstützt. Die Seite Numbers im Dashboard zeigt die Ihnen zugewiesenen Nummern, und derselbe Lebenszyklus steht über die API zur Verfügung: suchen, was im Angebot ist, eine bestellen, lesen, was Sie haben, und freigeben, was Sie nicht mehr brauchen.

Jede Ihnen zugewiesene Nummer hat einen kind, und dieser bestimmt, was Sie mit der Nummer tun können.

Eine dedicated-Nummer gehört ausschließlich Ihrem Workspace. Sie haben sie gekauft, zahlen eine monatliche Gebühr dafür und können sie freigeben, wenn Sie sie nicht mehr benötigen. Das ist es, was das Bestellen einer Nummer Ihnen gibt.

Eine shared-Nummer ist ein Short Code auf von Bird verwalteter Infrastruktur. Sie erhalten ein Nutzungsrecht, statt sie zu kaufen. Daher fällt keine eigene monatliche Gebühr an, und Sie können sie nicht freigeben. Der Versuch, eine solche Nummer freizugeben, schlägt mit E14002 fehl.

Zwei Felder beschreiben, was eine Nummer ist, und sie beantworten unterschiedliche Fragen.

number_type ist die physische Art der Nummer: mobile, local, national, toll_free oder ein Short Code. Das Feld bestimmt, wie sich die Nummer im Netzwerk verhält und in einigen Ländern, welche Dokumente sie erfordert.

capabilities beschreibt, was die Nummer tatsächlich kann: sms, mms, voice oder eine Kombination. Eine Nummer, die voice auflistet, kann Anrufe übertragen; eine ohne diesen Eintrag nicht. Filtern Sie eine Suche nach Fähigkeit, wenn Sie eine bestimmte benötigen, und prüfen Sie das Feld, bevor Sie auf einer bereits vorhandenen Nummer aufbauen.

Eine zugewiesene Nummer reicht nicht immer aus, um von ihr zu senden. Einige Zielländer verlangen zusätzlich eine genehmigte Registrierung für den Absender, die unabhängig von der Nummer selbst erteilt wird.

status gibt an, ob eine Nummer Verkehr übertragen kann.

active bedeutet, dass die Nummer Ihnen zugewiesen und nutzbar ist.

pending_ownership_registration bedeutet, dass die Nummer Ihnen zugewiesen und abgerechnet wird, ein Land aber Eigentumsnachweise verlangt, die noch nicht akzeptiert wurden. Das Feld ownership gibt an, was noch aussteht und welcher Aufruf den Vorgang weiterbringt. Die meisten Nummern erreichen diesen Status nie, weil die meisten Länder nichts verlangen: Ihr ownership ist null.

released bedeutet, dass die Nummer Ihnen nicht mehr zugewiesen ist.

Das Bestellen einer Nummer erzeugt eine Bestellung, und die Bestellung ist das Objekt, das Sie verfolgen. Die meisten werden innerhalb des Requests abgeschlossen und liefern die Nummer sofort zurück. Eine Bestellung, die auf einen Carrier warten muss, kommt noch laufend zurück, und Sie pollen sie, bis sie completed oder failed erreicht.

Das ist aus zwei Gründen wichtig. Eine Nummer gehört Ihnen erst, wenn ihre Bestellung completed ist, also sollte nichts davon ausgehen, dass die Nummer vorher existiert. Und eine bereits berechnete Einrichtungsgebühr wird bei fehlgeschlagener Bestellung nicht erstattet. Deshalb sind Suche und Bestellung getrennte Aufrufe: Die Suche zeigt Ihnen, was verfügbar ist, bevor Sie sich zum Kauf verpflichten.