Voice – Übersicht

Mit Bird Voice können Sie Telefonnummern anrufen und Anrufe an Nummern annehmen, die Sie besitzen. Verbinden Sie eine Telefonanlage über SIP, tätigen Sie einen Browser-Anruf oder führen Sie mit dem Sequenz-Builder einen gespeicherten Anrufablauf aus. Bird verbindet Anrufe mit dem öffentlichen Telefonnetz, dem PSTN.

Die Verbindung zwischen Ihrer Telefonanlage und Bird ist ein SIP-Trunk. SIP (Session Initiation Protocol) baut Anrufe zwischen Telefonanlagen auf. Bird gibt Ihrem Workspace eine Trunk-Adresse, die Ihre Telefonanlage für ausgehende Anrufe in das Telefonnetz nutzt und die Bird umgekehrt verwendet, um eingehende Anrufe auf Ihren Nummern zuzustellen.

Sie brauchen keine Telefonanlage für den ersten Anruf: Das Phone im Dashboard startet einen Anruf direkt aus dem Browser über einen Ihrer Trunks.

Sie können auch im Dashboard eine Sequenz erstellen und sie mit der Create Call API starten. Die Sequenz übernimmt Ansagen, Tasteneingaben und die Anrufweiterleitung, nachdem der Empfänger abgenommen hat.

Wie ein Anruf aufgebaut wird

Ihre Telefonanlage sendet ein SIP-INVITE an die Trunk-Adresse, um einen Anruf zu starten. Bird prüft die Anrufer-ID, das Zielland, die Limits und das Wallet-Guthaben, bevor ein Carrier kontaktiert wird. Wenn der Anruf die Prüfung besteht, leitet Bird ihn weiter und überträgt das Audio. Jede Verbindung ist ein Leg. Wenn ein Leg endet, schreibt Bird den Datensatz unter Voice > Legs und löst ein voice_call.ended-Event aus.

Ein Anruf, der eine Prüfung nicht besteht, wird abgelehnt, bevor ein Carrier involviert ist, und der genaue Grund wird im Leg-Datensatz vermerkt. Anrufe tätigen beschreibt, was Bird aus jedem Anruf ausliest, und Abgelehnte Anrufe listet jeden Ablehnungsgrund und die passende Maßnahme auf.

Wie ein eingehender Anruf beantwortet wird

Eine Nummer in Ihrem Workspace hat immer genau eine Antwort. Diese ist entweder auf der Nummer selbst festgelegt oder wird, wenn dort keine hinterlegt ist, von der Standardroute Ihres Workspace übernommen: den Anruf an einen Ihrer SIP-Trunks zustellen, ihn an eine verifizierte Nummer weiterleiten, eine veröffentlichte Sequenz ausführen, eine Ring Group mit Personen klingeln lassen, die im Browser-Telefon online sind, oder ihn ablehnen. Die Standardroute steht anfangs auf Ablehnung, sodass eine nicht konfigurierte Nummer Anrufer abweist.

Wenn ein Anruf eingeht, prüft Bird die Kontolimits und das Wallet genauso wie bei einem ausgehenden Anruf. Dann führt es die an der Nummer hinterlegte Antwort aus und hält im Anrufdatensatz fest, welche Antwort angewendet wurde. Anrufe empfangen beschreibt, wie Sie eine Nummer auf eine Antwort richten, was eine Weiterleitung dem Empfänger anzeigt und wie Sie eine Ablehnung lesen.

Vor Ihrem ersten Anruf

Bereiten Sie für Anrufe über Ihre eigene SIP-Ausrüstung Folgendes vor. Für API-Anrufe gelten die Create Call-Voraussetzungen.

• Erstellen Sie einen SIP-Trunk, aktivieren Sie ausgehende Anrufe und legen Sie fest, wer darüber anrufen darf: mit einem IP-Bereich oder einem API-Schlüssel für Ihre eigene Ausrüstung, mit Sitzungszugangsdaten für einen Browser oder die CLI.
• Wählen Sie eine zulässige Anrufer-ID: Verwenden Sie eine Nummer, die Ihr Workspace über Bird besitzt, oder registrieren Sie eine externe Nummer und bestätigen Sie sie mit einem Verifizierungsanruf.
• Aktivieren Sie Ihre Ziele: Schalten Sie die Länder frei, die Sie anrufen.

