---
title: "コンタクトセンター"
description: "Amazon Connect、Five9、Genesys Cloud、Talkdesk、Twilio、Microsoft Dynamics 365、NICE CXone、またはZoom Contact Centerからの通話をSIP経由でThunderPhoneエージェントに送信し、エージェントの転送で通話を戻せます。"
---

ThunderPhone エージェントは、コンタクトセンターのコールフロー内で通話に応答できます。
プラットフォームは、独自の通話 ID と発信者について把握しているその他の情報を含む SIP ヘッダーを使用して、
エージェントの [SIP アドレス](/ja/guides/sip-addresses)に通話を送信します。発信者に担当者が必要な場合、エージェントは
ハンドオフによって通話を返します。ハンドオフには、発信者の要件の要約、短いインテントラベル、およびフローで参照できる ID が含まれます。

## プラットフォーム

| プラットフォーム | 通話の到着方法 | 通話 ID ヘッダー | 通話の戻し方 | コンテキストの戻し方 |
|---|---|---|---|---|
| [Amazon Connect](/ja/guides/contact-centers/amazon-connect) | 外部音声転送コネクタ、IP 許可リスト | `X-Amzn-ConnectContactId` | 戻り: エージェントが通話を終了し、フローが再開 | Lambda がハンドオフ参照を呼び出す |
| [Five9](/ja/guides/contact-centers/five9) | Five9 が設定する AI Agent Connect からダイヤルイン番号へ、IP 許可リスト | `X-CallID` | 戻り: エージェントが `BYE` のルーティングヘッダー付きで通話を終了 | `X-Route*` および `X-CustomMetaData` ヘッダーを IVR 通話変数に渡す |
| [Genesys Cloud](/ja/guides/contact-centers/genesys-cloud) | BYOC Cloud トランク、ダイジェスト認証 | `x-inin-cnv` | `REFER`、取り戻しと転送で受理 | 転送先アドレス内の 16 進数 UUI、その後データアクション |
| [Talkdesk](/ja/guides/contact-centers/talkdesk) | Autopilot Voice へ接続、IP 許可リスト | `X-Talkdesk-Interaction-Id` | Talkdesk の有人エージェント用アドレスに `REFER` | 転送先アドレス内の 16 進数 UUI、その後アクションを実行 |
| [Twilio](/ja/guides/contact-centers/twilio) | `<Dial><Sip>`、ダイジェスト認証 | 追加する `X-Call-ID` | `referUrl` ハンドラーに `REFER` | 転送先アドレス内のヘッダー（`ReferTransferTarget`） |
| [Microsoft Dynamics 365](/ja/guides/contact-centers/microsoft-dynamics-365) | SBC 経由で電話番号に転送、ダイジェスト認証 | 追加する `X-Call-ID` | 戻り後、SBC が発信者をルーティングして戻す | HTTP Request ノードがハンドオフ参照を呼び出す |
| [NICE CXone](/ja/guides/contact-centers/nice-cxone) | ダイヤルイン番号への `Sipputheader` を使用した Studio `Placecall`、IP 許可リスト | 追加する `X-Call-ID` | 戻り: エージェントが通話を終了（スクリプトが発信者を戻す方法は NICE に確認） | REST API アクションがハンドオフ参照を呼び出す |
| [Zoom Contact Center](/ja/guides/contact-centers/zoom-contact-center) | Zoom が構築するトランク上のボットウィジェットからダイヤルイン番号へ、SRTP 対応 IP 許可リスト | `X-ZOOM-Call-Sid` | Zoom の有人エージェント用アドレスに `REFER` | HTTP Call ウィジェットがハンドオフ参照を呼び出す |

## 仕組み

1. API、アプリの **電話とウェブ** → **SIPエンドポイント**、または Zeus への依頼で、エージェント用の **SIP エンドポイントを作成**します。パスワードチャレンジに応答できるプラットフォームでは、エンドポイントのユーザー名とパスワードを使用します。送信元アドレスのみで識別するプラットフォームでは、`auth` を `ip_allowlist` に設定したエンドポイントを使用します。詳細は
   [送信元 IP で認証するプラットフォーム](/ja/guides/sip-addresses)を参照してください。
   SIP アドレスではなく電話番号に発信するプラットフォームは、エンドポイントの
   [ダイヤルイン番号](/ja/guides/sip-addresses)を通じてエンドポイントに接続します。
