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

# Brevo

接待员可通过 Brevo 向来电者发送短信，例如地址或通话中达成事项的摘要。[webhook 工具](/docs/zh/reception-ai/integrations/webhooks)会发送 SMS。如需查询和保存联系人，请连接 Brevo 的 [MCP 服务器](/docs/zh/reception-ai/integrations/mcp-server)。

> **Warning**
>
> 仅向主动要求短信或在通话中同意接收短信的来电者发送消息，并确保这些消息为
> 事务性消息，不含促销内容。营销短信需要事先获得同意并提供退订方式，须遵守
> 美国 TCPA、欧盟 GDPR 等规定。启用前请确认适用于业务的规定。

## 发送后续短信

### 准备 Brevo 账户

SMS 使用预付费积分。在 Brevo 中购买 SMS 积分，并确认可向要发送短信的国家或地区发送 SMS。部分国家或地区（如美国和加拿大）不接受自定义发件人名称。

### 创建 API 密钥

在 Brevo 中，打开 **SMTP & API** → **API Keys**，然后选择 **Generate a new API key**。此密钥不要启用 **Create MCP server API key**。复制以 `xkeysib-` 开头的密钥。

### 创建 webhook 工具

前往 **集成**，选择 **添加集成**，然后选择 **Webhook Tool**。

| 字段         | 值                                                                                                                                                                                                            |
| ---------- | ------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------ |
| **名称**     | `send_followup_text`                                                                                                                                                                                         |
| **说明**     | "向来电者发送短信。仅当来电者要求发送短信或同意接收短信时使用。绝不发送促销内容。"                                                                                                                                                                   |
| **方法**     | POST                                                                                                                                                                                                         |
| **URL**    | `https://api.brevo.com/v3/transactionalSMS/send`                                                                                                                                                             |
| **请求标头**   | `api-key`：API 密钥  `accept`：`application/json`                                                                                                                                                                |
| **正文参数**   | `sender`（字符串，必填）：“始终使用准确的值 `YOUR_SENDER`。”  `recipient`（字符串，必填）：“来电者的手机号码，包含国家代码，仅限数字，不含 `+` 或空格。例如 14155550123。”  `content`（字符串，必填）：“短信内容，不超过 160 个字符。以企业名称开头。”  `type`（字符串，必填）：“始终使用准确的值 `transactional`。” |
| **分配给智能体** | **接待员**                                                                                                                                                                                                      |

将 `YOUR_SENDER` 替换为发件人名称（最多 11 个字母和数字）或发送号码（最多 15 位数字）。

### 测试

选择 **启用**，然后使用自己的手机号码，要求接待员通过短信发送地址，以此[测试接待员](/docs/zh/reception-ai/receptionist/testing)。可在 Brevo 的 SMS 日志中查看送达情况。

超过 160 个字符的消息会分为多条短信发送，每条都会消耗积分。

## 查询和保存联系人

### 创建 MCP 密钥

在 Brevo 中，打开 **SMTP & API** → **API Keys**，选择 **Generate a new API key**，然后启用 **Create MCP server API key**。复制密钥。

> **Warning**
>
> MCP 密钥拥有 Brevo 账户的完整读取和写入权限。请将其与 SMS 密钥分开，并且只连接下方的联系人模块。

### 添加 MCP 服务器

在 Reception.ai 中，前往 **集成**，选择 **添加集成**，然后选择 **MCP Server**。

| 字段          | 值                                             |
| ----------- | --------------------------------------------- |
| **名称**      | Brevo 联系人                                     |
| **服务器类型**   | Streamable HTTP                               |
| **服务器 URL** | `https://mcp.brevo.com/v1/brevo_contacts/mcp` |
| **密钥令牌**    | MCP 密钥                                        |

选择 **启用**。Reception.ai 会将密钥作为 Bearer 令牌发送，并列出 Brevo 的联系人工具。

### 分配工具

打开 **工具** 标签页。将查询和创建联系人的工具分配给 **Client**（接待员）。不要分配删除联系人或更改列表的工具，或者仅将其分配给 **Assistant**。

> **Note**
>
> `https://mcp.brevo.com/v1/brevo/mcp` 会公开所有 Brevo 模块，包括电子邮件营销活动。仅当希望团队通过 **Assistant** 管理营销活动时才使用它。

## 故障排除

| 问题           | 检查项                                                              |
| ------------ | ---------------------------------------------------------------- |
| Brevo 返回 401 | 标头名称必须为 `api-key`。如果 Brevo 提及无法识别的 IP 地址，请检查 Brevo 安全设置中的已授权 IP。 |
| Brevo 返回 400 | 检查号码是否包含国家代码且不含 `+`，并确认发件人名称不超过 11 个字符。                          |
| 短信始终未送达      | 检查 SMS 积分，以及 Brevo 是否可使用该发件人向该国家或地区发送 SMS。                       |
| 未列出 MCP 工具   | 请使用 **Streamable HTTP** 和 MCP 密钥，而不是 SMS 密钥。                     |
| 已更改 MCP 密钥   | 编辑集成并使用 **轮换密钥令牌（可选）**。保存的令牌不会再次显示。                              |