---
title: "Genesys Cloud から接続"
description: "会話 ID と UUI を含む Genesys Cloud 通話を BYOC Cloud トランク経由で ThunderPhone エージェントに送信し、UUI 内のハンドオフ情報を使って通話を戻します。"
---

Architectフローは、会話IDと設定したUUIを含めて、BYOC Cloudトランク経由で発信者をエージェントに送信します。発信者に担当者が必要になった場合、エージェントはSIP `REFER` を送信し、Genesysが通話を引き戻すと、引き継ぎIDが通話のUUIに届きます。

## 開始前の準備

- ThunderPhoneエージェントと組織の[APIキー](/ja/guides/api-keys)。
- BYOC Cloudを備えたGenesys Cloudと、以下の設定を有効にした外部トランク（タイプはBYOC Carrierまたは
  PBX）
  （[外部トランク設定](https://help.genesys.cloud/articles/external-trunk-settings/)）:
  - **会話ヘッダー**: Genesysが会話IDを `x-inin-cnv` で送信できるようにします。デフォルトでは無効です。
  - **UUIパススルー**: ヘッダータイプを `User-To-User`、エンコーディングをHexに設定します。
  - **引き戻しと転送**: Genesysがエージェントの `REFER` を受け入れられるようにします。

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

Genesysはダイジェストチャレンジに応答するため、標準エンドポイントを使用します。

```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": "Genesys Cloud"}'
```

レスポンスの `password` は一度しか表示されないため、すぐに保存します。トランクでは次のように設定します。

| 設定 | 値 |
|---|---|
| SIPサーバー | `sip.thunderphone.com`、ポート `5061` |
| プロトコル | TLS |
| ダイジェスト認証 | エンドポイントの `username` と `password` |
| コーデック | PCMU、PCMA、またはG.722 |

フローがダイヤルするアドレスを番号計画でカバーするサイトの送信ルートに、トランクを配置します。

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

Architectフローで、次の手順を実行します。

1. 必要に応じて、エージェント用のコンテキストを含む **UUIデータを設定** アクションを追加します。例: `account=12345`。Genesysでは128文字以下が推奨されています。
2. エンドポイントの `sip_uri` を使用する **番号へ転送** アクションを追加します。例: `sip:agent-12-jhxmginwjx@sip.thunderphone.com`。

Genesysは会話IDを `x-inin-cnv` で送信します。ThunderPhoneはこれを通話の `external_call_id` として保存します。UUIはデコードされ、`{{sip_uui}}` としてプロンプトに渡されます。

トランクのカスタムヘッダーはGenesysでは静的なため、通話ごとの値はUUIに格納します。Genesysは `x-inin`、`x-genesys`、`x-pcv`、`x-gcv` のヘッダープレフィックスを予約しています。

## 3. 通話を引き戻す

エージェントは、引き継ぎIDをそのアドレス内の16進UUIとして含めて、Genesys上のアドレスに `REFER` を送信して転送します。次の転送番号を追加します（[転送番号を追加する](/ja/guides/contact-centers/overview)および[転送アドレス内のヘッダー](/ja/guides/call-transfers)を参照）。

```json
{
  "name": "Genesys support",
  "number": "sip:support@acme.byoc.mypurecloud.com",
  "headers": {"User-to-User": "{{handoff_id}}"},
  "headers_in_uri": true,
  "uui_encoding": "hex"
}
```

このアドレスを、発信者を受け取るキューまたはフローにルーティングするアドレスに置き換えます。形式はGenesysで確認してください。`REFER` は次のようになります。

```
Refer-To: <sip:support@acme.byoc.mypurecloud.com?User-to-User=5A72336D59...%3Bencoding%3Dhex>
```

**引き戻しと転送** を有効にすると、Genesysはトランクから通話を引き戻し、そのアドレスにルーティングします。Genesysのドキュメントでは、受信UUIは `Call.UUIData` に格納されるとされていますが、引き戻しについては記載されていません。そのため、Genesysまたはテスト通話で、発信者を受け取るフローがそこで引き継ぎIDを取得できることを確認してください。要約と意図を取得するには、Web Services Data Actions統合の **通話データアクション** で引き継ぎ検索を呼び出します。

- リクエスト: `GET https://api.thunderphone.com/v1/calls/handoff?handoff_id=`
  の後に、`Call.UUIData` から取得したIDを追加します。
- 認証情報: `Authorization: Bearer sk_live_…` として送信するAPIキー。
- 出力: `handoff.summary` と `handoff.intent` をフロー変数にマッピングします。

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

## テスト

フローに到達する番号へ発信し、エージェントに担当者を尋ねて、Genesys が通話を設定したアドレスへ転送することを確認します。そのフローで、`Call.UUIData` にハンドオフ ID がテキストとして保持されていることを確認します（16進数の桁が表示される場合は、トランクの UUI エンコードが Hex であることを確認してください）。次に、`GET /v1/calls/{call_id}` で通話を開きます。`external_call_id` は会話 ID になるはずです。

## 制限事項

- **Get SIP Headers** アクションは最初の `INVITE` のみを読み取るため、エージェントの `REFER` からは何も読み取れません。ハンドオフが Genesys に到達する経路は UUI のみです。
- Genesys は、通話に複数の UUI ヘッダーが含まれている場合、すべての UUI を破棄します。
- 転送先アドレスは 254 文字まで保持されるため、長い UUI は収まるように切り詰められます。ハンドオフ ID は常に収まります。
