Open in
Five9から接続
AI Agent Connectを使用して、Five9の通話をSIP経由でThunderPhoneエージェントに送信し、IVRスクリプトが読み取るルーティングヘッダー付きで通話を戻します。
Five9 の IVR スクリプトは、Five9 の通話詳細とともに発信者をエージェントへ送ります。エージェントの処理が完了すると、SIP BYE にルーティングヘッダーを付加して切断します。スクリプトはそのヘッダーを通話変数に読み込み、発信者をルーティングします。
開始前に必要なもの
- ThunderPhone エージェントと組織の APIキー。
- Five9 の AI Agent Connect アドオン。Five9 は利用を認定済みの AI プロバイダーに限定しており、Five9 の実装チームが設定を行います。プロバイダーの IVR スクリプトテンプレートをインポートし、通話変数を作成して、スクリプトの サードパーティ転送 モジュールをプロバイダーに向けます。ThunderPhone はまだ Five9 の認定リストに含まれていません。導入計画に組み込む前に、Five9 のアカウントチームまたは ThunderPhone サポートへ確認してください。
1. SIP エンドポイントを作成する
Five9 のサードパーティ転送モジュールは SIP アドレスではなく電話番号へ発信します。また、他社の Five9 連携ではパスワードではなく送信元アドレスで Five9 を認証します。そのため、Five9 がダイヤルする番号をダイヤルイン番号として指定した ip_allowlist エンドポイントを作成します(電話番号へ発信するプラットフォームを参照)。
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 つのヘッダーを含めます。次の転送番号を追加します(転送番号を追加を参照)。
{
"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 を使用します。ハンドオフされた通話を検索を参照してください。
テストする
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 個に抑えることを推奨しています。