Caller IDs

Eine Caller ID ist eine Nummer, die Ihr Workspace bei einem ausgehenden Anruf präsentieren kann. Bird prüft bei jedem Anruf den SIP-Header From gegen die Bird-Nummern, die dieser Workspace präsentieren darf, und seine verifizierten externen Nummern. Anrufe mit einer nicht zulässigen Nummer werden abgelehnt.

Verwalten Sie Caller IDs unter Voice > Numbers. Dort sind alle Nummern aufgelistet, die Ihr Workspace für Voice nutzen kann. Eine bei uns gekaufte Nummer und eine verifizierte Nummer erscheinen in derselben Liste, eine Zeile pro Nummer. Eine Nummer, die beides ist, erscheint einmal. Eine bei uns gekaufte Nummer ist sofort einsetzbar, ohne Verifizierungsanruf: Der Besitz der Nummer ist der Nachweis. Die folgende Anleitung gilt für eine Nummer, die Sie anderswo besitzen.

Jede Zeile zeigt den Namen, die Nummer und ihr Land, ihren Provider, die unterstützten Anrufrichtungen und ihren Verwendungszweck. Eine Nummer, die auf ihren Code wartet, zeigt Verifying; ist der Code abgelaufen oder sind die Versuche aufgebraucht, zeigt sie Failed. Jede Seite enthält bis zu 25 Nummern. Wählen Sie eine Zeile, um die Detailseite der Nummer zu öffnen.

Nummer registrieren

1. Wählen Sie Add number > Verify a number you own.
2. Geben Sie die Nummer im E.164-Format ein: ein führendes +, Ländervorwahl und nationale Nummer. Eine Nummer kann in Ihrem Workspace nur einmal registriert werden.
3. Speichern Sie die Eingabe. Ein Verifizierungsanruf wird sofort an die Nummer gesendet.
4. Nehmen Sie den Anruf entgegen und hören Sie sich den sechsstelligen Code an.
5. Geben Sie den Code im Dashboard ein. Sie haben fünf Versuche; ein akzeptierter Code ändert den Status auf Verified.

Die Caller-ID-Verifizierung berechnet Ihrem Workspace den Verifizierungsanruf nicht. Die Registrierung erfordert weiterhin die Voice-Management-Berechtigung und die Freigabe des Kontos zur Registrierung verifizierter Nummern. Benennen Sie die Nummer anschließend auf ihrer Detailseite. Siehe Nummer benennen.

Prüfen Sie nach der Verifizierung das Land, das Sie anrufen möchten, unter Voice > Destinations. Die Verifizierung versucht, das Land der verifizierten Nummer zu aktivieren, aber nicht verfügbare Länder oder ein fehlgeschlagenes Einstellungs-Update können es deaktiviert lassen. Eine verifizierte Caller ID und ein aktiviertes Zielland sind separate Voraussetzungen.

Über die API registrieren und verifizieren

Registrieren Sie eine Nummer, um ihren Verifizierungsanruf zu starten, und senden Sie dann den Code für die ID, die die Registrierung zurückgibt. Listen Sie Ihre Caller IDs auf, um eine im Dashboard registrierte Nummer zu finden. Sie können eine Caller ID auch umbenennen oder löschen. Lesezugriffe erfordern voice_management:read; Registrierung, Verifizierung, Umbenennung und Löschung erfordern voice_management:write. Die API-Referenz enthält Beispiele für SDK, die Bird-Befehlszeile und MCP.

Wenn der ursprüngliche Verifizierungsanruf nicht gestartet werden konnte, kann das Senden des Codes einen weiteren Anruf an die registrierte Nummer starten. Ihre Organisation muss weiterhin die Registrierungsvoraussetzungen erfüllen. Wenn der Code abläuft oder die Versuche aufgebraucht sind, löschen Sie die Caller ID und registrieren Sie die Nummer erneut. Dadurch wird ein neuer Verifizierungsanruf ausgelöst; senden Sie den neuen Code dann für die ID, die diese Registrierung zurückgibt. Wenn der Code akzeptiert wird, die Aktivierung aber 412 oder 503 zurückgibt, ist der Besitz trotzdem nachgewiesen und die Caller ID zeigt verified mit outbound_enabled: false. Ein 412 bedeutet, dass die Identitätsverifizierung unvollständig ist, die Sie im Dashboard abschließen, oder eine Eignungsprüfung oder Ablehnung, für die der Support nötig ist. Ein 503 bedeutet, dass die Eignungsbewertung noch aussteht oder nicht verfügbar ist; versuchen Sie es später erneut. Senden Sie danach eine leere Verifizierungsanfrage für dieselbe ID; löschen und registrieren Sie sie nicht erneut.

Prüfen Sie nach der Verifizierung Ihre Voice-Zielländer und aktivieren Sie das Land der Nummer, sofern dies unterstützt wird und erforderlich ist. Die Verifizierung versucht, es zu aktivieren. Auch nach erfolgreicher Caller-ID-Verifizierung kann das Zielland jedoch deaktiviert bleiben und ausgehende Anrufe in dieses Land können weiterhin gesperrt sein.

