プログラマブルSIP

概要

VonageのプログラマブルSIPは、既存のSIPインフラストラクチャをVonageの強力な会話コミュニケーションプラットフォームと統合することを可能にします。この統合により、ブラウザやモバイルアプリケーションなど、最小限の作業で携帯電話、固定電話、SIP、WebRTCエンドポイントに接続できるようになります。また、マルチチャンネル録音、IVR、音声合成、AI統合のためのWebSocket接続、文脈に応じた会話の力などのVoice API機能を貴社のプラットフォームにもたらします。

SIP Connect Workflow

Vonage SIPドメイン

A Vonage SIPドメイン には、Vonage SIP エンドポイントに接続し、Vonage アプリケーションにリンクするために必要な設定が含まれています。

SIPコールをVonageアプリケーションにルーティングするには、次のような固有のVonageドメインを作成する必要があります。 yourcompany.ドメイン名はSIP URIを形成します。 sip:number@yourcompany.sip-us.vonage.comにルーティングされ、そのSIP URIにルーティングされたコールはすべて、アプリケーションのNCCO answer_url.

認証方法は、Vonageドメインの設定内で決定されます。Vonageはリクエストを認証し、お客様のアプリケーションに転送します。

ドメインの例をいくつか挙げる：

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

音声アプリケーション

プログラマブルSIPを使用するには、音声対応Vonageを作成する必要があります。 アプリケーション まずアプリケーションIDを控えてください。

認証 - アクセス制御リスト

Vonageアプリケーションが特定のエンドポイントやデバイスからのコールのみを受け付けるように、ドメインにアクセス制御リストを設定することができます。これは、IPアドレスを許可リストに追加することで行います。

プログラマブルSIP API

ドメインをプロビジョニングするには、Programmable SIP APIを使用できる。新しいドメインのプロビジョニングに使用されるJSONオブジェクトの形式は以下のとおり：

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

name は希望するドメイン名でなければならない。 yourcompany, application_id はVonageアプリケーションのIDです。 c49f3586-9c3c-458b-89fc-3c8beb58865f. acl のようなCIDR表記のIPアドレスのリストである。 180.180.180.180/30 または単一のIPアドレス 190.190.190.190.

JSONの例はこうだ：

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

APIの完全な説明は APIリファレンス.

ドメイン・ベース・ルーティング

プログラマブルSIPドメインにかけられた呼は、地域レベルで処理されなけれ ばならない。地域ドメインを持つRequest URIを使用しなければならない。ドメインに地域コンポーネントを持たないRequest URIは呼に失敗するので注意すること。

次のコードは、このSIPコールをEUで処理したいことをVonageに示します：

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

利用可能なドメインはAレコードと同じである：

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

カスタムSIPヘッダー

SIPリクエストを送るときに必要な追加ヘッダーを指定できる。提供されるヘッダーはすべて X- に送信されます。 answer_url の接頭辞を持つ SipHeader_.例えば X-UserId の値を持つ。 1938ND9Vonageは次のようになる。 SipHeader_X-UserId=1938ND9 へのリクエストに応じる。 answer_url.

注意： で始まるヘッダー X-Nexmo には送信されない。 answer_url.

Vonageからの電話を受ける

Voice API NCCOを使用することができます。 connect アクションを使用して、SIPエンドポイントにコールを接続します。

Voice API NCCOを使用して、SIPエンドポイントにカスタムSIPヘッダーを送信することもできます。 connect アクションだ。

詳細なドキュメントは これ.

SIPコネクト

SIPコネクト機能のサポートは継続され、アプリケーションに接続されたSIPエンドポイント経由でバーチャル番号にダイヤルすることができます。 ダイジェスト認証 は、SIP Connectで認められている認証方法です。

この機能をテストするには、PBXでコールを次のように転送します。 sip-us.vonage.com.以下は、Asteriskの拡張機能を使用して、カスタムヘッダを送信する例です。 answer_url:

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

詳細情報