Numbers

Numbers sind ein wichtiges Konzept, das bei der Arbeit mit der Vonage Voice API zu verstehen ist. Die folgenden Punkte sollten vor der Entwicklung Ihrer Vonage-Applikation berücksichtigt werden.

Formatierung

Innerhalb der Vonage Voice (API oder SIP Trunking) sind alle Numbers im E.164-Format. Das bedeutet, dass Numbers:

  • Lassen Sie sowohl ein führendes + und die internationale Vorwahl wie 00 oder 001.
  • Sie dürfen keine Sonderzeichen wie z. B. ein Leerzeichen enthalten, () oder -

Eine US-Nummer hat zum Beispiel das Format 14155550101. Eine britische Nummer hat das Format 447700900123.

Wenn Sie sich nicht sicher sind, wie Sie die Nummer formatieren sollen, können Sie die Number Insight API kann verwendet werden, um korrekte Informationen über eine Zahl zu finden.

Vonage Numbers

Vonage bietet Mietnummern in vielen Ländern der Welt an. In einigen Ländern können die Numbers nur für SMS oder Sprache aktiviert sein, in anderen Ländern unterstützen sie beides.

Vonage kann für viele Länder sowohl Festnetz- als auch Mobilfunknummern zur Verfügung stellen. Sie können nach einer verfügbaren Nummer suchen und diese mieten:

Ausgehende Anrufer-ID

Bei einem abgehenden Anruf ist die Anrufer-ID die from Wert in der Einen Anruf tätigen API oder verbinden Aktionen für Voice API. Es kann auch im SIP gefunden werden INVITE für SIP Trunking; sie befindet sich in der PAI Kopfzeile, wenn sie gesetzt ist, andernfalls wird sie in der From Kopfzeile. Sie können die folgenden Numbers als Anrufer-ID verwenden:

  • Eine Ihrem Account zugeordnete Vonage Numbers ohne Beschränkung für ausgehende Anrufe (siehe Feld Beschränkungen in Numbers kaufen Seite oder fragen Sie den Support).
  • Eine Nicht-Vonage-Nummer nach Vorlage der erforderlichen Angaben zum Eigentumsnachweis. Vorbehaltlich geografischer Einschränkungen, Kontakt zum Support um Ihre Nummer als Verified Caller ID registrieren zu lassen.
  • Original-Anrufer-ID des Anrufers, der Ihre Vonage-Nummer anruft (gilt nur für den Endgerätetyp Telefon). Dies ist hilfreich für Anrufweiterleitung oder Anrufverfolgung. Wenn Sie zum Beispiel einen Anruf erhalten von 15551111111 zu Ihrer Vonage-Nummer 15552222222können Sie einen ausgehenden Anruf mit Verbindungsaktion an eine Nummer tätigen 15553333333 Original-Anrufer-ID verwenden 15551111111 als Ihre Von-Nummer.

Hinweis: Diese Funktion wird nur für Inlandsgespräche unterstützt, d. h. alle drei Numbers müssen sich innerhalb desselben Landes befinden und dürfen keinen Einschränkungen durch lokale Regulierungsbehörden unterliegen.

Jede andere Nummer, die als Anrufer-ID verwendet wird, führt dazu, dass der Anruf blockiert wird.

ID eingehender Anrufer

Um eine von Vonage gemietete Nummer mit Ihrer Sprachanwendung zu verwenden, müssen Sie diese Nummer über die Option Dashboard auf der Seite Applications oder über die Schaltfläche Numbers API. Für SIP Trunking sollten Sie die Nummer mit Ihrer SIP-Domäne über die SIP-Dashboard. Sie können mehrere Numbers mit der gleichen Anwendung verknüpfen, und die angerufene Nummer wird an Ihre answer_url im to oder im Parameter To Kopfzeile in SIP INVITE für SIP Trunking.

Wenn Sie einen Anruf erhalten, wird die Anrufer-ID in der Antwort Webhook als die from Feld, oder als From Kopfzeile in der SIP INVITE für SIP Trunking.

{
  "from": "442079460000",
  "to": "447700900000",
  "uuid": "aaaaaaaa-bbbb-cccc-dddd-0123456789ab",
  "conversation_uuid": "CON-aaaaaaaa-bbbb-cccc-dddd-0123456789ab"
}

Vonage versucht, Ihnen die Anrufer-ID des Anrufers Ihrer Vonage-Anwendung im internationalen Format zu präsentieren. Es kann jedoch vorkommen, dass diese vom Ursprungsnetz falsch formatiert wird. Vonage leitet die vom Rufnummernanbieter erhaltene Nummer weiter. Weitere Informationen zur eingehenden Anrufer-ID finden Sie in unserem Überblick über die Sprachfunktionen Seite in der Vonage Wissensdatenbank.