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 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 mit aktiviertem Inbound-Calling und mindestens einem Zustellungs-Gateway.
Für eine Weiterleitung: eine verifizierte Anrufer-ID, 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.

Öffnen Sie Voice > SIP Trunks, öffnen Sie den Trunk und wählen Sie unter Inbound calling die Option Enable inbound.
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.
Öffnen Sie Voice > Numbers, öffnen Sie die Nummer und wählen Sie unter Inbound routing die Option Deliver to a SIP trunk.
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.

Öffnen Sie Voice > Numbers, öffnen Sie die Nummer und wählen Sie unter Inbound routing die Option Forward to another number.
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.
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 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 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} und GET /v1/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 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, 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

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 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 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 erklärt, wie abrechenbare Zeit, Tarife und das Wallet in beiden Richtungen funktionieren.

Nächste Schritte

Seite	Inhalt
SIP-Trunks	Einen Trunk erstellen, seine zwei Richtungen und steuern, wer senden darf
Anrufer-IDs	Eine Nummer registrieren und nachweisen, dass Sie sie kontrollieren
Anrufprotokoll	Jedes Feld eines Anrufdatensatzes und jeder Ablehnungsgrund
Voice-Events	Anrufergebnisse an Ihre eigenen Systeme pushen lassen
Voice-Fehlerbehebung	Einen Anruf diagnostizieren, der nicht durchkommt, ausgehend vom Symptom

Verwandte Ressourcen