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

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

## 開始前の準備

- ThunderPhone エージェントと組織の [API キー](/ja/guides/api-keys)。
- **外部音声ストリーム**モードの Studio **Autopilot Voice に接続**コンポーネントを利用できる Talkdesk **会話オーケストレーター**ライセンス（[Talkdesk の記事](https://support.talkdesk.com/hc/en-us/articles/48921776047259)）。
  エージェントが通話を保持している間、Talkdesk は分単位で課金します。

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

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

```bash
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 で認証するプラットフォーム](/ja/guides/sip-addresses)を参照してください。
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` でエスカレーションします。この転送番号を追加します（[転送番号を追加](/ja/guides/contact-centers/overview)および[転送先アドレス内のヘッダー](/ja/guides/call-transfers)を参照）。

```json
{
  "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` を表示します。

[引き継いだ通話を検索](/api-reference/calls#look-up-a-handed-off-call)を参照してください。

## テストする

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

## 制限

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