Outbound - Receiving SIP from Twilio

概要

TwilioのProgrammable Voice SIP Interface製品では、既存のSIP通信インフラを使用してTwilioクラウドでのSIPセッションの開始、Twilioの TwiML 言語やREST APIの使用で高度な音声通話アプリケーションを行うことができます。

動作の仕組み

Programmable Voice SIPでは、あなたのTwilioアプリケーションとSIP通信インフラを接続する手段がいくつかあります。

1. アプリケーションはTwilioのREST APIを使って、SIP通信インフラに対して新規にSIP通話を開始することができます
2. 着信のPSTNまたはSIPの通話は、<Dial>動詞の<Sip>名詞を使用して応答できるアプリケーションを呼び出してSIPエンドポイントとの通話を確立できます。

<?xml version="1.0" encoding="UTF-8"?>
<Response>
  <Dial>
    <Sip>sip:jack@example.com</Sip>
  </Dial>
</Response>

はじめましょう

Twilioからあなたの通信インフラへのSIPの受信を開始するには、従うべき主要な手順がひとつあります。 

システムにおけるTwilioのSIP IPアドレスとメディアのポートのホワイトリスト登録

通信インフラが通信をブロックしていないことを確認するには、ホワイトリストを更新する必要があります。 詳細については、こちらをごらんください。

これで、TwilioのIPアドレスはあなたのシステムにホワイトリスト登録され、TwilioアプリケーションはSIPのトラフィックをSIPの通信インフラに送信しはじめることができるようになります。 Twilioを使いはじめて間もない方は、最初のアプリケーションとして<Dial>の<Sip>名詞からはじめるのが一番でしょう。詳細については、こちらをごらんください。

高度な機能

SIP Custom Headers

Twilio allows you to send custom SIP headers as part of the outgoing initial INVITE request.

<?xml version="1.0" encoding="UTF-8"?>
<Response>
    <Dial>
        <Sip>sip:jack@example.com?x-myotherheader=bar</Sip>
    </Dial>
</Response>

You can also send multiple param & value pairs as part of the same header. For example,

<?xml version="1.0" encoding="UTF-8"?>
<Response>
    <Dial>
        <Sip>sip:+14158675309@your.domain?X-customName=Bob%2CShield%2BTitle%2DManager&amp;X-otherHeader=true</Sip>
    </Dial>
</Response>

Twilio allows you to pass the custom header as part of Dial action URL or the call screening URL. On a successful call setup (when a 200 OK SIP response is returned) any X-headers in the 200 OK message are posted to the call screening URL in the format SipHeader_X-headername=headervalue and in the final SIP response message (any 4xx or 5xx message or the final BYE/200) are posted to the Dial action URL in the format DialSipHeader_X-headername=headervalue.

UUI (User-to-User Information) Header

In order to pass the contextual information of the caller, customers use UUI (User-to-User Information) header in SIP request messages. Twilio allows you to pass UUI header as part of <Sip> request.

Note: For non X-headers like UUI, action and call screening URL are not supported.

UUI headers is the only header that can be sent without "X-" prefix. See below...

<?xml version="1.0" encoding="UTF-8"?>
<Response>
    <Dial>
        <Sip>sip:jack@example.com?User-to-User=123456789%3Bencoding%3Dhex&amp;x-myotherheader=bar</Sip>
    </Dial>
</Response>

UUI headers can also send with "X-" prefix. See below...

<?xml version="1.0" encoding="UTF-8"?>
<Response>
    <Dial>
        <Sip>sip:jack@example.com?X-User-to-User=123456789%3Bencoding%3Dhex&amp;x-myotherheader=bar</Sip>
    </Dial>
</Response>

regionパラメーター

Twilioがお客様の通信インフラに対して送信するSIP-outトラフィックの地理的リージョンを指定するには、SIP URIにregionを含めることが必要です。 たとえば、region=ie1パラメーターがSIP URIに含まれる場合、TwilioはSIPトラフィックをヨーロッパのアイルランドリージョンから送信します。

<?xml version="1.0" encoding="UTF-8"?>
<Response>
    <Dial>
        <Sip>sip:alice@example.com;region=ie1</Sip>
    </Dial>
</Response>

regionパラメーターが指定されない場合、TwilioはSIP-outトラフィックを北米ヴァージニアリージョンから送信します。

メモ:

• You must make sure you whitelist the IP addresses of the Twilio region for SIP signaling and RTP media traffic.
• 登録済みSIPエンドポイントへの発信ではregionパラメーターがサポートされず、存在した場合は無視されます。 SIP-outトラフィックは常にSIPエンドポイントが登録されたリージョンから送信されます。