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

# Trello

当来电者要求回电、报价或其他需要团队跟进的事项时，接待员可以将卡片添加到 Trello 列表中。[Webhook 工具](/docs/zh/reception-ai/integrations/webhooks)会通过 Trello 的 REST API 创建卡片。

## 开始前

### 获取 API 密钥

前往 [Power-Up 管理门户](https://trello.com/apps/admin)，为工作区创建一个 Power-Up（名称无关紧要），打开其 **Trello Auth** 标签页，然后选择 **生成新的 API 密钥**。

### 生成令牌

选择 API 密钥旁的 **Token** 链接，或在浏览器中打开以下 URL，并将 `API_KEY` 替换为 API 密钥：

```
https://trello.com/1/authorize?expiration=never&scope=read,write&response_type=token&name=Reception&key=API_KEY
```

选择 **允许** 并复制令牌。它可以读取和更改你有权限访问的所有看板，因此建议使用仅加入所需看板的账户生成令牌。

### 查找列表 ID

在浏览器中打开看板，在其 URL 末尾添加 `.json`，然后加载页面。搜索列表名称；旁边的 `id` 值就是列表 ID。

## 创建 Webhook 工具

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

| 字段         | 值                                                                                          |
| ---------- | ------------------------------------------------------------------------------------------ |
| **名称**     | `create_trello_card`                                                                       |
| **描述**     | "每当你承诺会跟进来电者，或来电者提出需要团队处理的事项时，为团队创建卡片。"                                                    |
| **方法**     | POST                                                                                       |
| **URL**    | `https://api.trello.com/1/cards?idList=LIST_ID`                                            |
| **请求标头**   | `Authorization`：`OAuth oauth_consumer_key="API_KEY", oauth_token="TOKEN"`                  |
| **正文参数**   | `name`（字符串，必填）：「包含来电者姓名及其需求的简短标题，例如：致电 Jane Doe 跟进报价。」  `desc`（字符串，必填）：「来电者的姓名、电话号码及请求详情。」 |
| **分配给智能体** | **接待员**                                                                                    |

请直接在 URL 字段中输入 `?idList=LIST_ID`，并替换为列表 ID。不要将 `idList` 添加为查询参数：查询参数由 AI 填充，而 URL 中的文本会完全按原样发送。

> **Note**
>
> Trello 也接受在 URL 中使用密钥和令牌，例如 `&key=API_KEY&token=TOKEN`。这同样有效，
> 但使用标头可避免将它们放入 URL 中。如果将它们放在 URL 里，请将整个 URL
> 视为机密。

选择 **启用**，然后通过要求回电来[测试接待员](/docs/zh/reception-ai/receptionist/testing)。卡片会出现在列表底部。

## 故障排除

| 问题                         | 检查项                                           |
| -------------------------- | --------------------------------------------- |
| Trello 返回 401              | 检查标头：密钥和令牌都必须用双引号括起，并以逗号和空格分隔。如果令牌已被撤销，请重新生成。 |
| `invalid value for idList` | URL 中的列表 ID 错误。请使用列表的 `id`，而不是看板的。            |
| Trello 返回 404 或无访问权限       | 令牌对应的用户必须是该看板成员。                              |
| 接待员从不创建卡片                  | 在工具描述中明确应创建卡片的情况。                             |