Programmierbares SIP

Übersicht

Programmable SIP von Vonage ermöglicht Ihnen die Integration Ihrer bestehenden SIP-Infrastruktur mit der leistungsstarken Kommunikationsplattform von Vonage. Durch diese Integration können Sie mit minimalem Aufwand Verbindungen zu Mobilfunk-, Festnetz-, SIP- und WebRTC-Endpunkten herstellen, einschließlich Browsern und mobilen Anwendungen. Darüber hinaus bringt sie Voice API-Funktionen wie Multichannel-Aufnahme, IVR, Text to Speech, WebSocket-Konnektivität für KI-Integrationen und die Leistungsfähigkeit kontextbezogener Unterhaltungen auf Ihre Plattform.

SIP Connect Workflow

Vonage SIP-Domänen

A Vonage SIP-Bereich enthält die Konfiguration, die Sie für die Verbindung mit Vonage SIP-Endpunkten und die Verknüpfung mit Ihrer Vonage-Anwendung benötigen.

Um einen SIP-Anruf an Ihre Vonage-Anwendung weiterzuleiten, müssen Sie eine eindeutige Vonage-Domäne erstellen, z. B. yourcompany. Der Domänenname bildet den SIP-URI, zum Beispiel sip:number@yourcompany.sip-us.vonage.comund alle Anrufe, die an diesen SIP-URI weitergeleitet werden, werden an Ihre Anwendung NCCO weitergeleitet. answer_url.

Die Authentifizierungsmethode wird in Ihrer Konfiguration der Vonage-Domäne festgelegt. Vonage authentifiziert die Anfrage und leitet sie an Ihre Anwendung weiter.

Einige Beispiel-Domains:

yourcompany.sip-eu.vonage.com
98765@yourcompany.sip-us.vonage.com
12345@yourcompany.sip-ap.vonage.com

Sprachanwendung

Um Programmable SIP verwenden zu können, müssen Sie eine Voice-fähige Vonage Applikation und notieren Sie sich die Application ID.

Authentifizierung - Zugriffskontrolllisten

Sie können eine Zugriffskontrollliste für Ihre Domain konfigurieren, damit Ihre Vonage-Anwendung nur Anrufe von bestimmten Endpunkten und Geräten akzeptiert. Dazu fügen Sie die IP-Adressen der Endgeräte zu einer Liste mit erlaubten Anrufen hinzu.

Die programmierbare SIP-API

Zur Bereitstellung einer Domäne können Sie die programmierbare SIP-API verwenden. Das JSON-Objekt, das für die Bereitstellung einer neuen Domäne verwendet wird, hat das folgende Format:

{
  "name": "yourcompany",
  "application_id": "app_id",
  "acl": [
    "xxx.xxx.xxx.xxx/xx", "yyy.yyy.yyy.yyy"
  ]
}

name sollte der gewünschte Domänenname sein, z. B. yourcompany, application_id ist die ID der Vonage-Anwendung, zum Beispiel c49f3586-9c3c-458b-89fc-3c8beb58865f. acl ist eine Liste von IP-Adressen in CIDR-Notation wie 180.180.180.180/30 und/oder eine einzige IP-Adresse 190.190.190.190.

Ein Beispiel für JSON könnte also sein:

{
  "name": "yourcompany",
  "application_id": "c49f3586-9c3c-458b-89fc-3c8beb58865f",
  "acl": ["180.180.180.180/30", "190.190.190.190"]
}

Eine vollständige Beschreibung der API finden Sie auf der Website API-Referenz.

Domänenbasiertes Routing

Anrufe, die an eine programmierbare SIP-Domäne gerichtet sind, müssen auf regionaler Ebene behandelt werden. Sie müssen einen Request URI mit einer regionalen Domäne verwenden. Bitte beachten Sie, dass ein Request URI ohne eine regionale Komponente in der Domain den Anruf fehlschlagen lässt.

Der folgende Code zeigt Vonage an, dass Sie möchten, dass dieser SIP-Anruf in der EU abgewickelt wird:

sip:number@yourcompany.sip-eu.vonage.com

Die verfügbaren Domänen sind die gleichen wie die A-Einträge:

sip-us.vonage.com: USA
sip-eu.vonage.com: Europe
sip-ap.vonage.com: Asia Pacific

Benutzerdefinierte SIP-Header

Sie können alle zusätzlichen Header angeben, die Sie beim Senden einer SIP-Anfrage benötigen. Alle angegebenen Header müssen beginnen mit X- und wird an Ihr answer_url mit einem Präfix von SipHeader_. Wenn Sie zum Beispiel eine Überschrift von X-UserId mit einem Wert von 1938ND9Vonage wird hinzufügen SipHeader_X-UserId=1938ND9 auf die Anfrage an Ihr answer_url.

VORSICHT! Kopfzeilen, die mit X-Nexmo werden nicht an Ihr answer_url.

Entgegennahme von Anrufen von Vonage

Sie können die Voice API NCCO verwenden connect Aktion, um einen Anruf mit Ihren SIP-Endpunkten zu verbinden.

Sie können auch benutzerdefinierte SIP-Header an Ihre SIP-Endpunkte senden, indem Sie die Voice API NCCO connect Aktion.

Die ausführliche Dokumentation ist hier.

SIP-Verbindung

Die SIP-Connect-Funktion wird weiterhin unterstützt, so dass Sie Ihre virtuelle Nummer über Ihren SIP-Endpunkt wählen können, der mit Ihrer Anwendung verbunden ist. Digest-Authentifizierung ist die akzeptierte Authentifizierungsmethode für SIP Connect.

Um diese Funktion zu testen, lassen Sie Ihre Telefonanlage Anrufe weiterleiten an sip-us.vonage.com. Hier ist ein Beispiel für eine Asterisk-Erweiterung, die eine benutzerdefinierte Kopfzeile überträgt, die an Ihre Website gesendet wird answer_url:

exten => 69100,1,SIPAddHeader(X-UserId:ABC123)
exten => 69100,2,Dial(SIP/nexmo/14155550100)

Weitere Informationen