> 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 支持两类功能不同的 Twilio 电话号码：

### 已购买的 Twilio 号码（全面支持）

* **呼入电话**：支持——可接听电话并将其路由至智能体
* **外呼电话**：支持——可通过智能体拨打电话
* **要求**：号码必须通过 Twilio 购买，并显示在“Phone Numbers”部分

### 已验证的来电显示号码（仅外呼）

* **呼入电话**：不支持——无法接听电话或分配给智能体
* **外呼电话**：支持——可通过智能体拨打电话
* **要求**：号码必须在 Twilio 的“Verified Caller IDs”部分完成验证
* **使用场景**：适合使用现有企业号码进行外呼 AI 电话

请参阅 Twilio 文档，了解更多[大规模验证来电显示号码](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 中已[验证的来电显示号码](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 Token：** Twilio Auth Token 或 API Key Secret。

> **Tip**
>
> **建议：使用 API 密钥以提高安全性。** 与其使用账户级凭据，不如创建权限受限的 [Twilio API 密钥](https://www.twilio.com/docs/iam/api-keys)。创建 API 密钥后，Twilio 会提供一个 **SID**（以 `SK` 开头）和一个 **Secret**，请将其填入上述字段。

> **Note**
>
> 可在 [**Twilio 管理控制台**](https://www.twilio.com/console)中找到账户 SID 和 Auth Token，也可以在 [API 密钥部分](https://www.twilio.com/console/project/api-keys)创建 API 密钥。

#### 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 中验证为来电显示号码的号码
>
> 如果在任一类别中都找不到该号码，将收到错误提示，要求确认该号码存在于 Twilio 账户中。

#### 分配智能体（仅支持呼入的号码）

如果电话号码支持呼入电话，可以分配一个智能体来处理来电。

![为呼入电话选择智能体](/docs/_fern-img/b85c122ef8607527041516e789b0a19047cbf85a13cd3237ee5a7670683815a7.webp)

> **Note**
>
> 仅支持外呼电话的号码（已验证的来电显示号码）无法分配给智能体，并会在智能体下拉菜单中显示为已禁用。

拨打该电话号码以测试智能体。现在，智能体已可处理呼入电话并与客户互动。

> **Tip**
>
> 请在[通话记录 控制台](https://elevenlabs.io/app/agents/history)中监控前几次通话，确保一切按预期运行。

## 发起外呼电话

> **Info**
>
> 已购买的 Twilio 号码和已验证的来电显示号码都可用于外呼电话。不支持外呼的号码，其外呼按钮将被禁用。

导入的 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**
>
> 外呼电话会与呼入电话一同显示在[通话记录控制台](https://elevenlabs.io/app/agents/history)中，方便查看所有对话。

> **Note**
>
> 发起外呼电话时，智能体将作为对话发起方，因此请确保已为智能体配置合适的初始消息，以有效开启对话。