Todoist

  Intégrez votre chatbot à Todoist pour créer et modifier des tâches, publier des commentaires, etc.

## Migrer de la version `0.x` à `1.x`

Si vous migrez de la version `0.x` à `1.x`, veuillez noter les changements suivants :

> L'action "Créer une tâche" a été remplacée par l'action "Créer une nouvelle tâche".

## Configuration

### Configuration automatique avec OAuth

Pour configurer l'intégration de Todoist en utilisant OAuth, cliquez sur le bouton d'autorisation et suivez les instructions à l'écran pour connecter votre chatbot Botpress à Todoist.

Lorsque vous configurez votre bot avec OAuth, vous pouvez vous connecter avec votre compte utilisateur ou avec un compte utilisateur que vous avez créé spécifiquement pour votre bot.
Gardez à l'esprit que si vous vous connectez avec votre compte utilisateur, les actions et les commentaires du robot apparaîtront comme les vôtres.
Pour la plupart des cas d'utilisation, il est recommandé de créer un compte utilisateur spécifique pour votre robot. Vous devrez inviter l'utilisateur du robot dans un projet partagé pour qu'il puisse poster des commentaires, effectuer des actions, etc.

### Configuration manuelle à l'aide d'un jeton API personnel

1. Création de l'application Todoist
   - Créez une application dans la [page de gestion des applications] (https://developer.todoist.com/appconsole.html).
   - Copiez le jeton API personnel de votre utilisateur ou générez un jeton de test dans la page App Management.
2. Configuration de l'intégration Todoist Botpress 
   - Installez l'intégration Todoist dans votre bot Botpress .
   - Collez le jeton API copié précédemment dans les champs de configuration. Il s'agit du jeton que votre robot utilisera pour poster des commentaires, mettre à jour ou créer des tâches, etc.
   - Sauvegardez la configuration.
   - Copiez l'URL Webhook de votre robot.
3. Configuration de l'application Todoist Webhook 
   - Allez dans la page App Management de votre application sur Todoist.
   - Assurez-vous que les événements Webhooks sont activés. Suivez [ces instructions] (https://developer.todoist.com/sync/v9/#webhooks) fournies par Todoist pour ce faire.
   - Collez l'URL Webhook copiée précédemment dans le champ _Webhook callback URL_.
   - Vérifiez les _Événements surveillés_ suivants :
     - _item:added_ ;
     - _item:updated_ ;
     - _item:completed_ ;
     - _note:added_.
   - Enregistrez la configuration de Webhook .

## Limitations

Les limitations standard de l'API Todoist s'appliquent à l'intégration de Todoist dans Botpress. Ces limitations incluent des limites de débit, des restrictions de taille de charge utile, et d'autres contraintes imposées par Todoist. Assurez-vous que votre chatbot respecte ces limitations afin de maintenir des performances et une fiabilité optimales.

Plus de détails sont disponibles dans la [Todoist Developer Documentation] (https://developer.todoist.com/rest/v2/#request-limits).