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 callback URL_ 欄位。
   - 檢查下列 _Watched Events_：
     - _item:added_；
     - _item:updated_；
     - _item:completed_；
     - _note:added_.
   - 儲存Webhook 設定。

## 限制

標準的 Todoist API 限制適用於Botpress 中的 Todoist 整合。這些限制包括速率限制、有效負載大小限制，以及 Todoist 施加的其他限制。請確保您的聊天機器人遵守這些限制，以維持最佳效能與可靠性。

更多詳情請參閱 [Todoist 開發者文件](https://developer.todoist.com/rest/v2/#request-limits)。