メニュー

Rate this page:

Thanks for rating this page!

We are always striving to improve our documentation quality, and your feedback is valuable to us. How could this documentation serve you better?

Twilio VoiceでSIPを使用する

はじめる前に

Before you can use SIP Interface, you must sign up for a Twilio account (if you don't already have one). To sign up for an account click here.

概要

Connect your communications infrastructure to Twilio and start building programmable voice applications, such as call centers and IVRs, with Twilio’s powerful and flexible voice capabilities. You can connect to Twilio over the public internet or alternatively via a private connection using Twilio’s Interconnect. Programmable Voice SIP lets you route your voice calls with global reach to any landline phone, mobile phone, browser, mobile app, or any other SIP endpoint.

下図は、通話フローにおけるTwilioクラウドの位置付けについて示しています。

Programmable Voice SIP ダイアグラム

SIPとは何か? 

Session Initiation Protocol (SIP) is a standardized communications protocol that has been widely adopted for managing multimedia communication sessions for voice and video calls. SIP may be used to establish connectivity between your communications infrastructures such as an on-premise or virtual PBX and Twilio's communications platform.

TwilioへSIPを送信する

Twilio’s Programmable Voice SIP Interface product enables you to use your existing SIP communications infrastructure to initiate SIP sessions with the Twilio Cloud. SIP Interface uses Twilio’s TwiML language and/or Twilio’s REST APIs to create advanced voice applications. Learn how to get started connecting your SIP communications infrastructure to the Twilio Cloud.

TwilioからのSIPを受信する

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

SIP接続 - 技術仕様

以下のセクションは、Twilioの提供するSIP機能についての概要です。

メディアコーデック

Twilioは、メディアにG.711/μ-law CODECを使用します。 これは多くのキャリアーで使用されている最も普及したCODECであり、変換は不要です。

DTMF

TwilioはDTMFの送受信用に、RFC-2833を実装しています。

TLSを使用したSIPトラフィックの安全強化

暗号化は通話メディアと関連するシグナリングを送信時に確実にプライベートに保つようにします。 Transport Layer Security (TLS) はSIPのシグナリングにおける暗号化を提供します。

仕様

  • TwilioへのSIPの送信: TwilioはTLSへのリクエストに対して自動的に応答し、下記のCryptoスイートをサポートします: AES_CM_128_HMAC_SHA1_80 and AES_CM_128_HMAC_SHA1_32.  どちらも好きな順に含めることができます。
  • TwilioからのSIPの受信: ただひとつ、AES_CM_128_HMAC_SHA1_80のみが利用できます。
  • If you are using TwiML to send SIP from Twilio, to enable encryption you must use the transport=tls parameter in your SIP noun in your Dial verb.
    By default port 5061 will be used for TLS, however, you may specify the port you wish to use in your URI.
  • Importing Twilio's Root CA Certificate TLS is used to encrypt SIP signaling between SIP endpoints. In order for this to function properly it is required that certain devices in the network import a CA certificate. Twilio uses certificates from a CA (Certificate Authority). It is important that you add the following root certificate to your communications infrastructure to establish its authenticity. Download Twilio's CA certificate.

    Twilioはドメインの複数のサブドメイン (*.sip.twilio.com) にしようできるワイルドカード証明書を使用することにご注意ください。 ネットワーク要素でワイルドカード証明書をサポートしていない場合は、証明書の検証を無効にしてください。

IPアドレスホワイトリスト

Prepare your communications infrastructure to make sure that your SIP infrastructure has connectivity to the Twilio Cloud and vice versa. To ensure that your communications infrastructure doesn’t block communication, you must update your whitelist. We strongly encourage you to whitelist all of the following IP address ranges and ports on your firewall for SIP signaling and RTP media traffic.

これは異なる地域の電話番号を使用する場合や、可用性用途(たとえば、北米ヴァージニアのゲートウェイがダウンしたときは、北米オレゴンのゲートウェイが使用されます)に重要です。

北米バージニアゲートウェイ:

シグナリングIP:

54.172.60.0
54.172.60.1
54.172.60.2
54.172.60.3
Ports: 5060 (UDP/TCP), 5061 (TLS)

メディアIP:

54.172.60.0/23
34.203.250.0/23
Port Range: 10,000 to 20,000 (UDP)

北アメリカオレゴンゲートウェイ:

シグナリングIP:

54.244.51.0
54.244.51.1
54.244.51.2
54.244.51.3
Ports: 5060 (UDP/TCP), 5061 (TLS)

メディアIP:

54.244.51.0/24
Port Range: 10,000 to 20,000 (UDP)

欧州アイルランドゲートウェイ:

シグナリングIP:

54.171.127.192
54.171.127.193
54.171.127.194
54.171.127.195
Ports: 5060 (UDP/TCP), 5061 (TLS)

メディアIP:

54.171.127.192/26
52.215.127.0/24 
Port Range: 10,000 to 20,000 (UDP)

欧州フランクフルトゲートウェイ:

シグナリングIP:

    35.156.191.128
    35.156.191.129
    35.156.191.130
    35.156.191.131
    Ports: 5060 (UDP/TCP), 5061 (TLS)

メディアIP:

    35.156.191.128/25 
    Port Range: 10,000 to 20,000 (UDP) 

アジア太平洋東京ゲートウェイ:

シグナリングIP:

54.65.63.192
54.65.63.193
54.65.63.194
54.65.63.195
Ports: 5060 (UDP/TCP), 5061 (TLS) 

メディアIP:

54.65.63.192/26
Port Range: 10,000 to 20,000 (UDP)

アジア太平洋シンガポールゲートウェイ:

シグナリングIP:

54.169.127.128
54.169.127.129
54.169.127.130
54.169.127.131
Ports: 5060 (UDP/TCP), 5061 (TLS)

メディアIP:

54.169.127.128/26
Port Range: 10,000 to 20,000 (UDP)

アジア太平洋シドニーゲートウェイ:

シグナリングIP:

54.252.254.64
54.252.254.65
54.252.254.66
54.252.254.67
Ports: 5060 (UDP/TCP), 5061 (TLS)

メディアIP:

54.252.254.64/26
Port Range: 10,000 to 20,000 (UDP) 

南アメリカ サンパウロゲートウェイ

シグナリングIP:

177.71.206.192
177.71.206.193
177.71.206.194
177.71.206.195
Ports: 5060 (UDP/TCP), 5061 (TLS) 

メディアIP:

177.71.206.192/26
Port Range: 10,000 to 20,000 (UDP)

用語集

通信インフラ

A broad term to refer to IP-PBX, SBC, IP-phones, etc...

SIPエンドポイント

ユーザーがVoIP通話を開始するIP電話またはソフトクライアント

SIP URI

SIPにおける電話番号で、次のような形式になります。 sip:username@SIPDomain

Twilio SIP ドメイン

It takes the form {example}.sip.{region}.twilio.com where {example} is specified by the customer and {region}is the data center where the registrar is located. Initially only us1.

ヘルプが必要ですか?

We all do sometimes; code is hard. Get help now from our support team, or lean on the wisdom of the crowd browsing the Twilio tag on Stack Overflow.