メニュー

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?

Client通話用Voice Insights

Client通話に対してVoice Insightsをオンにする

To enable Voice Insights, login to console with your Twilio account, switch to the Programmable Voice section using the phone icon in the left nav. Under the new Insights (Beta) tab, visit the settings section in the left nav. Choose the checkbox to enable Insights. Click Save. Insights is now enabled. To enable Insights for your subaccounts, switch to the subaccount and enable Insights from the settings.

Voice Insights 設定

Client Insightsのアカウントレポート

With Insights, you can view account level reports that provide analytics for all the client calls across Twilio Client over last 30 days. Insights data is available for client calls made using Twilio Client JS 1.3 and 1.4 SDKs. After enabling Insights, click on the Client tab. You will see the account report overview page, with the date range selection shown. Select the date range for which you want to view the data from the dropdown. Data for twilio client calls will be aggregated over the selected date range. You can see the detailed breakdown of the overview data by clicking on any of the tabs. The details on the breakdown is explained below:

Overview: Dashboard for tracking your KPIs in the selected time range. The metrics presented using the donut charts on the overview page are described below.

  • Total Calls: Total number of client calls logged in the selected time range
  • Failed to connect: Percentage (and number) of these calls that failed to be set up. These could be due to authentication/audio device/permission issues.
  • Terminated with error: Percentage (and number) of calls that disconnected because of an error. The error most commonly results from network degradation.
  • ネットワークによる影響: 通話品質が体感的に低下したが、切断はされなかった通話が含まれます。
  • Feedback score: If you are reporting feedback from end users to Twilio using Twilio Client's feedback APIs, you'll see statistics on reported scores here.
  • Feedback issues: If you are reporting feedback from end users to Twilio using Twilio Client's feedback APIs, you'll see statistics on reported issues here.
  • Disconnected by agent: One of the KPIs our customers commonly care about is "Who disconnected the call?". This "Disconnected by agent" metric provides the % of time the call was disconnected by the twilio client user (local/contact center agent).

Insights-Aggregates-Overview-v2

Each of the tabs in the overview tab break down these top level metrics into more detail by IP Addresses, Clients, Region, Direction and Browser. This is described further below:

  • Client: If you are specifying a client name in your connection object, you will see the call data for each client. With this data, you'll be able to know which clients are affected most from call errors or deteriorated network.
  • IP Address: Similarly, the breakdown by IP Address enables you to view the affected calls for each IP address.
  • Browser: This breakdown enables you to view call errors by browser. It is specially useful when uncovering certain browser upgrades affect your user's experience.
  • Direction: Provides breakdown of issues for incoming/outgoing calls.
  • Region: This chart will enable you to isolate call quality issues to the AWS region from which calls are being routed.

Insights_Call_Failure_Breakdown.png

通話音量Insightsの表示

通話音量Insightsを表示するには、コンソール上で左側のナビゲーションから「通話ログ」を選択します。 特定の通話についてのデータを表示するには、タイムスタンプをクリックすると表示される「通話音量詳細」を確認します。 InsightsはTwilioクライアント通話で使用できるため、通話ログの「種類」の列を確認することで、通話がクライアントによるものかどうかを知ることができます。

着信、および発信番号を使用したInsightsの表示

You can also find calls if you know the To/From number. To find calls using the To phone number, search for the phone number in the filter bar. From the filtered call list, click on the timestamp to go to the call details page as shown above. Now select the Parent CallSid from the call details page. This represents the client leg of this call for which insights are available.

To find calls using the From phone number, search for the phone number in the filter bar. From the filtered call list, click on the timestamp to go to the call details page as shown above. Now select the Child CallSid from the call details page. This represents the client leg of this call for which insights are available.

VoiceInsightsCallLogs

通話イベント

イベント・ログでは通話中に発生する状態変化の遷移についてのイベント、ネットワーク品質の悪化やオーディオ機器の誤動作の際に発生する警告、そしてエンドユーザーによってフィードバックが送信された時に発生するイベントを提供します。 イベント・ログにはまた、接続の失敗時に発生するエラーも含まれています。 接続エラーはTwilioクライアントがTwilioサーバーとの接続に失敗したときに発生します。 このような失敗はサーバーのネットワークの品質低下、またはファイアー・ウォールなどが原因で発生します。 イベントについての詳細を確認するには、Events APIページをご参照ください。 「イベント」タブを使用すれば、コンソール上からイベントを参照できます。

Voice_Insights_Events.png

メトリックス

Twilioクライアントは、Insightsサーバーに定期的にネットワークとオーディオ品質についてのメトリックを送信します。 グラフ上にオレンジ色の点線で表されるしきい値の線は、知覚できるほどの通話品質の低下を示す値の境界を示しています。 しきい値の線はITU標準に基づいています。 ネットワーク・メトリックについて詳しくは、Metrics APIドキュメントを参照してください。

Voice_Insights_Metrics.png

サマリー

通話の終了後は、イベントおよびメトリックは単一のJSONドキュメントとして要約されます。 通話サマリーにはユーザーの送信したフィードバック、グループおよびレベルごとに分類されたイベントの総数、そして通話に対して収集されたメトリックの百分率の統計が含まれています。 サマリーのデータについてより詳しくは、Summary APIドキュメントを参照してください。

Voice_Insights_Summary

FAQ

  • Voice Insightsは旧バージョンのTwilioクライアント (1.2以前) で動作しますか?

    • いいえ。 Voice InsightsはTwilioクライアント 1.3以降のみサポートします。

  • Voice Insightsはどのブラウザーで動作しますか?

    • Voice InsightsはOpera、Chrome、およびEdgeでご利用いただけます。 現時点で、Voice Insights品質メトリックはFirefox上ではご利用いただけません。 Firefox向けのメトリックは近日追加予定です。 しかし、通話イベントはFirefoxでも利用可能です。

  • Voice InsightsはAndroidおよびiOS SDKで動作しますか?

    • モバイルSDK向けのVoice Insightsは現在開発中です。 通話イベントと通話数については現状で取得可能です。 しかしながら、ネットワーク・メトリックと警告は利用できず、近日対応予定です。

  • 通話のはじめに高い遅延(レイテンシー)が見られるのはなぜですか?

    • 通話接続のセットアップ中の、最初の10秒間における高い遅延(レイテンシー)と低いMOS値は異常ではありません。

  • メトリックスのグラフ上の灰色の部分にはどんな意味がありますか?

    • The grey section on the metrics graph indicates the metrics recorded at setup time during the first 15 seconds of the call. The metrics recorded during this time do not accurately reflect call quality, and no warning events are generated until the metrics are normalized.

  • クライアント通話でInshgtsが表示されないのはなぜですか?

    • 上記のオプトイン手順で、Inshgtsをオンにする必要があります。

  • Insightsのデータはどのくらいの期間、利用できますか?

    • 各通話のInsightsのデータは、通話が発信/着信されてから30日間有効です。
  • Insightsをオンにしたばかりです。 1日分のデータしか表示されないのはなぜですか?

    • Insights data is available only from the time you last enabled Insights. If you disable Voice Insights, you'll lose access to prior data. We strongly recommend downloading your data using the APIs before disabling Insights.
Rate this page:

ヘルプが必要ですか?

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.