Todoist

  Integrieren Sie Ihren Chatbot in Todoist, um Aufgaben zu erstellen und zu ändern, Kommentare zu posten und vieles mehr.

## Migration von Version `0.x` auf `1.x`

Wenn Sie von der Version `0.x` auf `1.x` migrieren, beachten Sie bitte die folgenden Änderungen:

> Die Aktion "Aufgabe erstellen" wurde durch die Aktion "Neue Aufgabe erstellen" ersetzt.

## Konfiguration

### Automatische Konfiguration mit OAuth

Um die Todoist-Integration mit OAuth einzurichten, klicken Sie auf die Schaltfläche Autorisierung und folgen Sie den Anweisungen auf dem Bildschirm, um Ihren Botpress Chatbot mit Todoist zu verbinden.

Wenn Sie Ihren Bot mit OAuth konfigurieren, können Sie sich entweder mit Ihrem Benutzerkonto oder mit einem Benutzerkonto anmelden, das Sie speziell für Ihren Bot erstellt haben.
Bitte beachten Sie, dass wenn Sie sich mit Ihrem Benutzerkonto anmelden, die Bot-Aktionen und Kommentare als Ihre eigenen erscheinen.
Für die meisten Anwendungsfälle ist es empfehlenswert, ein Benutzerkonto speziell für Ihren Bot zu erstellen. Sie müssen den Bot-Benutzer zu einem gemeinsamen Projekt einladen, damit er Kommentare posten, Aktionen durchführen usw. kann.

### Manuelle Konfiguration mit einem persönlichen API-Token

1. Todoist App-Erstellung
   - Erstellen Sie eine App auf der [App Management Seite] (https://developer.todoist.com/appconsole.html).
   - Kopieren Sie das persönliche API-Token Ihres Benutzers oder generieren Sie ein Test-Token auf der App-Verwaltungsseite.
2. Konfiguration der Todoist Botpress Integration
   - Installieren Sie die Todoist-Integration in Ihrem Botpress Bot.
   - Fügen Sie das zuvor kopierte API-Token in die Konfigurationsfelder ein. Dies ist das Token, das Ihr Bot verwenden wird, um Kommentare zu posten, Aufgaben zu aktualisieren oder zu erstellen, etc.
   - Speichern Sie die Konfiguration.
   - Kopieren Sie die Webhook URL Ihres Bots.
3. Todoist App Webhook Konfiguration
   - Gehen Sie auf die App Management Seite Ihrer App auf Todoist.
   - Stellen Sie sicher, dass die Webhooks-Ereignisse aktiviert sind. Befolgen Sie dazu [diese Anweisungen] (https://developer.todoist.com/sync/v9/#webhooks), die von Todoist bereitgestellt werden.
   - Fügen Sie die zuvor kopierte Webhook URL in das Feld _Webhook callback URL_ ein.
   - Überprüfen Sie die folgenden _Watched Events_:
     - _item:added_;
     - _Eintrag:aktualisiert_;
     - _Eintrag:abgeschlossen_;
     - _note:hinzugefügt_.
   - Speichern Sie die Konfiguration von Webhook .

## Beschränkungen

Standard Todoist API Einschränkungen gelten für die Todoist Integration in Botpress. Zu diesen Einschränkungen gehören Ratenbeschränkungen, Größenbeschränkungen der Nutzdaten und andere von Todoist auferlegte Beschränkungen. Stellen Sie sicher, dass Ihr Chatbot diese Beschränkungen einhält, um optimale Leistung und Zuverlässigkeit zu gewährleisten.

Weitere Details finden Sie in der [Todoist Developer Documentation] (https://developer.todoist.com/rest/v2/#request-limits).