Open in
Genesys Cloud から接続
会話 ID と UUI を含む Genesys Cloud 通話を BYOC Cloud トランク経由で ThunderPhone エージェントに送信し、UUI 内のハンドオフ情報を使って通話を戻します。
Architectフローは、会話IDと設定したUUIを含めて、BYOC Cloudトランク経由で発信者をエージェントに送信します。発信者に担当者が必要になった場合、エージェントはSIP REFER を送信し、Genesysが通話を引き戻すと、引き継ぎIDが通話のUUIに届きます。
開始前の準備
- ThunderPhoneエージェントと組織のAPIキー。
- BYOC Cloudを備えたGenesys Cloudと、以下の設定を有効にした外部トランク(タイプはBYOC Carrierまたは
PBX)
(外部トランク設定):
- 会話ヘッダー: Genesysが会話IDを
x-inin-cnvで送信できるようにします。デフォルトでは無効です。 - UUIパススルー: ヘッダータイプを
User-To-User、エンコーディングをHexに設定します。 - 引き戻しと転送: Genesysがエージェントの
REFERを受け入れられるようにします。
- 会話ヘッダー: Genesysが会話IDを
1. SIPエンドポイントを作成する
Genesysはダイジェストチャレンジに応答するため、標準エンドポイントを使用します。
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フローで、次の手順を実行します。
- 必要に応じて、エージェント用のコンテキストを含む UUIデータを設定 アクションを追加します。例:
account=12345。Genesysでは128文字以下が推奨されています。 - エンドポイントの
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 を送信して転送します。次の転送番号を追加します(転送番号を追加するおよび転送アドレス内のヘッダーを参照)。
{
"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をフロー変数にマッピングします。
引き継がれた通話を検索するを参照してください。
テスト
フローに到達する番号へ発信し、エージェントに担当者を尋ねて、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 は常に収まります。