---
title: "Five9から接続"
description: "AI Agent Connectを使用して、Five9の通話をSIP経由でThunderPhoneエージェントに送信し、IVRスクリプトが読み取るルーティングヘッダー付きで通話を戻します。"
---

Five9 の IVR スクリプトは、Five9 の通話詳細とともに発信者をエージェントへ送ります。エージェントの処理が完了すると、SIP `BYE` にルーティングヘッダーを付加して切断します。スクリプトはそのヘッダーを通話変数に読み込み、発信者をルーティングします。

## 開始前に必要なもの

- ThunderPhone エージェントと組織の [APIキー](/ja/guides/api-keys)。
- Five9 の **AI Agent Connect** アドオン。Five9 は利用を認定済みの AI プロバイダーに限定しており、Five9 の実装チームが設定を行います。プロバイダーの IVR スクリプトテンプレートをインポートし、通話変数を作成して、スクリプトの **サードパーティ転送** モジュールをプロバイダーに向けます。ThunderPhone はまだ Five9 の認定リストに含まれていません。導入計画に組み込む前に、Five9 のアカウントチームまたは ThunderPhone サポートへ確認してください。

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

Five9 のサードパーティ転送モジュールは SIP アドレスではなく電話番号へ発信します。また、他社の Five9 連携ではパスワードではなく送信元アドレスで Five9 を認証します。そのため、Five9 がダイヤルする番号をダイヤルイン番号として指定した `ip_allowlist` エンドポイントを作成します（[電話番号へ発信するプラットフォーム](/ja/guides/sip-addresses)を参照）。

```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": "Five9",
    "auth": "ip_allowlist",
    "allowed_source_cidrs": ["FIVE9_SIGNALLING_RANGE_1", "FIVE9_SIGNALLING_RANGE_2"],
    "dial_in_numbers": ["+14155550188"]
  }'
```

- `allowed_source_cidrs`: Five9 から提供される、Five9 データセンターの SIP シグナリング範囲。各範囲は `/16` 以下のパブリック IPv4 範囲、または `/48` 以下の IPv6 範囲である必要があります。
- `dial_in_numbers`: Five9 のスクリプトがダイヤルする番号。Five9 が送信する形式で記述します。実在する電話番号である必要はありません。ThunderPhone 上で電話番号として、または別のエンドポイントで、すでに使用されている番号は指定できません。その場合は `409` が返されます。

Five9 のアドレスはすべての顧客で共有されるため、別の Five9 顧客がこの番号へ発信した場合も、設定したエージェントに接続されます。番号を選ぶ際は、推測されにくい長い番号（最大 15 桁）を選び、Five9 が電話網へ送出せず ThunderPhone へ送信することを確認し、公開しないでください。

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

Five9 の実装チームに、次を依頼してください。

- **サードパーティ転送** モジュールから `sip:+14155550188@sip.thunderphone.com` へ通話を送信し、リクエスト URI と `To` ヘッダーの両方に番号を指定する。このモジュールは、プロバイダーの SIP ドメインをヘッダーに含めて番号を受け取ります。
- TLS（ポート 5061）または TCP（ポート 5060）で送信する。エンドポイントは UDP を受け付けず、Five9 は使用するトランスポートを公開していないため、UDP ではないことを確認してください。
- **サードパーティ通話後に戻る**を有効にし、エージェントが切断したときにスクリプトを続行するようにする（Five9 ではサードパーティ通話を最大 3,600 秒まで許可しています）。

Five9 のガイドには、送信する値（`call.ANI`、`call.DNIS`、`call.call_id`、`call.session_id`、`call.campaign_name` など）は記載されていますが、ヘッダー名は記載されていません。他社 AI プロバイダーの Five9 連携では、実際の SIP メッセージ上で `X-CallANI`、`X-CallDNIS`、`X-CallID`、`X-CallSessionID`、`X-CallCampaign`、`X-AgentID` として記録されています。最初のテスト通話で確認してください。各値は `{{sip_x_callcampaign}}` のような変数としてプロンプトに渡されます。`X-CallID` は通話の `external_call_id` として保存されます。

## 3. 通話を戻す

エージェントが通話を戻します。別れの挨拶をして通話を切断し、`BYE` に Five9 のスクリプトが読み取る 4 つのヘッダーを含めます。次の転送番号を追加します（[転送番号を追加](/ja/guides/contact-centers/overview)を参照）。

```json
{
  "name": "Five9 agent",
  "action": "return",
  "headers": {
    "X-RouteType": "SkillTransfer",
    "X-RouteValue": "Support",
    "X-RouteReason": "{{handoff_intent}}",
    "X-CustomMetaData": "handoff_id={{handoff_id}}"
  }
}
```

- `X-RouteType` と `X-RouteValue` は、発信者の転送先をスクリプトに指定します。この例では Support スキルです。他のプロバイダーが `X-RouteType` に指定できる値として文書化しているものには、`SkillTransfer`、`PhoneTransfer`、`Hangup`、`DispositionOnly` があります。値はスクリプトの管理者と合意してください。複数の転送先を設定する場合は、転送先ごとに異なる名前と `X-RouteValue` を指定した return を追加します。
- `X-RouteReason` には、`billing_dispute` などのエージェントのインテントラベルを含めます。
- `X-CustomMetaData` にはハンドオフ ID を含めます。`BYE` にも `X-TP-Handoff-Id` として含まれますが、Five9 はこれを読み取りません。

Five9 のスクリプトは、4 つのヘッダーを通話変数にマッピングします。エージェントの要約を取得するには、IVR の **クエリ** モジュールでハンドオフ検索を呼び出すようスクリプトを設定します。
`GET https://api.thunderphone.com/v1/calls/handoff?external_call_id=` の後に
`call.call_id` を付加し、`Authorization: Bearer` と API キーを送信する Authorization Profile を使用します。[ハンドオフされた通話を検索](/api-reference/calls#look-up-a-handed-off-call)を参照してください。

## テストする

IVR スクリプトに電話をかけ、エージェントに担当者を依頼して、通話変数が入力された状態でスクリプトが発信者をルーティングすることを確認します。通話がエージェントに到達しない場合は、リクエスト URI と `To` ヘッダーの番号が着信番号と一致していること、Five9 の送信元アドレスが `allowed_source_cidrs` に含まれていること、通話が TCP または TLS 経由で行われたことを確認します。次に `GET /v1/calls/{call_id}` で通話を開きます。`sip_headers` には `x-callid` が表示され、`external_call_id` は Five9 の `call.call_id` と一致している必要があります。

## 制限事項

- Five9 のガイドでは `BYE` 上のルーティングデータを説明していますが、`REFER` の受け入れには触れていません。そのため、通話の戻しはスクリプトによるコールド転送です。
- Five9 が読み取るのは `X-RouteType`、`X-RouteValue`、`X-RouteReason`、`X-CustomMetaData` であり、`User-to-User` ではありません。ThunderPhone が送信する各ヘッダー値は最大 256 バイトです。
- Five9 は、パケットの断片化を避けるため、カスタムヘッダーを約 10 個に抑えることを推奨しています。
