ThunderPhone v3、提供開始。セルフサービスで、1分あたり2セントから。発表内容を見る

Contact centers

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 を受け入れられるようにします。

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フローで、次の手順を実行します。

  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 を送信して転送します。次の転送番号を追加します(転送番号を追加するおよび転送アドレス内のヘッダーを参照)。

{
  "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 は常に収まります。