Nur eine Verifizierung gleichzeitig

Die Registrierung kann E21036 zurückgeben, wenn der Verifizierungsanbieter bereits eine Challenge für diese Nummer hat, die zu einem anderen Workspace oder Zweck gehört. Warten Sie, bis diese Verifizierung abgeschlossen oder abgelaufen ist, und registrieren Sie die Nummer dann erneut. Ein Nachweis, der für einen anderen Workspace erbracht wurde, verifiziert die Nummer nicht in Ihrem.

Dieselbe Ablehnung gilt für eine Nummer, die aus einem anderen Grund belegt ist: ein Login-Code oder eine Trust-Hub-Verifizierung, die bereits an sie unterwegs ist. Wenn kein anderer Workspace die Nummer verifiziert, ist das in der Regel der Grund, und die Wartezeit ist dieselbe.

Eine Verifizierung, die anderswo bereits abgeschlossen ist, blockiert Sie nicht: Dieselbe Nummer kann in mehr als einem Workspace eine verifizierte Caller ID sein, und jeder Workspace weist den Besitz separat nach.

Status

Get a new code registriert die Nummer erneut und ruft sie mit einem neuen Code an. Falls der erste Anruf nie ankam und die Nummer noch auf die Verifizierung wartet, entfernen Sie die Caller ID und fügen Sie die Nummer erneut hinzu.

Wenn Sie diese Werte mit eigenen Tools auslesen, prüfen Sie die Ihnen bekannten und behandeln Sie jeden anderen als einen Status, den Sie nicht verarbeiten, nicht als Fehler.

CLI-Verifizierung und Zustellungshinweis

Bird führt eine CLI-Verifizierung (Calling Line Identification) durch, um zu bestätigen, dass eine A-Nummer gültig und zur Nutzung autorisiert ist, bevor ausgehende Anrufe über die Plattform getätigt werden können. Diese Verifizierung stellt sicher, dass die Nummer legitim ist und unter der Kontrolle des Kunden steht.

Die Verifizierung garantiert jedoch nicht die durchgehende Zustellung der CLI oder den Verbindungsaufbau des Anrufs, wenn die CLI keine über Bird beschaffte Nummer ist. Nachgelagerte Carrier und internationale Betreiber wenden eigene nationale Vorschriften und Verkehrsrichtlinien an, die außerhalb der Kontrolle von Bird liegen. Dazu können gehören:

• Anti-Spoofing- und Caller-ID-Authentifizierungs-Frameworks (z. B. STIR/SHAKEN in den USA, CLI-Richtlinien von Ofcom im Vereinigten Königreich)
• Anforderungen, dass die CLI eine lokal registrierte oder nationale Nummer sein muss
• Spam- und Betrugsfilter der terminierenden Betreiber
• Einschränkungen bei bestimmten Verkehrskategorien wie Glücksspiel, Finanzwerbung, Inkasso oder politische Nachrichten
• Blockierung internationaler Anrufe, die eine inländische CLI präsentieren ("origin-based"-Beschränkungen)
• Do-not-originate-Listen und behördlich angeordnete Sperrungen

Aus diesen Gründen kann Bird eine CLI verifizieren, aber nicht garantieren, dass (1) die CLI erhalten bleibt und dem Angerufenen angezeigt wird oder (2) der Anruf über nationale Trunks oder internationale Tier-1-Partner und -Betreiber verbunden wird. Um die Zustellrate der CLI und die Verbindungsrate zu maximieren, empfehlen wir die Nutzung von Nummern, die über Bird beschafft wurden und gemäß den lokalen regulatorischen Anforderungen provisioniert und geroutet werden.

Nummer benennen

Ein Name kennzeichnet die Nummer im Dashboard und in der Call from-Liste des Dialers. Er wird nicht mit dem Anruf übertragen.

Wählen Sie die Nummer in der Numbers-Liste, um ihre Detailseite zu öffnen, setzen Sie Name und speichern Sie. Lassen Sie das Feld leer, um nur die Nummer anzuzeigen. Die Benennung funktioniert bei jedem Status und ändert weder die Nummer noch deren Verifizierung.

Nummer verifizieren, die Sie nicht entgegennehmen können

Jemand muss den Verifizierungsanruf entgegennehmen und den Code anhören. Wenn die Nummer normalerweise ein unbesetztes System erreicht, leiten Sie sie vorübergehend auf ein Telefon um, das Sie erreichen können, und stellen Sie sie danach zurück. Kontaktieren Sie den Support, wenn die Nummer keine Anrufe empfangen kann.

Caller ID entfernen

Verwenden Sie Remove caller ID in der Zeile der Nummer. Das Entfernen der Verifizierung entzieht diesen Nachweis für neue Anrufe. Eine Nummer, die Ihr Workspace über Bird hält, kann durch ihre Zuweisung weiterhin berechtigt bleiben; eine externe Nummer, die ihren Nachweis verliert, wird mit caller_id_not_verified abgelehnt. Bereits laufende Anrufe werden fortgesetzt, und bestehende Anrufprotokolle ändern sich nicht.

Nächste Schritte