跳到导航

Todoist

使用 webhook 工具将来电者请求转为 Todoist 任务。

当来电者要求回电、报价或其他需要跟进的事项时,接待员可以在 Todoist 中添加任务。Webhook 工具会通过 Todoist 的 API 创建任务。

开始前

1

复制 API 令牌

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

2

查找项目 ID

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

创建 Webhook 工具

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

字段值
名称create_todoist_task
描述”每当你承诺会跟进来电者,或来电者提出需要团队处理的事项时,为团队创建任务。“
方法POST
URLhttps://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 以将任务添加到收件箱。

选择 启用,然后通过要求明天回电来测试接待员。任务会出现在项目中,并带有截止日期。

故障排除

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