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

Für eine Nummer in Ihrem Workspace ist jeweils eine Aktion für eingehende Anrufe festgelegt: den Anruf an einen Ihrer SIP-Trunks zustellen, an eine verifizierte Nummer weiterleiten, eine veröffentlichte Sequenz ausführen oder ablehnen. Jede neue Nummer lehnt Anrufe zunächst ab. Solange sie nicht konfiguriert ist, werden Anrufer daher abgewiesen.

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.

Einen SIP-Trunk erstellen, ausgehende Anrufe aktivieren und Anrufer zulassen: einen IP-Bereich oder einen API-Schlüssel für Ihre eigene Anlage, Session-Credentials für einen Browser oder das CLI.
Eine geeignete Anrufer-ID wählen: Verwenden Sie eine Nummer, die Ihr Workspace über Bird hält, oder registrieren Sie eine externe Nummer und bestätigen Sie sie mit einem Verifizierungsanruf.
Ihre Ziele aktivieren: Schalten Sie die Länder frei, die Sie anrufen möchten.

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

Seite	Wofür sie da ist
Metrics	Anrufvolumen und Annahmequote im Zeitverlauf, Anrufergebnisse, Top-Länder sowie die Aufteilung in eingehend und ausgehend. Siehe Voice-Metriken
Legs	Leg-Datensätze für Workspace-Anrufe, mit Nutzungssummen für den Monat
Calls	Zusammengehörige Legs und Teilnehmer, zu einem Anruf gruppiert
Numbers	Jede Nummer, die der Workspace für Voice nutzen kann, und was sie mit einem eingehenden Anruf tut
SIP Trunks	Ihre Trunks, ihre SIP-Domain, wer Traffic an sie senden darf und wohin eingehende Anrufe zugestellt werden
Destinations	Die Länder, die Ihr Workspace anrufen darf – standardmäßig deaktiviert
Sequences	Anrufabläufe erstellen, in der Vorschau prüfen, veröffentlichen und ihre Ausführungen untersuchen
Phone	Ein schwebendes Telefon, das Anrufe direkt aus dem Browser über einen Ihrer Trunks tätigt

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 pro Leg auf der Legs-Seite. Status, beide Nummern, der Trunk, über den das Leg eingegangen ist, die SIP-Antwort, mit der es endete, Annahme- und Endzeit, abrechenbare Zeit und Kosten. Filtern Sie die Einträge und exportieren Sie das Ergebnis als CSV.
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

Drei Obergrenzen gelten für Ihre Anrufe in beide Richtungen: wie viele gleichzeitig aktiv sein dürfen, wie viele neue Anrufe pro Sekunde und wie viel Sie an einem UTC-Tag für Voice ausgeben dürfen. Jede wird pro Organisation festgelegt, und die Werte hängen von Ihrem Tarif ab. Ein Anruf, der eine davon überschreitet, wird beim Aufbau abgelehnt, und der Datensatz nennt die betroffene Obergrenze unter Abgelehnte Anrufe.

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 mehr Kapazität anfordern.

Nächste Schritte

Seite	Was sie behandelt
Ihren ersten Anruf tätigen	Von einem leeren Workspace bis zum klingelnden Telefon
Phone	Anrufe aus dem Dashboard, was dafür nötig ist und was Sie während eines Anrufs tun können
SIP-Trunks	Einen Trunk erstellen, seine Verbindungsdetails und steuern, wer senden darf
Anrufe tätigen	Was Bird auf dem INVITE erwartet und was ein Anruf kostet
Anrufe empfangen	Eine Nummer auf einen Trunk oder eine Weiterleitung richten und was dabei aufgezeichnet wird
Anrufer-IDs	Eine Nummer registrieren und mit einem Verifizierungsanruf nachweisen, dass sie Ihnen gehört
Voice-Ziele	Länder freischalten, die Sie anrufen, und was hohes Risiko bedeutet
Leg-Protokoll	Leg-Datensätze durchsuchen, filtern und exportieren
Voice-Events	Die drei Anruf-Events und ihre Payloads
Fehlerbehebung	Einen nicht durchgestellten Anruf anhand seines Symptoms diagnostizieren
Webhooks & Events	Endpoint-Einrichtung, Signaturprüfung, Wiederholungsversuche und Replay

Verwandte Ressourcen