Level up your Twilio API skills in TwilioQuest, an educational game for Mac, Windows, and Linux. Download Now

メニュー

Expand
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 offers several tools for investigating the interaction between Twilio and your application. If a call fails to go through, or your voice call behaves unexpectedly, the Debugger and Request Inspector should be your first stops for debugging.

Debugger

Found in your Twilio console, the Debugger contains a detailed log of activity within your application. This log can help you dive deeper and understand which Twilio resources were impacted (and by whom).

To get to the debugger, open the console navigation, then find and click on 'Debugger':

debugger-productMenu.png

デバッガーにアクセスすると、イベントの表示されている下の図のように、詳細なログを掘り下げて問題の根本原因を理解することができます。

Twilioデバッガー

アラートトリガー

Consoleでご自身のアラートトリガーを設定できます。 これらにより、お使いのアカウントでエラーが発生したとき、Webhookまたはメールによって通知されます。

リクエストインスペクター

The Request Inspector provides you with information regarding the requests Twilio makes to your application as well as the responses Twilio receives. Twilio keeps these logs for 90 days.

  • Twilioアカウントにログインします
  • Programmable Voiceダッシュボードに移動して通話ログにアクセスします

Consoleナビゲーション: Programmable Vocie

  • 続いて、通話ログのリンクをクリックします:

Twilio通話ログを見つける

  • 通話ログにアクセスできたら、問題の発生した通話を見つけます。 日付のリンク部分をクリックし、この通話の詳細を掘り下げます。

特定の日の通話ログを選択する

これでリクエストを調査できます!

リクエストインスペクターはこの通話で送信されたすべてのリクエストとレスポンスを表示します。 リクエストの右側に色付けされたステータスで、簡単にリクエストのエラーを確認できます。

通話ログ: リクエストインスペクター 404

リクエストをクリックして情報を展開します。

通話ログ: リクエストインスペクター404b

In the above screenshot, Twilio made a request to `/action.xml` but it received a 404 back from the web server. Since Twilio didn’t receive any new TwiML to execute, the call terminated. This shows us that the web application server is sending a 404 back to Twilio, and the next step is debugging the web application itself.

エラーコード

Twilioによって生成された全エラーコードはこちらにドキュメント化されています。 発生しているエラーコードを見つけて、原因と考えられる解決策を調べましょう。

一般的な諸問題

通話で「アプリケーションエラーが発生しました」という音声が流れる

「アプリケーションエラー」とは、開発者のサーバー上で指定されたURLからTwilioがフェッチしようとしたコードが使用できなかったか、コード中にエラーがあったかのどちらかを意味しています。 Console、または通話処理用のアプリケーションの命令の中で特定の電話番号に対するURLを確認できます。

Voice Webhook

If you see this error, check your Twilio account's debugger logs for more details.

メモ: 開発者のサーバーがTwilioから公開インターネット経由で到達できるようにすることが必要です。 ローカル上で開発やテストを行っている場合、Webhookのテストにはngrokのご使用を推奨します。 こちらのガイドに従って、ngrokをTwilioで使用する方法を学習できます。

通話の着信を抑止する方法

If you do not want to receive any phone calls with your Twilio phone number, you must remove the Voice Request URL from your Twilio phone number and leave that field blank. Without a Voice Request URL, this phone number is considered 'out of service' for inbound calls. You will not be charged for any incoming calls, nor will these calls be received and logged in your account.

To reject phone calls coming from specific phone numbers, use the <Reject> verb. As long as <Reject> is the first verb in your response to the call, Twilio will not answer the call. If any other TwiML verbs are used before <Reject>, your application will receive the call and your account will be billed.

<Gather>に関する問題

<Gather>にまつわる問題の原因を特定できる決定的なテストは存在しません。 取るべき最善のアプローチとしては、考えうるすべてのことを試して問題の切り分けを行うことです。 下記をお試しください:

  1. Use several different phones from different carriers. If the issue occurs reliably, but only on phones from a particular carrier, you might want to contact that carrier directly to report the issue. If the problem occurs reliably on multiple telephones from multiple service providers, please contact Twilio support.
  2. まれにしか事象が発生しない場合、環境的な要因か特定のユーザーの使用スタイルに依存している可能性があります。 この事象がよく発生する特定のユーザー、電話機、あるいは場所がないかどうか確認してください。
  3. Check how your application handles <Gather>. <Gather> may receive all of the inputs from your user, but your application may not properly handle the request at the URL specified in <Gather action="">. Be sure to check that action="" points to the correct location, and that your specified location can accept requests made with the method you are using.

<Gather>の実装についての追加ヘルプについては、こちらのガイドを参照してください。

国際通話の問題

Twilioはワールドワイドでの通話をサポートしますが、国際パーミッションを明示的に有効にしておく必要があります。 国際パーミッションはこちらからオンにできます。

アカウントがまだ国際発信用にセットアップされていない場合は、Twilioサポートまでお問い合わせいただき、アクセスをリクエストしてください。 アカウントでアクセスが許可された後は、グローバルパーミッションページに再度アクセスして通話を発信したい国をオンにしてください。

Recording Resource Exceptions

The Recording API may occassionally throw an exception along the lines of:

Twilio\Exceptions\RestException: [HTTP 400] Unable to create record: Requested resource is not eligible for recording (uncaught exception) at /path/to/your/twilio/code.file

The call resource could be ineligible for recording for a number of reasons, but it typically means that you're trying to record a call that has already been completed (for example, both parties hung up) or a call that never established (for example, a failed call, or a call in which the caller hung up before media started flowing.)

You can get more detailed information about the phone call by using the REST API or through your call logs in the Twilio Console.

他のツールとAdd-On

Twilio Status

Twilio Statusページ(英語)から、Twilioのシステムのリアルタイムステータスを常時確認できます。 Twilio側に何らかの問題が発生した場合は、こちらで確認することができます。

Voice InsightsとAdd-on

If you're looking for additional insights into your voice calls, you may want to consider Voice Insights, which gives you use real-time data about call quality, carrier analytics, and WebRTC performance to proactively assist customers and minimize support time.

Twilioはまた、Twilioでより多くのことを可能にするパートナー技術に簡単なアクセスに役立つ、さまざまな種類のAdd-onを提供しています。Marketplace内で、Twilio Carrier Information#1 Robocall and Spam Blocking solutionを含むAdd-onの全リストを確認できます。

サポートへ問い合わせる

If you're still having trouble with your Twilio Voice calls, you can reach out to our support team for help.

Rate this page:

ヘルプが必要ですか?

誰しもが一度は考える「コーディングって難しい」。そんな時は、お問い合わせフォームから質問してください。 または、Stack Overflow でTwilioタグのついた情報から欲しいものを探してみましょう。