> This is a page from the ElevenLabs documentation. For an index of the documentation, fetch https://elevenlabs.io/docs/llms.txt.

# Twenty

接待员可以识别已存在于 Twenty 中的来电者，并将新来电者添加为联系人，记录其姓名、电话号码和来电原因，以便销售团队跟进。Reception 通过 Twenty 内置的 [MCP 服务器](/docs/zh/reception-ai/integrations/mcp-server) 连接，适用于 Twenty Cloud 和自托管的 Twenty。也可以为 Twenty 的 REST API 构建 [Webhook 工具](/docs/zh/reception-ai/integrations/webhooks)，但 MCP 服务器所需设置更少：它为接待员提供用于查找和添加联系人的现成工具，已与工作区字段匹配，包括下方的来电原因字段。

## 设置

### 添加来电原因字段

Twenty 中的联系人没有自己的备注字段。要在联系人记录中保存来电原因，请前往 **Settings** → **Data model**，打开 **People**，然后添加一个名为 `Call reason` 的 **Text** 字段。只有工作区管理员可以更改数据模型。

### 为 Reception.ai 创建角色

前往 **Settings** → **Members** → **Roles**，创建一个只能读取和创建联系人的角色。下一步将为其分配 API 密钥。

### 创建 API 密钥

前往 **Settings** → **Developers** → **API**，然后选择 **+ Create key**。为其命名，例如 `Reception.ai`，并立即复制：Twenty 只会显示一次。然后打开创建的角色，前往其 **Assignment** 标签页，并为其分配该密钥。

> **Warning**
>
> API 密钥可以读取和修改其角色允许的一切内容。请勿将其放入共享文档中，
> 若发生泄露，请在 Twenty 中将其删除。

### 添加 MCP 服务器

在 Reception.ai 中，前往 **Integrations**，选择 **Add integration**，然后选择 **MCP Server**。

| 字段               | 值                    |
| ---------------- | -------------------- |
| **Name**         | Twenty               |
| **Server type**  | Streamable HTTP      |
| **Server URL**   | 工作区地址后加上 `/mcp`，如下所示 |
| **Secret Token** | API 密钥               |

| Twenty 运行位置  | 服务器 URL                                       |
| ------------ | --------------------------------------------- |
| Twenty Cloud | 工作区 URL，例如 `https://mycompany.twenty.com/mcp` |
| 自托管          | 实例的公网 URL，例如 `https://crm.example.com/mcp`    |

可以在 Twenty 的 **Settings** → **AI** → **MCP** 中复制准确地址。请勿在 URL 中添加 `?mode=meta`：该模式会向接待员提供一个可运行任何操作的单一工具。

选择 **Enable**。Reception.ai 会将该密钥作为 bearer token 发送，并列出 Twenty 的工具。

### 分配工具

Twenty 会为每个对象的每项操作列出一个工具。打开 **Tools** 标签页，只将以下工具分配给 **Client**（接待员）：

* `find_many_people`：按电话号码查找来电者。
* `create_one_person`：添加包含姓名、电话号码和来电原因的新来电者。

不要分配更新和删除工具，以及其他对象的工具。

### 添加流程

为新潜在客户添加一项[流程](/docs/zh/reception-ai/receptionist/rules-and-procedures)：先按电话号码搜索来电者，仅在未找到匹配项时创建联系人，并始终填写名字、姓氏、电话号码和来电原因。添加一条规则，禁止接待员向来电者复述 CRM 记录。

### 测试

通过使用已保存到 Twenty 联系人中的号码来电，然后以希望获取报价的新来电者身份来电，[测试接待员](/docs/zh/reception-ai/receptionist/testing)。新联系人会显示在 **People** 下，并已填写来电原因。

## 限制

* Twenty 将国家/地区区号与号码其余部分分开存储。未保存国家/地区区号或采用不同格式保存的来电者可能无法被找到，因此回访来电者可能被重复添加。
* 在此设置中，接待员不会创建备注、任务或商机。团队可从 **People** 列表中跟进新联系人，例如使用按 **Call reason** 筛选的视图。
* 自托管实例需要使用包含 MCP 服务器的 Twenty 版本，且公网 URL 必须能通过 HTTPS 从互联网访问。
* Twenty 的 API 每分钟允许 100 个请求。使用其他集成的繁忙工作区可能会达到此限制。

## 故障排除

| 问题       | 检查项                                                                                |
| -------- | ---------------------------------------------------------------------------------- |
| 未列出工具    | 使用 **Streamable HTTP** 服务器类型，并检查 URL 是否以 `/mcp` 结尾。对于自托管，`SERVER_URL` 设置必须为公网 URL。 |
| 工具返回权限错误 | 该密钥的角色无权读取或创建联系人。在 **Settings** → **Members** → **Roles** 中编辑角色。                   |
| 未找到已知来电者 | 使用包含国家/地区区号的统一格式存储电话号码。                                                            |
| 来电原因为空   | 添加 `Call reason` 字段后选择 **Refresh tools**，然后在已更改的工具上选择 **Update**。                  |
| 已更改密钥    | 编辑集成并使用 **Rotate Secret Token (optional)**。保存的密钥不会再次显示。                            |