Todoist

  将聊天机器人与 Todoist 整合，创建和修改任务、发表评论等。

## 从版本`0.x`迁移到`1.x`。

如果您要从版本`0.x`迁移到`1.x`，请注意以下变动：

> 任务创建 "操作已被 "创建新任务 "操作取代。

## 配置

### 使用 OAuth 自动配置

要使用 OAuth 设置 Todoist 集成，请单击授权按钮并按照屏幕提示将Botpress 聊天机器人连接到 Todoist。

使用 OAuth 配置您的机器人时，您可以使用您的用户账户或专门为您的机器人创建的用户账户登录。
请记住，如果使用您的用户账户登录，机器人的操作和评论将显示为您的操作和评论。
在大多数情况下，建议为机器人专门创建一个用户账户。您必须邀请机器人的用户加入共享项目，这样它才能发表评论、执行操作等。

### 使用个人 API 令牌手动配置

1.创建 Todoist 应用程序
   - 在[应用程序管理页面](https://developer.todoist.com/appconsole.html)创建应用程序。
   - 复制用户的个人 API 令牌或在应用程序管理页面生成一个测试令牌。
2.TodoistBotpress 集成配置
   - 在Botpress 机器人中安装 Todoist 集成。
   - 在配置字段中粘贴之前复制的 API 令牌。这是您的机器人用于发布评论、更新或创建任务等的令牌。
   - 保存配置。
   - 复制机器人的Webhook URL。
3.Todoist 应用程序Webhook 配置
   - 进入 Todoist 应用程序的应用程序管理页面。
   - 确保 Webhooks 事件已激活。请按照 Todoist 提供的 [这些说明](https://developer.todoist.com/sync/v9/#webhooks) 进行操作。
   - 将之前复制的Webhook URL 粘贴到 _Webhook 回调 URL_ 字段。
   - 检查以下_已观察事件_：
     - _item:added_；
     - _item:updated_；
     - _item:completed_；
     - _note:addded_。
   - 保存Webhook 配置。

## 限制

标准 Todoist API 限制适用于Botpress 中的 Todoist 集成。这些限制包括速率限制、有效负载大小限制以及 Todoist 施加的其他限制。请确保您的聊天机器人遵守这些限制，以保持最佳性能和可靠性。

更多详情请参阅 [Todoist 开发者文档](https://developer.todoist.com/rest/v2/#request-limits)。