Open in
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}を使用してください。