2. **コンテキスト付きで通話を送信**します。プラットフォームはエンドポイントの `sip_uri` またはダイヤルイン番号に発信します。
   送信するすべての `X-` ヘッダーと `User-to-User` は、プロンプトで使用できる `{{sip_…}}` 通話変数になります。また、call-id ヘッダーは通話の `external_call_id` として保存されます。詳細は
   [SIP ヘッダーで通話コンテキストを渡す](/ja/guides/sip-addresses)を参照してください。
3. **通話を戻す転送先番号を 1 つ追加**します。プラットフォーム上の SIP アドレス（エージェントが `REFER` を送信）または
   [戻す](/ja/guides/call-transfers)
   （エージェントが通話を終了し、フローを継続）のいずれかを指定します。そのヘッダーには
   `{{handoff_summary}}`、`{{handoff_intent}}`、`{{handoff_id}}` を含められます。詳細は
   [コンタクトセンターにコンテキストを渡す](/ja/guides/call-transfers)を参照してください。
4. **引き継ぎ情報を確認**します。プラットフォームが保存する場所で確認するか、プラットフォームの通話 ID で検索します。

### 転送番号を追加する

SIPアドレス、返却、およびそれらのヘッダーは
[Agents API](/api-reference/agents#transfer-numbers)で設定します。書き込みを行うとリスト全体が置き換えられるため、エージェントの他の転送番号も含めてからデプロイします。

```bash
curl -X PATCH https://api.thunderphone.com/v1/agents/12 \
  -H "Authorization: Bearer sk_live_YOUR_API_KEY" \
  -H "Content-Type: application/json" \
  -d '{"transfer_destinations": [{"name": "Contact center", "action": "return"}]}'

curl -X POST https://api.thunderphone.com/v1/agents/12/deploy \
  -H "Authorization: Bearer sk_live_YOUR_API_KEY"
```

次に、エージェントのプロンプトで名前を指定して、使用するタイミングを指示します。「発信者が担当者を求めた場合、または要望を解決できない場合は、Contact center に転送してください。」

### 引き継ぎを検索する

フローでは、組織のAPIキーとプラットフォームの通話IDを使用して引き継ぎを取得できます。

```bash
curl "https://api.thunderphone.com/v1/calls/handoff?external_call_id=YOUR_PLATFORM_CALL_ID" \
  -H "Authorization: Bearer sk_live_YOUR_API_KEY"
```

レスポンスには `handoff.summary`、`handoff.intent`、`handoff.handoff_id`、通話開始時のSIPヘッダーと変数、および通話終了後の要約と抽出データが含まれます。`handoff_id` でも通話を検索できます。詳細は
[引き継がれた通話を検索する](/api-reference/calls#look-up-a-handed-off-call)を参照してください。

APIキーはフロー自体ではなく、プラットフォームの認証情報ストアに保存してください。

<Warning>
  ヘッダー値は通話を送信した送信者から提供されます。プロンプト内のコンテキストとして使用し、発信者が誰であるかや何を行えるかを判断するためには使用しないでください。
</Warning>

## ガイド

<CardGroup cols={2}>
  <Card title="Amazon Connect" icon="phone" href="/ja/guides/contact-centers/amazon-connect">
    外部音声転送を受信し、復帰時にLambdaルックアップを実行。
  </Card>
  <Card title="Five9" icon="phone" href="/ja/guides/contact-centers/five9">
    AI Agent Connectを受信し、通話終了時にルーティングヘッダーを返送。
  </Card>
  <Card title="Genesys Cloud" icon="phone" href="/ja/guides/contact-centers/genesys-cloud">
    BYOC Cloudトランクを受信し、UUI付きでTake BackとTransferを返送。
  </Card>
  <Card title="Talkdesk" icon="phone" href="/ja/guides/contact-centers/talkdesk">
    Autopilot Voiceへの接続を受信し、UUI付きのエスカレーションを返送。
  </Card>
  <Card title="Twilio" icon="phone" href="/ja/guides/contact-centers/twilio">
    TwiML Dialを受信し、referUrlハンドラーへのREFERを返送。
  </Card>
  <Card title="Microsoft Dynamics 365" icon="phone" href="/ja/guides/contact-centers/microsoft-dynamics-365">
    SBC経由の転送を受信し、復帰時にHTTPルックアップを実行。
  </Card>
  <Card title="NICE CXone" icon="phone" href="/ja/guides/contact-centers/nice-cxone">
    Studio Placecallを受信し、復帰時にRESTルックアップを実行。
  </Card>
  <Card title="Zoom Contact Center" icon="phone" href="/ja/guides/contact-centers/zoom-contact-center">
    ボットウィジェットを受信し、人間のエージェントへのREFERを返送。
  </Card>
</CardGroup>
