Todoist

  Integrate il vostro chatbot con Todoist per creare e modificare attività, inviare commenti e altro ancora.

## Migrare dalla versione `0.x` alla `1.x`

Se state migrando dalla versione `0.x` alla `1.x`, notate le seguenti modifiche:

> L'azione "Crea attività" è stata sostituita dall'azione "Crea nuova attività".

## Configurazione

### Configurazione automatica con OAuth

Per configurare l'integrazione con Todoist utilizzando OAuth, fare clic sul pulsante di autorizzazione e seguire le istruzioni visualizzate per collegare il chatbot Botpress a Todoist.

Quando si configura il bot con OAuth, è possibile accedere con il proprio account utente o con un account utente creato appositamente per il bot.
Tenete presente che se accedete con il vostro account utente, le azioni e i commenti del bot appariranno come vostri.
Per la maggior parte dei casi d'uso, si consiglia di creare un account utente specifico per il bot. È necessario invitare l'utente del bot a un progetto condiviso per consentirgli di inviare commenti, eseguire azioni, ecc.

### Configurazione manuale con un token API personale

1. Creazione dell'app Todoist
   - Creare un'app nella pagina [Gestione app] (https://developer.todoist.com/appconsole.html).
   - Copiare il token API personale dell'utente o generare un token di prova nella pagina Gestione app.
2. Configurazione dell'integrazione Todoist Botpress 
   - Installare l'integrazione Todoist nel bot Botpress .
   - Incollare il token API copiato in precedenza nei campi di configurazione. Questo è il token che il bot utilizzerà per pubblicare commenti, aggiornare o creare attività, ecc.
   - Salvare la configurazione.
   - Copiare l'URL di Webhook del proprio bot.
3. Configurazione dell'app Todoist Webhook 
   - Accedere alla pagina di gestione dell'applicazione su Todoist.
   - Assicurarsi che gli eventi Webhooks siano attivati. Seguire le [istruzioni] (https://developer.todoist.com/sync/v9/#webhooks) fornite da Todoist per farlo.
   - Incollare l'URL Webhook copiato in precedenza nel campo _Webhook callback URL_.
   - Controllare i seguenti _eventi osservati_:
     - _item:added_;
     - _voce:aggiornata_;
     - _voce:completata_;
     - _nota:aggiunta_.
   - Salvare la configurazione di Webhook .

## Limitazioni

Le limitazioni API standard di Todoist si applicano all'integrazione di Todoist in Botpress. Queste limitazioni includono limiti di velocità, restrizioni sulle dimensioni del payload e altri vincoli imposti da Todoist. Assicurarsi che il chatbot rispetti queste limitazioni per mantenere prestazioni e affidabilità ottimali.

Ulteriori dettagli sono disponibili nella [Todoist Developer Documentation] (https://developer.todoist.com/rest/v2/#request-limits).