トランクトラブルシューティング

SIP Trunkingデバッガーアラート

お使いのSIPインフラとの間でSIPリクエストの発着信が行われる際にエラーに遭遇すると、TwilioはDebugger Alert recordを記録します。これらはデバッグ用途に大変便利な場合があります。アラートトリガーを設定してアラートの希望する任意のアラートエラーコードに応じて、またオプションでトリガーでき、またオプションで対応するWebhookまたはメール通知を送信できます。 32xxx番台がSIP固有のエラーコードです。

Expert Services

Twilio Expert Servicesには、パッケージングされたワークショップ、レビューと最適化サービス、およびベストプラクティスと技術的な統合を支援するカスタムコンサルティング契約が含まれています。エキスパートサービスは、時間を短縮し、リスクを最小限に抑えるのに役立ちます。エキスパートサービスを購入される場合はこちらにアクセスしてください。

Elastic SIP Trunking Call Logs

The Call Log is a useful tool that can provide quick diagnosis of call behavior. Easily filter by date, to and from numbers or SIP addresses, and call status to begin your troubleshooting. Customize the information available to show a number of data points related to your calls for a more complete picture of your call behavior or remove columns unnecessary to your use-case. This can be performed by clicking the Configure Columns button on the right side of the Filter Results option pane. For more advanced manipulation, download the CSV from the same option pane and explore more technical details of your calls.

Values available to view in the Call Log or download to CSV include:

Account Sid **
Api Version **
CallSid
Called Via **
CNAM **
Cost ***
Date ***
Date Created **
Direction
Duration
End Time **
From
Parent Call Sid *
Phone Number Sid **
Price **
Price Unit **
Provider Sid **
Recording ***
Secure Trunking **
SIP Call ID *
Start Time **
Status
STIR Status
To
Trunk Sid *
Type

*Values must be toggled on in the Call Log

** Only available in CSV download

*** Only available in Call Logs

エラスティックSIPトランク

Trunks page allows you to create new SIP Trunks and provide you a summary of all the trunks that you have created. You can also use filters to search trunks based on Trunk SID, Trunk Name, Termination and Origination SIP URI.

共通の問題と解決策

下記ではよくある接続の問題を表しています。エラスティックSIPトランクを設定するときに参考にしてください。潜在的な原因とトラブルシューティングのヒントを提供しています。

再度 PBXなどのお持ちのコミュニケーションインフラが適切に設定できているか確認ください。トランクをテストするも合わせてご利用ください。

ターミネーション通話 (PBX/SBCからPSTN)

SIPリクエストのレスポンスを取得できない

原因 : お客様のファイヤーウォールがTwilioへのアウトバウンドSIPリクエストをブロックしている。

Open ports on your firewall as per our IP addresses.

原因 : PBXがパブリックDNSサーバーにアクセスできない。

Twilioはあなたが設定したトランクのTermination ULIをパブリックDNSに通知します。ローカルDNSサーバーにURIを設定するかパブリックDNSにアクセスできるよう設定してください。

原因:INVITEリクエストのRequest-URIにTermination URIを含めていない可能性があります。

リクエストURIがあなたがトランクに設定したTermination URIを参照していない場合、該当のSIPメッセージを怪しいリクエストと判断して破棄します。あなたが送信したRequest URI はあるべき姿である必要があります。 sip:<e.164 formatted phone number>@<your termination URI>

You are getting '403 Forbidden' responses to your INVITE requests

原因:トランクに設定されたACLにあり、ACLにINVITEリクエストを生成したIPアドレスが含まれていません。

Twilioが送信した403レスポンスのヘッダーおよびパラメーターを確認してください。どのIPアドレスからSIPリクエストが送信されているのかを確認できます。もしくはACLに存在するアドレスから送信されているかローカルルーティングを確認ください。

原因:トランクのクレデンシャルリストにあります。あなたのINVITE の認証ダイジェストが正しくありません。ユーザー名・パスワードを確認してください。

クレデンシャルリストのユーザー名・パスワードを確認してください。クレデンシャルリストを削除し、ACLが正しく動作するかどうか確認ください。

ヒント：どんな403INIVITEを受け取っているかで原因を特定できます。もし初めに "digest-less" INVITEの場合、多くの場合ACLの情報が一致していません。もし Auth digest(407 Authentication required)を伴ったINVITEの場合、クレデンシャル情報が居一致していません。

You are getting '603 Decline' responses to your INVITE requests

Cause: Your Twilio account may not be active. This may be due to the account being closed or suspended due to lack of funds or violation of the Terms of Service or Acceptable Use Policy.

