> 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.

# Twilioネイティブインテグレーション

## 概要

このガイドでは、Twilioの電話番号をElevenLabsエージェントに接続し、着信・発信の両方の通話を処理する方法を説明します。

学べること：

* 既存のTwilio電話番号をインポートする。
* 着信通話を処理するためにエージェントへ紐付ける。
* エージェントを使って発信通話を開始する。

## 電話番号の種類と機能

ElevenLabsは、機能が異なる2種類のTwilio電話番号に対応しています：

### 購入済みのTwilio番号（フルサポート）

* **着信通話**：対応 — 通話を受信し、エージェントにルーティングできます
* **発信通話**：対応 — エージェントを使って通話を発信できます
* **要件**：Twilioで購入済みで、「Phone Numbers」セクションに表示されている必要があります

### 検証済みCaller ID（発信のみ）

* **着信通話**：非対応 — 通話を受信したり、エージェントに割り当てたりすることはできません
* **発信通話**：対応 — エージェントを使って通話を発信できます
* **要件**：Twilioの「Verified Caller IDs」セクションで番号が検証済みである必要があります
* **ユースケース**：既存のビジネス番号をAIによる発信通話に使用する場合に最適です

詳しくは、Twilioのドキュメントにある[大規模なCaller IDの検証](https://www.twilio.com/docs/voice/api/verifying-caller-ids-scale)をご覧ください。

> **Note**
>
> 電話番号のインポート時に、ElevenLabsはTwilioでの設定に基づいて、その番号で利用可能な機能を自動的に検出します。

## ガイド

### 前提条件

* [Twilioアカウント](https://twilio.com/)。
* 次のいずれか：
  * 購入・プロビジョニング済みのTwilio[電話番号](https://www.twilio.com/docs/phone-numbers)（着信＋発信向け）
  * または、Twilioで[検証済みのCaller ID](https://www.twilio.com/docs/voice/make-calls#verify-your-caller-id)（発信のみ）

#### Twilio電話番号をインポート

ElevenAgentsダッシュボードで、[**Phone Numbers**](https://elevenlabs.io/app/agents/phone-numbers)タブに移動します。

![ElevenAgentsの電話番号ページ](/docs/_fern-img/7efb681147acd8f04803f84ed7f3289f0e90eb1fb0173e2a825836408cee89d1.webp)

次に、以下の情報を入力します：

* \*\*ラベル：\*\*説明的な名前（例：`Customer Support Line`）。
* \*\*電話番号：\*\*使用するTwilio番号。
* \*\*Twilio SID：\*\*TwilioのAccount SIDまたはAPI Key SID。
* \*\*Twilioトークン：\*\*TwilioのAuth TokenまたはAPI Key Secret。

> **Tip**
>
> **推奨：セキュリティ向上のためにAPIキーを使用してください。**アカウント全体の認証情報を使用する代わりに、権限を制限した[Twilio APIキーを作成](https://www.twilio.com/docs/iam/api-keys)できます。APIキーを作成すると、Twilioから**SID**（`SK`で始まります）と**Secret**が提供されます。これらを上記のフィールドに入力してください。

> **Note**
>
> アカウントSIDとAuth Tokenは、[**Twilio管理コンソール**](https://www.twilio.com/console)で確認できます。APIキーは[API keysセクション](https://www.twilio.com/console/project/api-keys)で作成できます。

#### ElevenAgentsダッシュボード

![電話番号の設定](/docs/_fern-img/9501110d58bfeca27cb9983bc44035864504bdc2ed9c78d9decbd04802f64418.webp)

#### Twilio管理コンソール

[Twilio管理コンソール](https://www.twilio.com/console)からTwilio SIDとAuth Tokenをコピーします。

![電話番号の詳細](/docs/_fern-img/42da512d1cdfb4ca4504c3162fecfed108580d9488236a0cc6a4a1d23a19da14.webp)

> **Note**
>
> ElevenLabsはTwilio電話番号に適切な設定を自動で構成します。

#### 適用される設定

![Twilio電話番号の設定](/docs/_fern-img/b11d57a0aa588964bbd0117d2135c55592569a4bf051f00f17aa3ee632833a47.webp)

> **Info**
>
> **電話番号の検出**：ElevenLabsは、番号が以下に対応しているかを自動的に検出します：
>
> * **着信＋発信**：Twilioで購入した番号
> * **発信のみ**：TwilioでCaller IDとして検証された番号
>
> どちらのカテゴリにも番号が見つからない場合は、Twilioアカウントに番号が存在することを確認するよう求めるエラーが表示されます。

#### エージェントを割り当てる（着信対応番号のみ）

電話番号が着信通話に対応している場合、着信通話を処理するエージェントを割り当てられます。

![着信通話用のエージェントを選択](/docs/_fern-img/b85c122ef8607527041516e789b0a19047cbf85a13cd3237ee5a7670683815a7.webp)

> **Note**
>
> 発信通話のみに対応する番号（検証済みCaller ID）はエージェントに割り当てられず、エージェントのドロップダウンでは無効として表示されます。

電話番号に電話をかけてエージェントをテストします。これでエージェントは着信通話を処理し、顧客とやり取りできるようになります。

> **Tip**
>
> 最初の数件の通話は、[Calls Historyダッシュボード](https://elevenlabs.io/app/agents/history)で確認し、すべてが想定どおりに動作していることを確かめてください。

## 発信通話を行う

> **Info**
>
> 購入済みのTwilio番号と検証済みCaller IDは、どちらも発信通話に使用できます。発信に対応していない番号では、発信通話ボタンが無効になります。

インポートしたTwilio電話番号は、エージェントが指定した電話番号に電話をかける発信通話の開始にも使用できます。

#### 発信通話を開始

[**Phone Numbers**](https://elevenlabs.io/app/agents/phone-numbers)タブで、インポートしたTwilio番号を見つけ、**Outbound call**ボタンをクリックします。

![発信通話ボタン](/docs/_fern-img/953a870b0ab0c0aa30872b3692260f0879f390d4b4b83c7f82e816385504034f.webp)

#### 通話を設定

Outbound Callモーダルで、次の操作を行います：

1. 会話を処理するエージェントを選択します
2. 電話をかける電話番号を入力します
3. **Send Test Call**をクリックして通話を開始します

![発信通話の設定](/docs/_fern-img/f6b01412a68217661028e6924ce90089bdd5eaa693c8aeafbc321c632de921b7.webp)

開始すると、相手にはTwilio番号から電話がかかります。応答すると、エージェントが会話を開始します。

> **Tip**
>
> 発信通話は着信通話とともに[Calls Historyダッシュボード](https://elevenlabs.io/app/agents/history)に表示されるため、すべての会話を確認できます。

> **Note**
>
> 発信通話ではエージェントが会話を開始します。会話を効果的に始められるよう、適切な初期メッセージをエージェントに設定してください。