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

# Todoist

当来电者要求回电、报价或其他需要跟进的事项时，接待员可以在 Todoist 中添加任务。[Webhook 工具](/docs/zh/reception-ai/integrations/webhooks)会通过 Todoist 的 API 创建任务。

## 开始前

### 复制 API 令牌

在 Todoist 中，打开 **设置** → **集成** → **开发者**，然后复制 **API 令牌**。它可完全访问 Todoist 账户，请妥善保密。

### 查找项目 ID

在 Todoist 网页应用中打开项目。URL 最后一个短横线后的部分就是 ID：例如，`app.todoist.com/app/project/callbacks-6Jf8VQXxpwv56VQ7` 中的 ID 是 `6Jf8VQXxpwv56VQ7`。如果要将任务添加到收件箱，请跳过此步骤。

## 创建 Webhook 工具

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

| 字段         | 值                                                                                                                                                                                                               |
| ---------- | --------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------- |
| **名称**     | `create_todoist_task`                                                                                                                                                                                           |
| **描述**     | "每当你承诺会跟进来电者，或来电者提出需要团队处理的事项时，为团队创建任务。"                                                                                                                                                                         |
| **方法**     | POST                                                                                                                                                                                                            |
| **URL**    | `https://api.todoist.com/api/v1/tasks`                                                                                                                                                                          |
| **请求标头**   | `Authorization`：`Bearer `，后接 API 令牌                                                                                                                                                                             |
| **正文参数**   | `content`（字符串，必填）："包含来电者姓名及其需求的简短标题，例如：致电 Jane Doe 跟进报价。"  `description`（字符串，必填）："来电者的姓名、电话号码及请求详情。"  `due_string`（字符串）：「用自然语言说明跟进时间，例如：明天上午 10 点。如果来电者未说明，则留空。」  `project_id`（字符串，必填）：「始终使用准确的值 `PROJECT_ID`。」 |
| **分配给智能体** | **接待员**                                                                                                                                                                                                         |

将 `PROJECT_ID` 替换为项目 ID，或移除 `project_id` 以将任务添加到收件箱。

选择 **启用**，然后通过要求明天回电来[测试接待员](/docs/zh/reception-ai/receptionist/testing)。任务会出现在项目中，并带有截止日期。

## 故障排除

| 问题                   | 检查项                                                                                  |
| -------------------- | ------------------------------------------------------------------------------------ |
| Todoist 返回 401       | 标头值必须是 `Bearer `，后接令牌。如果重置过令牌，请重新复制。                                                 |
| Todoist 返回 400 或 404 | 检查项目 ID，以及 URL 是否为 `https://api.todoist.com/api/v1/tasks`。旧指南使用的是之前的 `/rest/v2/` 地址。 |
| 任务的截止日期不正确           | Todoist 会按照账户的时区读取 `due_string`。请在 **设置** → **常规** 中检查。                              |
| 接待员从不创建任务            | 在工具描述中明确应创建任务的情况。                                                                    |