お客様のアカウント残高を確認してください。クレジットを必要に応じて補充します。
Contact Twilio Customer Support at help@twilio.com to inquire further.

The call fails with a '400 Invalid Phone Number' error

原因:通話を開始する際、E.164フォーマットでダイヤルする必要があります。

PBXに E.164フォーマットでダイヤルするように設定ください。

The call fails with a ‘403 Invalid Caller ID’ or a ‘400 the number is unverified ’

Cause: Free Trial accounts are required to use a Twilio-verified Caller-ID for both the TO and FROM number.

Be sure to format the To and From number in full E.164 format, including the + sign. For example, +15005551212. It cannot be 5005551212, 15005551212.
Be sure to set the From number to either a Twilio number assigned to your account or a verified Caller-ID number, in your Twilio account.
INVITEに Remote-Party-ID が含まれる場合、上述のように有効な発信者番号が指定されているかご確認ください。

The call fails with a '403 Phone number is blocked for verification' error

Cause: The destination number is blocked by Twilio

ブラックリストへの登録についてお心当たりのない場合は、Twilioカスタマー・サポート twilio_support@kddi-web.com までお問い合わせください。

The call fails with a '403 No International Authorization' error

原因: アカウントの「音声通話の地域による許可」にてオフになっている国への発信を試みています。

アカウントの「Voice Geographic Permission」で許可された国を設定してください。

The call fails with a '503 Trunk CPS limit exceeded' error

原因: アカウントに設定された秒間の発信可能数 (CPS = Call Per Second) を超えてターミネーション通話を生成しようとしています; これは既定では1CPSです。

You can increase your CPS rate for a fee; contact your Twilio Account Manager or Sales at sales@twilio.com for more details.
代替手段としては、SIPインフラからTwilioへターミネーション通話をキューイングする頻度を落としてください。

The call fails with a '503 Trunk concurrent call limit exceeded' error

原因: トライアル・アカウントでトランクを使用中に、同時に4つ以上の通話がアクティブになっています。

有償アカウントにアップグレードすれば、この制限を解除できます。
代替案として、Twilioトランクにおける同時通話数を減らしてください。

通話は繋がり双方向で音声が聴こえるが、20〜30秒後に通話が切断される

原因: SIP通信インフラがリクエストURL内のTwilioの200 OKコンタクトヘッダーのIPアドレス以外のIPアドレスを使用してTwilioへのACKを不正に送信しています。これにより、TwilioはACKを処理しないため、30秒後にトランザクションがタイムアウトし、Twilio側からBYEを介してコールの双方に対して切断が行われます。

SIP通信インフラはACKのリクエストURL内の200 OKのContactヘッダーのIPアドレスを使用し、同200 OKのRecord-Routeヘッダー内のIPアドレスにACKを送信してください。

原因: SIP通信インフラがURIのTwilioのプライベートIPアドレスを不正に調整／置換しており、ACKのヘッダーが独自の公開IPアドレスを返しています。これはACKをSIP通信インフラに送り返すことになり、結果として処理がされないことになります。 ACKが処理されないため、Twilioは（正確には）タイムアウトし、通話は終了します。

SIP通信インフラは、Twilioの自身のIPアドレスを置き換えることはできません。通信インフラ自身ののIPアドレスだけを調整してください。

オリジネーション通話 (PSTNからPBX/SBCへ)

オリジネーションコール（PSTN-->PBX）: 音声が聞こえず 2-30秒後に切断される

原因：SIP インフラストラクチャで、スタックされている Twilio 固有のプライベート IP アドレスが、200 OK の別の IP アドレスで置き換えられています。これは主に、一定範囲のプライベート IP がグローバルに置換されることが原因です。これにより、200 OK が Twilio インフラストラクチャ内で破棄され、ACK が送信されるのを回避し、インフラストラクチャが通話を終了します。

SIP インフラストラクチャでは、Twilio から INVITE へのレスポンスで、Via ヘッダーの IP アドレスを変更してはいけません。

オリジネーションコール（PSTN-->PBX）: 双方向で音声が聞こるが、20～30 秒後に通話が切断される

原因：SIP インフラストラクチャーで、プライベート IP アドレスを含むコンタクトヘッダーとともに、200 OK が返されています。Twilio はコンタクトヘッダーの IP アドレスに ACK を送り返す必要があるため、ACK がそのプライベート IP アドレスに送られています。プライベート IP アドレスはパブリックルーティング不可であるため、ACK は SIP インフラストラクチャーに到達することはなく、通話がタイムアウトになり、削除されます。

SIP インフラストラクチャーでは、Twilio からの INVITE へ応答する場合、パブリックルーティング可能な IP アドレスをコンタクトヘッダーで使用する必要があります。