Ihren ersten Anruf tätigen führt Sie durch alle drei Voraussetzungen und endet mit einem echten Anruf.

Das Lesen von Anrufdatensätzen erfordert voice:read; das Tätigen von Anrufen erfordert voice:write. Die Verwaltung von Trunks, Nummernrouten, Anrufer-IDs und Sequenzen nutzt voice_management-Berechtigungen. Der Zugriff auf eine Seite gewährt weder die Berechtigung, deren Einstellungen zu ändern, noch einen kostenpflichtigen Anruf zu tätigen.

Die Voice-App im Dashboard

Sichtbarkeit

Ein Anruf kann mehrere Legs enthalten. Das Protokoll hat einen Datensatz pro Leg, egal ob die Verbindung zustande kam, unbeantwortet blieb oder abgelehnt wurde. Weitergeleitete oder Mehrparteien-Anrufe können daher mehrere Einträge haben:

• Leg-Protokoll: die Ansicht der einzelnen Legs auf der Seite Legs. Sie zeigt den Status, beide Nummern, den Trunk, über den das Leg einging, die abschließende SIP-Antwort, Annahme- und Endzeit, die abrechenbare Zeit und die Kosten. Filtern Sie die Ansicht und exportieren Sie dann die passenden Datensätze als CSV. Die CSV enthält die Dauer und die abrechenbare Zeit, aber keine Kostenspalte. Prüfen Sie die Gebühren unter Nutzung, Ausgaben und Rechnungen.
• Voice-Events: voice_call.initiated, voice_call.answered und voice_call.ended, die an Ihren eigenen Endpoint geliefert werden, sodass Ihre Systeme über einen Anruf informiert werden, ohne abfragen zu müssen.

Die API-Referenz listet die unterstützten öffentlichen HTTP-Contracts und SDK-Methoden auf. Die CLI-Referenz und die MCP-Tool-Referenz beschreiben ihre veröffentlichten Operationen. Diese Oberflächen können unterschiedliche Operationen bereitstellen; eine Dashboard-Aktion oder ein CLI-Befehl begründet allein noch keine öffentliche SDK-Methode.

Grenzwerte

Für Ihre Anrufe gelten in beiden Richtungen drei Obergrenzen: wie viele Anrufe gleichzeitig laufen dürfen, wie viele neue Anrufe pro Sekunde zulässig sind und wie viel Sie an einem UTC-Tag für Voice ausgeben dürfen. Ihr Voice-Tarif legt die Obergrenzen für gleichzeitige Anrufe und neue Anrufe pro Sekunde für Ihre Organisation fest. Bei nutzungsbasierter Abrechnung gelten die Standardwerte; höhere Voice-Tarife erhöhen diese Werte. Das tägliche Ausgabenlimit funktioniert anders. Jeder Workspace legt sein eigenes Limit unter Voice > Spend limit und je Land unter Voice > Destinations fest, höchstens jedoch bis zum Maximalwert Ihrer Organisation. Die größten Voice-Tarife erhöhen diesen Maximalwert. Überschreitet ein Anruf eine dieser Grenzen, wird er beim Verbindungsaufbau abgelehnt. Sein Datensatz nennt die überschrittene Grenze; die Gründe finden Sie unter Abgelehnte Anrufe. Die Werte der einzelnen Tarife stehen auf der Voice-Preisseite. Wechseln Sie unter Billing and payments > Overview zu einem höheren Tarif.

Die Plattform begrenzt die Anrufdauer auf 4 Stunden. Bird trennt beide Seiten eines Anrufs, der diese Dauer erreicht. Planen Sie eine längere Sitzung daher als mehrere Anrufe. Bei einem Anruf, der eine Anrufsequenz ausführt, beginnt die Zeitmessung, sobald Bird ihn angenommen oder empfangen hat. Wartezeiten vor dem Wählen und Klingelzeiten verbrauchen daher einen Teil der 4 Stunden. Unter Status wird erklärt, wie ein solcher Anruf im Protokoll erscheint.

Die Pro-Sekunde-Obergrenze ist die voice_call-Richtlinie unter Begrenzung der Anfragerate. Dort wird auch erklärt, wie Ihr effektives Limit ermittelt wird und wie Sie es erhöhen.

Nächste Schritte