ThunderPhone v3、提供開始。セルフサービスで、1分あたり2セントから。発表内容を見る

Contact centers

Talkdesk から接続

「Autopilot Voice に接続」を使用して Talkdesk の通話を ThunderPhone エージェントに送信し、UUI のハンドオフ ID を使って Talkdesk に戻します。

Talkdesk Studio フローは、インタラクション ID と UUI を含めて発信者をエージェントに送信します。発信者が担当者を必要とする場合、エージェントは SIP REFER で Talkdesk にエスカレーションし、引き継ぎ ID は Studio 変数に格納されます。

開始前の準備

  • ThunderPhone エージェントと組織の API キー。
  • 外部音声ストリームモードの Studio Autopilot Voice に接続コンポーネントを利用できる Talkdesk 会話オーケストレーターライセンス(Talkdesk の記事)。 エージェントが通話を保持している間、Talkdesk は分単位で課金します。

1. SIP エンドポイントを作成する

Talkdesk は IP 許可リストのみを文書化しているため、送信元アドレスで通話を受け付けるエンドポイントを作成します。

curl -X POST https://api.thunderphone.com/v1/sip-endpoints \
  -H "Authorization: Bearer sk_live_YOUR_API_KEY" \
  -H "Content-Type: application/json" \
  -d '{
    "agent_id": 12,
    "name": "Talkdesk",
    "auth": "ip_allowlist",
    "allowed_source_cidrs": ["TALKDESK_SIGNALLING_RANGE_1", "TALKDESK_SIGNALLING_RANGE_2"],
    "srtp": "optional"
  }'

Talkdesk の記事によると、音声は SRTP 経由で送信され、"srtp": "optional" は Talkdesk が SRTP を提示した場合に SRTP で応答します。記事には Talkdesk が SRTP を必須としているかどうかは記載されていません。Talkdesk から必須であると案内された場合は、srtp を required に設定してください。これにより、SRTP なしの通話は拒否されます。

Talkdesk の SIP シグナリング範囲は Talkdesk から取得してください。各範囲はパブリック IPv4 範囲の /16 以下、または IPv6 の /48 以下である必要があります。詳細は 送信元 IP で認証するプラットフォームを参照してください。 Talkdesk はすべての Twilio 顧客が共有する Twilio のネットワークから SIP を送信するため、 他の発信者を遮断するのはエンドポイントのアドレスです。公開しないでください。 レスポンスの sip_uri は保存してください。例: sip:agent-12-jhxmginwjx@sip.thunderphone.com。

2. コンテキスト付きで通話を送信する

Studio フローで、外部音声ストリームモードの Autopilot Voice に接続を追加し、ターゲットをエンドポイントの sip_uri に ;transport=tls を追加した値に設定します。例: sip:agent-12-jhxmginwjx@sip.thunderphone.com;transport=tls。エンドポイントは UDP 経由の通話を拒否します。Twilio の SIP は、別途指定しない限り UDP を使用します。

Talkdesk は以下を送信します。

  • X-Talkdesk-Interaction-Id: 通話の external_call_id として保存されます。
  • User-to-User: business_hours=open のように 16 進数エンコードされます。プロンプトにはデコードされた状態で {{sip_uui}} として渡されます。

コンポーネントのバージョン 2.1 では、定義済みヘッダーも送信できます。Talkdesk の 設定ページでは、これらは WebSocket 経由で送信される JSON と説明されています。そのため、利用前に SIP ヘッダーとして到着するかを Talkdesk に確認してください。

3. 通話を戻す

エージェントは、Talkdesk が読み取る唯一の場所であるアドレス内の16進数 UUI として引き継ぎ ID を含め、Talkdesk のエスカレーションアドレスに REFER でエスカレーションします。この転送番号を追加します(転送番号を追加および転送先アドレス内のヘッダーを参照)。

{
  "name": "Talkdesk escalation",
  "number": "sip:escalation@talkdesk.com",
  "headers": {"User-to-User": "autopilot_result={{handoff_id}}"},
  "headers_in_uri": true,
  "uui_encoding": "hex"
}

アドレスは Talkdesk の記事に記載されているものです。コンポーネントのバージョン 2.1 では autopilot_result= を読み取り、バージョン 1.7 では escalate_to= を読み取るため、1.7 ではそのキーを使用します。REFER は次のようになります。

Refer-To: <sip:escalation@talkdesk.com?User-to-User=6175746F70696C6F745F726573756C743D...%3Bencoding%3Dhex>

Talkdesk は値を Studio 変数に格納します。要約とインテントを取得するには、Connections で作成したカスタム統合に アクションを実行 ステップを追加します。

  • 認証タイプは API キー、ヘッダー名は Authorization、値は Bearer sk_live_…。
  • リクエストは GET https://api.thunderphone.com/v1/calls/handoff?handoff_id= の後に変数の ID を続けます。インタラクション ID を使用して、external_call_id で通話を検索することもできます。
  • handoff.intent に基づいてルーティングし、通話を引き継ぐ担当者に handoff.summary を表示します。

引き継いだ通話を検索を参照してください。

テストする

Studio フローを通じて通話を開始し、エージェントに担当者を依頼して、フローがコンポーネントを通過した後も変数内の引き継ぎ ID を使って続行されることを確認します。次に、GET /v1/calls/{call_id} で通話を開きます。external_call_id は Talkdesk のインタラクション ID である必要があります。

制限

  • Talkdesk が読み取れる UUI は最大 256 バイトで、| または ; で区切られた値は許可されないため、単一の値を送信します。引き継ぎ ID はこの範囲に収まります。
  • Talkdesk の API ではエージェントの文字起こしを読み取れません。代わりに引き継ぎ検索または GET /v1/calls/{call_id} を使用してください。