オリジネーションコール（PTSN-->PBX)にて: '401 Unauthorized'エラーが出てコールがPBXに拒否される。もしくはPBXにコールが到着するが何の応答もなしにタイムアウトする

原因: PBXが Twilio SIP トランクアドレスで設定したIPアドレスを持っていない。

Update the configuration on your PBX so that the Twilio SIP Trunking signaling IP addresses for each applicable region are Trusted Peers. Addresses are per our IP addresses.

通話はPBX側で「407 Proxy Authentication Required（プロクシーの承認が必要です）」エラーによって拒否されました。

Cause: Your PBX does not have the Twilio SIP Trunking IP addresses configured/allowed as Peers.

Update the configuration on your PBX so that the Twilio SIP Trunking signaling IP addresses for each applicable region are Trusted Peers. Addresses are per our IP addresses.

通話はPBX側で応答したものの、レスポンスのないままタイムアウトしました。

Cause: Your PBX does not have the Twilio SIP Trunking IP addresses configured/allowed as Peers.

Update the configuration on your PBX so that the Twilio SIP Trunking signaling IP addresses for each applicable region are Trusted Peers. Addresses are per our IP addresses.

通話が「408 Request Timeout」エラー、または「504 Request Timeout」エラーによって失敗する

原因：TwilioはSIP通信インフラからのレスポンスを受け取っていません。

トランクのオリジネーション設定に構成済みのSIP URIが正しいかどうかご確認ください。
Check your firewall to be sure the Twilio IP addresses and ports are allowed
Check your PBX to be sure the Twilio IP addresses and ports are allowed

"422 セッション・タイマーが小さすぎます" エラーとともに通話が切断される

原因: お客様のPBXが、INVITEで指定されているものより大きなセッション期限で設定されています。考えられる原因は:

お客様のPBXが非常に大きなセッション期限の値で構成されています。
キャリアのINVITEには、非常に小さなセッション期限が設定されています。

Twilioは現在セッション・タイマーをサポートしておらず、Supported: Timer ヘッダーを取り除きます。このように、セッション期限の値は実際にはPBX側で無視されるべきものですが、実際にはそうなっていません。回避策として、PBX側の Session-Expires を通常の既定値である1800または3600など適切な値まで下げてください。

通話がPBXに到達せず、Twilioの通話ログにも表示されない

原因: Twilio SIPトランクにオリジネーションSIP URIを構成していないか、解決を行わない「不正な」SIP URLを構成しています。

オリジネーション用の有効で到達可能なSIP URIが構成されているか確認してください。

415 メディアタイプがサポートされていないエラーが記録されるとともに通話が失敗する

Cause: Your SIP infrastructure does not list G.711 μ-law (PCMU) or A-law (PCMA) in its supported Codecs. Twilio currently supports only G.711 μ-law (PCMU) or A-law (PCMA) codecs.

Make sure your SIP infrastructure supports G.711 μ-law (PCMU) or A-law (PCMA).

オリジネーションコールにて（PSTN-->PBX)にて: INVITEはPBXに到着するが、応答がなくタイムアウトし、PBXのログにINVITEのログが残っていない

Cause: Your firewall does not have the Twilio SIP Trunking IP addresses allowed.

Update the configuration on your firewall so that the Twilio SIP Trunking signaling IP addresses for each applicable region are allowed. Addresses are per our IP addresses.

通話の片側からしか音声が聞こえない

PSTN側は聞こえるがPBX側では声が聞こえない、またはその逆

原因:PBXがTwilioに送信されるSDPにローカル（LAN）IPアドレスを記入しています。

PBXに SDPにWAN側のIPアドレスを入れるよう設定ください。

原因:ファイヤーウォールがTwilioからのRTPをブロックしている。

Update your firewall to allow/pass RTP from Twilio IP/ports as per our IP addresses.

PBX側からPSTN側の音声は聞こえるが、その逆は聞こえない

原因: ファイアー・ウォールがPBXからTwilioへのRTPパケットをブロックしています。

ファイアウォールを更新して、PBXのIPアドレスとポートからRTPを許可/通過させます

原因: お使いのインターネットプロバイダーがPBXからTwilioへのRTPパケットをブロックしています。

インターネットプロバイダに、PBXのIPアドレスとポートからRTPを許可または通過させるよう問い合わせてください

原因: RTPパケットがTwilioのインフラを通過するには低すぎる値（10以下）にまでパケットのTTLが減少するルートを通っています。

ヘルプが必要ですか？

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

ヘルプが必要ですか？

フィードバックくださりありがとうございます！

Thanks for your feedback!

ステップ1

ステップ2:

ステップ3