> This is a page from the ElevenLabs documentation. For a complete page index, fetch https://elevenlabs.io/docs/llms.txt. For the full documentation in a single file, fetch https://elevenlabs.io/docs/llms-full.txt.

# Sinch SIPトランキング

> **Note**
>
> このガイドを始める前に、[ElevenLabs SIPトランキングガイド](/docs/ja/eleven-agents/phone-numbers/sip-trunking)と[Sinch Voice SIPトランキングガイド](https://developers.sinch.com/docs/voice/api-reference/sip-trunking)をお読みください。

## 概要

このガイドでは、Sinch VoiceアプリケーションをElevenLabs Agentsに直接接続する方法を説明します。このインテグレーションにより、Sinchの番号とルーティングを維持したまま、ElevenLabsがAI音声エージェントの体験を担います。

## SinchでのSIPトランキングの仕組み

Sinch SIPトランクは、SinchネットワークとElevenLabsプラットフォーム間の双方向接続です。

1. **着信通話**：Sinch Voiceアプリケーションに割り当てられたDIDに着信があります。Sinchは、トランクの着信設定で静的エンドポイントとして構成されたElevenLabsの発信元アドレスに`INVITE`を送信します。
2. **発信通話**：ElevenLabsが開始した通話は、アプリケーションの完全修飾ドメイン名（FQDN）のSIPアドレスに送信され、SinchがPSTNにルーティングします。
3. **認証**：Sinchでは発信認証（SIP認証情報）が必要で、トランクに到着するトラフィックにはACL認証（IP許可リスト）を使用できます。

## 要件

開始する前に、以下を用意してください。

1. エージェントが設定された有効なElevenLabsアカウント
2. [Sinch Buildダッシュボード](https://dashboard.sinch.com/voice/apps)で音声アプリケーションを作成済みのSinchアカウント
3. Sinchで購入し、アプリケーションに割り当てた電話番号（DID）を少なくとも1つ

## 着信通話の設定（SinchからElevenLabs）

アプリケーションの着信転送先をElevenLabs SIPアドレスに設定します。

### Sinch Buildダッシュボードにサインインする

Sinchアカウントにログインし、接続するアプリケーションに移動します。

### ElevenLabs用の静的エンドポイントを追加する

アプリケーションの着信転送設定で、通話イベントハンドラーを`SIP Forwarding`に更新し、ElevenLabsの発信元アドレスを指定する静的SIP URIを追加します。

* **DID**：発信先にするSinchの電話番号
* **アドレス**：`sip.rtc.elevenlabs.io`
* **ポートとトランスポート**：`5061/TLS`、`5060/TCP`

例：`sip:15551234567@sip.rtc.elevenlabs.io:5061;transport=tls`。

ElevenLabsワークスペースで分離されたデータレジデンシーリージョンまたは静的IPSIPインフラストラクチャを使用している場合は、`sip.rtc.elevenlabs.io`ではなく対応するエンドポイントを使用してください。利用可能なリージョンについては、[データレジデンシー](/docs/ja/overview/administration/data-residency)を参照してください。

### DIDをアプリケーションに割り当てる

エージェントに到達させる電話番号をこのアプリケーションに割り当てます。

## 発信通話の設定（ElevenLabsからSinch）

発信通話では、ElevenLabsがSinchアプリケーションにSIP `INVITE`を送信し、認証を行います。

### SinchリージョンのFQDNを確認する

Sinchリージョンの[SIP FDQN](https://developers.sinch.com/docs/voice/api-reference/sip-trunking#termination-uris)を取得します。これはElevenLabsに入力する終端アドレスです。`sip:`プレフィックスは付けず、ホスト名のみを入力してください。

### SIP認証情報を入力する

Sinchアプリケーションのキーとシークレットを安全にコピーします。ElevenLabsでは、それぞれユーザー名とパスワードとして使用します。

### 転送先番号

Sinchアプリケーションは、通話を転送先アドレスに転送します。発信通話リクエストで指定した番号に発信するには、アプリケーション設定でこのフィールドを空欄のままにしてください。

## ElevenLabsでセットアップを完了する

### SIPトランクの電話番号をインポートする

[SIPトランキングガイド](/docs/ja/eleven-agents/phone-numbers/sip-trunking)に従って、次の設定でSinch番号をインポートします。

| 設定            | 値                                                                  |
| ------------- | ------------------------------------------------------------------ |
| 電話番号          | Sinch DID。例：`15551234567`                                          |
| トランスポートタイプ    | TLS                                                                |
| メディア暗号化       | TCPの場合は`Disabled`、トランクをTLSおよびSRTP用に設定している場合は`Allowed`または`Required` |
| アドレス          | SinchトランクのFQDN。ホスト名のみ                                              |
| SIPトランクのユーザー名 | Sinchアプリケーションキー                                                    |
| SIPトランクのパスワード | Sinchアプリケーションシークレット                                                |

トランスポートと暗号化の設定は、両側で一致させてください。

### エージェントを割り当てる

[電話番号ダッシュボード](https://elevenlabs.io/app/agents/phone-numbers)で番号にエージェントを割り当てます。これでDIDへの着信はそのエージェントに届きます。

### 発信通話をテストする

電話番号メニューまたは発信通話APIを使用して、エージェントからSinchアプリケーション経由で通話を発信します。

```bash
curl -X POST https://api.elevenlabs.io/v1/convai/sip-trunk/outbound-call \
  -H "xi-api-key: $ELEVENLABS_API_KEY" \
  -H "Content-Type: application/json" \
  -d '{
    "agent_id": "agent_7101k5zvyjhmfg983brhmhkd98n6",
    "agent_phone_number_id": "phnum_8901k4t9z5defmb8vh3e9361y7nj",
    "to_number": "+15551234567"
  }'
```

完全なリクエストスキーマについては[​​SIPトランク経由の発信通話](/docs/ja/eleven-agents/api-reference/sip-trunk/outbound-call)を、発信キャンペーンの実行については[一括通話](/docs/ja/eleven-agents/phone-numbers/batch-calls)を参照してください。

## 転送の設定

エージェントは[`transfer_to_number`](/docs/ja/eleven-agents/customization/tools/system-tools/transfer-to-number)システムツールを使用して、通話を担当者に引き継ぎます。

> **Warning**
>
> Sinchトランクで機能するのは会議転送のみです。SIP REFERおよびブラインド転送は失敗します。

### 会議転送

ElevenLabsはSinchトランク経由で宛先に発信し、両者を会議に接続した後、エージェントを切断します。

## 代わりにSinch Voice API v2を使用する

上記のセットアップでは、ElevenLabsが音声パス全体を担います。Sinchで通話制御を行う必要がある場合は、Sinch Voice API v2で通話に応答し、独自のロジックを適用してから、リレーサーバーなしでSVAMLを使用してElevenLabsエージェントへの第2レッグをブリッジできます。このモデルは、エージェントが参加する前に留守番電話検出、通話録音、番号マスキングなどのSinch機能を追加したい場合や、エージェントがより大きなSinch通話フローの一工程である場合に適しています。

その他の一般的なシナリオについては、Sinchの[​​SIP経由でElevenLabs AIエージェントを統合する](https://developers.sinch.com/docs/voice-2.0/tutorials/elevenlabs-sip)チュートリアルを参照してください。

## トラブルシューティング

#### 着信通話を接続できない

* トランクの静的着信エンドポイントが、使用するポートとトランスポートで`sip.rtc.elevenlabs.io`を指定していることを確認してください。
* DIDがそのトランクに割り当てられていることを確認してください。
* ElevenLabsの番号が、先頭の`+`を含めてSinchが送信する番号と一致していることを確認してください。
* エンドポイントまたはACLを変更した後は、少なくとも60秒待ってから再テストしてください。
* ファイアウォールがTCPの場合は5060、TLSの場合は5061でのSIPシグナリングを許可し、RTPをブロックしていないことを確認してください。

#### 発信通話で403または407レスポンスを受信する

* ElevenLabsのSIPトランクのユーザー名とパスワードが、Sinchトランクの認証情報と一致していることを確認してください。
* **アドレス**フィールドには、`sip:`プレフィックスなしでトランクのFQDNのみが入力されていることを確認してください。
* 宛先の国に対する国別権限がトランクで有効になっていることを確認してください。
* 表示する発信者IDが、そのトランクでSinchが受け入れる番号であることを確認してください。
* ACL認証を使用している場合、ElevenLabsのシグナリングは分散したアドレスプールから到着する点に注意してください。ダイジェスト認証に切り替えるか、静的IPインフラストラクチャに移行してください。

#### 片方向音声または音声がない

* ファイアウォールがUDP経由のRTPを双方向で許可しており、特定の静的アドレスに制限されていないことを確認してください。
* メディア暗号化が一致していることを確認してください。TLSのSinchトランクではSRTPが必要なため、ElevenLabsでメディア暗号化を`Allowed`または`Required`に設定します。
* 問題がTLSまたはSRTPに関連するものかを切り分けるため、TCPおよびメディア暗号化を無効にしてテストしてください。
* トランクでG711が提供されていることを確認してください。ElevenLabsはG711とG722をサポートしています。

#### エージェントが切断しても通話が終了しない

`BYE`に対する`481`レスポンスは通常、リクエストがその通話のダイアログ状態を持たないSIPサーバーに到達したことを意味します。共有の`sip.rtc.elevenlabs.io`アドレスではなく、`200 OK`で返された`Contact` URIにダイアログ内リクエストを送信してください。TLS経由の`BYE`または`REFER`で証明書の検証に失敗する場合は、電話番号設定の**リモートドメイン**フィールドに、トランクの証明書が発行されているFQDNを追加してください。

## よくある質問

#### どのトランスポートを使用すべきですか？

本番環境では、SinchトランクでSRTPメディアと組み合わせた5061のTLSを使用してください。検証の開始点としては、5060のTCPが適しています。UDPはElevenLabsでは実験的な機能であり、本番トラフィックには使用しないでください。

#### 互換性のあるオーディオコーデックはどれですか？

ElevenLabsはG711（8kHz）とG722（16kHz）をサポートしています。共通のコーデックとして、SinchトランクでG711を提供し続けてください。

#### 発信者コンテキストを会話に渡すにはどうすればよいですか？

着信`INVITE`のカスタム`X-`ヘッダーは動的変数として公開されます。たとえば、`X-Contact-ID`は`{{sip_contact_id}}`になります。`X-Call-ID`と`X-Caller-ID`は、`system__call_sid`と`system__caller_id`にマッピングされます。完全な正規化ルールについては、[SIPトランキング](/docs/ja/eleven-agents/phone-numbers/sip-trunking)を参照してください。

## 便利なリンク

* [SIPトランキングガイド](/docs/ja/eleven-agents/phone-numbers/sip-trunking)
* [SIPリファレンス](/docs/ja/eleven-agents/phone-numbers/sip-reference)
* [番号への転送](/docs/ja/eleven-agents/customization/tools/system-tools/transfer-to-number)
* [Sinch Voice API v2：SIP経由でElevenLabs AIエージェントを統合する](https://developers.sinch.com/docs/voice-2.0/tutorials/elevenlabs-sip)