# Anrufe empfangen Eine Nummer in Ihrem Workspace kann einen eingehenden Anruf auf drei Arten beantworten: ihn an einen Ihrer SIP-Trunks zustellen, ihn an eine von Ihnen verifizierte Nummer weiterleiten oder ihn ablehnen. Die Antwort ist eine Einstellung auf der Nummer, und eine Nummer hat immer genau eine Antwort gleichzeitig. Jede Nummer startet auf „Ablehnen ## Voraussetzungen Bevor Sie eine Nummer auf eine Antwort richten: - **Eine Nummer, die Anrufe empfangen kann.** Öffnen Sie **Voice** > [**Numbers**](https://bird.com/dashboard/w/voice/numbers) und prüfen Sie die Spalte **Directions** auf eine Inbound-Markierung. Eine Nummer, die Sie als Anrufer-ID eines anderen Anbieters registriert haben, empfängt hier keine Anrufe: Dieser Anbieter leitet die an sie gerichteten Anrufe weiter, daher trägt sie keine Antwort. - **Für die Zustellung an einen Trunk:** ein [SIP-Trunk](/docs/guides/voice/sip-trunks) mit aktiviertem Inbound-Calling und mindestens einem Zustellungs-Gateway. - **Für eine Weiterleitung:** eine [verifizierte Anrufer-ID](/docs/guides/voice/caller-ids), an die weitergeleitet werden soll. - **Um die Einstellung über die API oder CLI zu ändern:** ein API-Schlüssel mit dem Scope `voice_management` auf Schreibebene. Dieser Scope deckt die Voice-Konfiguration ab; der Scope `voice` deckt Anrufverkehr und Statistiken ab, sodass Sie zum Lesen des Anrufprotokolls den anderen benötigen. ## Anrufe an einen SIP-Trunk zustellen Die Zustellung wählt Ihre eigene Telefonanlage unter den Adressen an, die Sie am Trunk angegeben haben. Aktivieren Sie zuerst die Richtung, da eine Nummer nur auf einen Trunk verweisen kann, der bereits eingehende Anrufe akzeptiert. 1. Öffnen Sie **Voice** > [**SIP Trunks**](https://bird.com/dashboard/w/voice/sip-trunks), öffnen Sie den Trunk und wählen Sie unter **Inbound calling** die Option **Enable inbound**. 2. Fügen Sie mindestens ein Gateway im selben Abschnitt hinzu. Ein Trunk ohne Gateway lehnt jeden eingehenden Anruf an die von ihm beantworteten Nummern ab. 3. Öffnen Sie **Voice** > [**Numbers**](https://bird.com/dashboard/w/voice/numbers), öffnen Sie die Nummer und wählen Sie unter **Inbound routing** die Option **Deliver to a SIP trunk**. 4. Wählen Sie den Trunk aus und klicken Sie auf **Save**. In der Liste erscheinen nur Trunks mit aktiviertem Inbound-Calling. Die Spalte **Used for** in der **Numbers**-Liste zeigt die Nummer dann als an diesen Trunk zugestellt an, und die Seite des Trunks listet die Nummern auf, die er beantwortet. ### Was ein Gateway benötigt Ein Gateway ist eine Adresse, an die ein Anruf zugestellt wird, sowie die Art, wie diese Gegenstelle die beiden Rufnummern des Anrufs formatiert haben möchte: | Einstellung | Bedeutung | | ---------------------- | ---------------------------------------------------------------------------------------------------------------------------------------------------- | | **SIP URI** | Der Host Ihrer Telefonanlage mit optionalem Port, z. B. `sip:pbx.example.com:5060`. Geben Sie nur den Host an: Eine URI mit User-Teil wird abgelehnt | | **Priority** | Die Reihenfolge, in der Gateways versucht werden, niedrigster Wert zuerst | | **Destination format** | Wie die gewählte Nummer an diese Gegenstelle übermittelt wird. Standardwert ist E.164 | | **Origination format** | Wie die anrufende Nummer an diese Gegenstelle übermittelt wird, im `P-Asserted-Identity`-Header des zugestellten Anrufs. Standardwert ist E.164 | Gateways mit gleicher Priorität teilen sich die Anrufe gleichmäßig auf, und bei einem bestimmten Anruf kann jedes von ihnen zuerst versucht werden. Um die Zustellung an eine zweite Adresse weiterzuleiten, geben Sie diesem Gateway eine höhere Prioritätsnummer: Es wird versucht, wenn das erste nicht antwortet. Beide Nummernformate sind Templates mit einem Platzhalter, `{number}`, der für die Nummer ohne die vorangestellte `+` steht. Das Zielformat wird vor den SIP-URI-Host gesetzt, sodass `1234#{number}` einen Anruf an `+31201234567` als `sip:1234#31201234567@pbx.example.com:5060` zustellt. Der Standardwert für beide ist `+{number}`, also E.164. Ein Format ohne `{number}` leitet jede Nummer, die der Trunk beantwortet, an eine feste Adresse. > **Warning:** turning inbound calling off on a trunk, or deleting the trunk, puts every number pointing at it back on reject. Turning inbound back on does not restore them, so each number has to be pointed at a trunk again. ## Anrufe an eine andere Nummer weiterleiten Eine Weiterleitung nimmt den eingehenden Anruf an, baut einen zweiten Anruf zu einer von Ihnen verifizierten Nummer auf und verbindet dann beide. 1. Öffnen Sie **Voice** > [**Numbers**](https://bird.com/dashboard/w/voice/numbers), öffnen Sie die Nummer und wählen Sie unter **Inbound routing** die Option **Forward to another number**. 2. Wählen Sie die Nummer aus, an die weitergeleitet werden soll. Die Liste enthält Ihre verifizierten Anrufer-IDs, da eine Weiterleitung nur auf eine Nummer verweisen darf, deren Kontrolle Sie nachgewiesen haben. 3. Wählen Sie, welche Nummer der weitergeleitete Anruf als Anrufer anzeigt, und klicken Sie dann auf **Save**. Das Weiterleitungsziel wird geprüft, wenn Sie es festlegen, und erneut bei jedem Anruf, den es weiterleitet. Eine Anrufer-ID, die Sie später entfernen, stoppt die Weiterleitung, anstatt weiterzuarbeiten, und die eingehenden Anrufe werden ab diesem Zeitpunkt abgelehnt. Der weitergeleitete Anruf klingelt 45 Sekunden, bevor er aufgegeben wird. Das ist länger als bei einer Trunk-Zustellung, weil die Gegenseite in der Regel das Telefon einer Person ist und keine Telefonanlage. Eine Weiterleitung baut einen Anruf auf, daher gelten die Outbound-Regeln für den zweiten Abschnitt: Eine Weiterleitung in ein Land, das Sie unter [Destinations](/docs/guides/voice/destinations) nicht aktiviert haben, wird mit `destination_not_enabled` abgelehnt. ### Eine Weiterleitung, zwei Anrufdatensätze Ein weitergeleiteter Anruf erzeugt zwei Datensätze mit gemeinsamer `session_id`: | Datensatz | Bedeutung | | ------------------------- | ------------------------------------------------------------------------------------------------------------------------------------------------------------------------------- | | Der eingehende Anruf | `direction` ist `inbound`, und `route` gibt an, dass die Nummer auf Weiterleitung gesetzt war, an welche Nummer und welche Nummer der weitergeleitete Abschnitt präsentiert hat | | Der weitergeleitete Anruf | `direction` ist `outbound`, von der Nummer, die der Abschnitt präsentiert hat, an die Nummer, an die Sie weiterleiten. Er trägt keine eigene `route` | Gruppieren Sie sie nach `session_id`, um den gesamten Anruf zu sehen. Der eingehende Datensatz ist derjenige, der angibt, was die Nummer tun sollte. ## Auswählen, welche Nummer ein weitergeleiteter Anruf als Anrufer anzeigt Ein weitergeleiteter Anruf hat zwei Nummern, die er der antwortenden Person präsentieren kann, und die Wahl beeinflusst sowohl, was diese sieht, als auch, wie wahrscheinlich ein Carrier in den Anruf eingreift: - **Calling number** ist die eigene Nummer des Anrufers, sodass das Telefon klingelt, als hätte er direkt gewählt, und der Anruf aus dem Anrufprotokoll zurückgerufen werden kann. Da die Nummer nicht Ihnen gehört, kennzeichnen manche Carrier, am häufigsten in den USA und Teilen Europas, solche Anrufe als nicht verifiziert, ersetzen die Nummer oder filtern sie. - **Dialed number** ist die Nummer, die der Anrufer gewählt hat, also eine Ihrer Nummern. Die antwortende Person sieht, welche Ihrer Nummern angerufen wurde, nicht aber, wer angerufen hat. Es gibt keinen Standardwert. Geben Sie die Wahl bei jeder Weiterleitung an, die Sie über die API oder CLI festlegen. Welche Werte Ihr Workspace setzen darf, ist an der Nummer selbst angegeben, in `forward_as_options` auf ihrem `inbound_configuration`. Die Anzeige der gewählten Nummer erfordert, dass Ihr Workspace für Anrufe von bei uns erworbenen Nummern freigegeben ist, und diese Freigabe ist noch nicht verfügbar, sodass `forward_as_options` nur die anrufende Nummer anbietet und eine Weiterleitung die eigene Nummer des Anrufers präsentiert. Das Setzen der gewählten Nummer wird bis dahin abgelehnt. Bei einem Lesevorgang ist `forward_as` der Wert, den die Anrufe tatsächlich übermitteln, der vom zuletzt geschriebenen Wert abweichen kann. ## Lesen, was eine Nummer mit einem Anruf getan hat Der Datensatz eines eingehenden Anrufs enthält neben seinem Status eine `route`, und `route` gibt an, was die Nummer zum Zeitpunkt der Anrufbehandlung tun sollte. Eine spätere Änderung der Nummereinstellung ändert nicht, was ihre vergangenen Anrufe aussagen. | `route.type` | Was die Nummer getan hat | | ------------ | ----------------------------------------------------------------------------------------------------- | | `trunk` | Der Anruf wurde an den in `trunk_id` genannten SIP-Trunk zugestellt | | `forward` | Der Anruf wurde an die Nummer in `forward_to` weitergeleitet und zeigte die Nummer in `forward_as` an | | `reject` | Die Nummer hat den Anruf abgewiesen | `route` gibt an, was die Nummer tun sollte, nicht ob es funktioniert hat. Eine `trunk`-Route bei einem nie verbundenen Anruf bedeutet, dass die Nummer auf einen Trunk verweist, der den Anruf nicht angenommen hat, und der Status des Anrufs gibt das Ergebnis wieder. `route` fehlt bei ausgehenden Anrufen und bei Anrufen, die vor der Einführung des Feldes aufgezeichnet wurden. Öffnen Sie im Dashboard den Anruf über **Voice** > [**Calls**](https://bird.com/dashboard/w/voice/calls) und lesen Sie die Zeile **Inbound route**, die auf die Nummer verlinkt, deren Einstellungen den Anruf bestimmt haben. Über die API befindet sich `route` auf [`GET /v1/voice/calls/{call_id}`](/docs/api/reference/get-voice-call) und [`GET /v1/voice/calls`](/docs/api/reference/list-voice-calls), und `direction` filtert die Liste auf eingehende Anrufe. ## Einen abgelehnten eingehenden Anruf diagnostizieren Ein abgelehnter eingehender Anruf wird mit dem Status `rejected` aufgezeichnet. Zwei verschiedene Ursachen erzeugen ihn, und `rejection_reason` unterscheidet sie: - **Abgelehnt ohne `rejection_reason`.** Die Nummer selbst hat den Anruf abgewiesen. Der Anruf hat keine unserer Prüfungen ausgelöst, nennt daher keinen Grund, und `route` gibt an, was die Nummer tun sollte. Eine `reject`-Route ist eine Nummer, auf die niemand verwiesen hat, oder eine, die absichtlich auf Ablehnung gesetzt ist. - **Abgelehnt mit einem `rejection_reason`.** Der Anruf hat eine unserer Prüfungen nicht bestanden, bevor er Ihre Telefonanlage erreicht hat. Der Grund nennt die Prüfung. [Abgelehnte Anrufe](/docs/guides/voice/call-log#rejected-calls) listet jeden Grund und seine Behebung auf. `failed` ist ein anderer Status und bedeutet nicht abgelehnt: Er bedeutet, dass der Anruf versucht wurde und nicht funktioniert hat, wobei `sip_response_code` die zurückgegebene Antwort enthält. Lesen Sie `route` und `rejection_reason` zusammen, um die Ablehnungen zu unterscheiden: | `route` und Grund | Ursache | | ------------------------------------ | --------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------- | | `reject`, kein Grund | Die Nummer ist auf keine Antwort gerichtet. Das Löschen eines Trunks oder das Deaktivieren seines Inbound-Callings setzt jede darauf verweisende Nummer hierher zurück, sodass eine zuvor funktionierende Nummer hier landen kann | | `trunk`, `no_route_found` | Die Nummer verweist auf einen Trunk, und dieser Trunk hat kein Gateway, an das der Anruf zugestellt werden kann. Fügen Sie eines auf der Trunk-Seite hinzu | | `forward`, kein Grund | Das Weiterleitungsziel ist keine verifizierte Anrufer-ID mehr. Verifizieren Sie es erneut unter [Caller IDs](/docs/guides/voice/caller-ids), oder leiten Sie an eine andere Nummer weiter | | `forward`, `destination_not_enabled` | Der zweite Abschnitt konnte nicht in das Land des Weiterleitungsziels aufgebaut werden. Aktivieren Sie dieses Land unter [Destinations](/docs/guides/voice/destinations) | Die Kontolimits gelten auch für eingehende Anrufe: Wenn Ihr Wallet-Guthaben, das tägliche Voice-Ausgabenlimit Ihrer Organisation oder Ihre Gleichzeitigkeits- und Pro-Sekunde-Limits überschritten sind, wird ein eingehender Anruf mit dem entsprechenden Grund abgelehnt. [Voice overview](/docs/guides/voice/overview#limits) behandelt die Limits selbst. ## Kosten eines empfangenen Anrufs prüfen Der Empfang eines Anrufs ist kostenpflichtig. Der Tarif hängt vom Land und Typ der empfangenden Nummer ab und wird pro Land unter **Receiving calls** auf der [Voice-Preisseite](/pricing/voice) veröffentlicht, zusammen mit den Tarifen für von Ihnen getätigte Anrufe. Eine Weiterleitung wird als zwei Anrufe abgerechnet: der eingehende Anruf zum Empfangstarif und der von uns aufgebaute Abschnitt zum Outbound-Tarif für die Nummer, an die Sie weiterleiten. Eine einzelne Bearbeitungsgebühr wird einmal pro Anruf berechnet, nicht einmal pro Abschnitt. Das Wallet wird vor Zustellung eines eingehenden Anrufs geprüft, sodass ein Guthaben, das ihn nicht deckt, zur Ablehnung des Anrufs führt, anstatt ihn Ihnen nachträglich in Rechnung zu stellen. [Kosten und Abrechnung](/docs/guides/voice/placing-calls#cost-and-billing) erklärt, wie abrechenbare Zeit, Tarife und das Wallet in beiden Richtungen funktionieren. ## Nächste Schritte | Seite | Inhalt | | ---------------------------------------------------------- | ------------------------------------------------------------------------- | | [SIP-Trunks](/docs/guides/voice/sip-trunks) | Einen Trunk erstellen, seine zwei Richtungen und steuern, wer senden darf | | [Anrufer-IDs](/docs/guides/voice/caller-ids) | Eine Nummer registrieren und nachweisen, dass Sie sie kontrollieren | | [Anrufprotokoll](/docs/guides/voice/call-log) | Jedes Feld eines Anrufdatensatzes und jeder Ablehnungsgrund | | [Voice-Events](/docs/guides/voice/events) | Anrufergebnisse an Ihre eigenen Systeme pushen lassen | | [Voice-Fehlerbehebung](/docs/guides/voice/troubleshooting) | Einen Anruf diagnostizieren, der nicht durchkommt, ausgehend vom Symptom | ## Related resources - [What is a voice API?](/explained/voice/what-is-a-voice-api) (answer) - [Voice](/products/voice) (product) [Get an implementation brief](/learn/workspace?topic=voice)