Logo
Conversations
Conversationsオーバー API
API 経由で通話とメッセージを管理する

通話とメッセージを管理する


このセクションでは、コールセンター固有の機能を構成する方法と、Conversations内でメッセージを管理する方法について説明します。すべての標準の Conversations 設定手順がここにも適用されます。


コール

コールの発着信方法については、WebRTC コール のドキュメントを参照してください。

以下は、必要なセットアップとコールセンター統合手順の概要です。

前提条件

コールを処理する前に、次の手順を実行します。

  1. Use Conversations 構成オプションを使用してアプリケーションを作成します。
  2. エージェント (opens in a new tab)IDを使用してエージェントを登録 (opens in a new tab)します。
  3. NTT CPaaS RTC JS SDKの追加 (opens in a new tab) をアプリケーションに追加します。

電話をかける

アウトバウンドコールを発信するには:

  1. 発信通話の会話を作成します (opens in a new tab)

  2. customData (opens in a new tab) 内に次のパラメーターを含む CallOptions (opens in a new tab) を生成します。

    • conversationsID - 前の手順で作成した会話から取得されます。
    • calleeClientType - アプリ内通話の場合は WebRTC、電話番号への通話の場合は PSTN
    javascript
     
        const callOptions = CallOptions.builder()
           .setCustomData({
               isOutbound: true,
               outboundTo: outgoingCallRequest.destination,
               outboundFrom: outgoingCallRequest.sender,
               outboundAgentId: this.context.user.agentId,
               conversationId: outgoingCallRequest.conversationId,
               calleeClientType: calleeClientType,
           }).build();
     
  3. callConversations (opens in a new tab) メソッドを CallOptions とともに使用します。

  4. 他のチャンネルと同様に会話を管理します。

電話を受ける

通話を受けるには:

  1. Voice number を設定して、通話を Conversations に転送するか、IVR (自動音声応答) で Dial to Conversations (opens in a new tab) スクリプトを使用します。
  2. また、callConversationsメソッド(Web (opens in a new tab)Android (opens in a new tab)iOS (opens in a new tab))を使用して、アプリケーションからConversationsへの呼び出しを開始することもできます。
  3. エージェントのハートビートを設定します (opens in a new tab)
  4. InfobipRTC (opens in a new tab) クライアントに 着信呼び出しイベントハンドラー を登録し、応答と拒否のロジックを実装します。

事後処理時間

通話が終了した後、エージェントは会話を終了する前にメモや要約を書く時間が必要になる場合があります。

まとめ中:

待ち行列対策

待機戦略は、エージェントとの接続を待機している間、発信者のエクスペリエンスを形成します。

以下を構成できます。

  • 戦略名
  • 適用番号またはアプリケーション
  • 最大待ち時間

オプションコンポーネント:

  • グリーティングメッセージ - 通話の開始時に再生されます
  • 音楽を保持 - 待機中に再生される音声
  • お知らせメッセージ - 発信者向けの定期的な更新
  • 最大待機時間メッセージ - 通話前に再生

通話の待機戦略の詳細

使用可能な API メソッドを使用すると、次のことができます。

通話の転送

現在、通話の転送には次の 3 つの方法があります。

さらに、 すべてのキューのリストを取得し (opens in a new tab) 、現在のアクティビティ状況とともに返すことができます。

レコーディング

取引先記録設定を作成 (opens in a new tab)して、エージェントと顧客の会話を記録して、規制要件に準拠したり、品質を確保したり、その他のビジネス ニーズをサポートしたりできます。

システムレベルの記録設定

次の記録を選択できます。

  • インバウンドコール(エージェントが応答)
  • アウトバウンドコール (エージェントによって開始)
  • インバウンドとアウトバウンドの両方

ビデオ通話の記録

Conversations の通話にはビデオを含めることができます。これらの通話の録音方法を決定できます。

  • メディアタイプ:オーディオのみ、ビデオのみ、またはその両方。
  • デフォルトの動作:

ビデオ通話は、NTT CPaaSのクラウドストレージに、ダウンロードできない「高品質なストリーミング可能なファイル」として録音・保存されます。

ダウンロード、コピー、または独自のストレージに移動できるファイルを生成するには、ビデオダウンロードの準備を有効にします。

備考Preparing video files for download may take time depending on file duration, service load, and internet connection.

構成管理

記録ファイル管理

録音ファイルを 取得 (opens in a new tab)ダウンロード (opens in a new tab)削除 (opens in a new tab) できます。


メッセージ

メッセージ API は、最初のモバイル終端 (MT) メッセージを送信するときに新しい会話が作成されるエンゲージメント キャンペーンに使用できます。

メッセージの作成

チャネルと送信者が会話スレッド用に構成されている場合、受信メッセージは自動的にスレッド化されます。

送信メッセージを会話に追加するには、 メッセージの作成 (opens in a new tab) メソッドを使用して、サポートされている任意のチャネルを介してメッセージを送信します。

メッセージの取得

Get メッセージ (opens in a new tab) メソッドを使用して、会話内で交換されたすべてのメッセージを取得します。

x-agent-id属性

x-agent-idHTTP ヘッダー属性は、メッセージを送信するエージェントを識別します。

これは、統合が APIキーで認証され、送信メッセージを特定のエージェントに関連付ける必要がある場合に使用されます。

  • 値は、エージェント エンティティの主キーである agentId です。
  • agentId は、Agents API からの応答で確認できます。
  • すべてのリクエストにx-agent-idを追加することは、アカウントがエージェントを使用しているかどうかによって使用が異なるため、必須ではありません。

動作マトリックス

会話の割り当てステータスx-agent-idが提供されていません'x-agent-id = エージェント''x-agent-id = スーパーバイザー'
未割り当てOK (エージェントを使用しないシナリオ)エラーエラー
エージェントに割り当てられているエラーOKOK
スーパーバイザーに割り当てられるエラーエラーOK

使用ルール

エージェントを使用しない場合:

  • 会話を割り当て解除したままにします。
  • 「メッセージの作成」リクエストヘッダーからx-agent-idパラメータを完全に省略します。

エージェントを使用する 場合:

  • アカウントには、 エージェントの作成 (opens in a new tab) API を介して作成されたエージェントが 少なくとも 1 つ (ライセンスは必要ありません) が必要です。
  • x-agent-idヘッダーには、メッセージを送信するユーザーに応じて、正しいagentIdが含まれている必要があります。

役割の動作

  • エージェントロールは、自分に割り当てられた会話にのみ返信できます。
  • スーパーバイザーロールは、任意の会話に返信できます。
  • x-agent-idヘッダーは、アクションを実行しているユーザーに基づいて、常に正しいagentIdを反映する必要があります。


Logo

ご不明点は

サポートまでお問い合わせ

ください

© NTT DOCOMO BUSINESS X,Inc.