Integre o seu chatbot com o Todoist para criar e modificar tarefas, publicar comentários e muito mais.
## Migrando da versão `0.x` para `1.x`
Se você estiver migrando da versão `0.x` para `1.x`, observe as seguintes alterações:
> A ação "Criar Tarefa" foi substituída pela ação "Criar Nova Tarefa".
## Configuração
### Configuração automática com OAuth
Para configurar a integração do Todoist usando o OAuth, clique no botão de autorização e siga as instruções na tela para conectar seu chatbot Botpress ao Todoist.
Ao configurar seu bot com OAuth, você pode fazer login com sua conta de usuário ou com uma conta de usuário criada especificamente para seu bot.
Lembre-se de que, se você fizer login com sua conta de usuário, as ações e os comentários do bot aparecerão como seus.
Para a maioria dos casos de utilização, recomenda-se a criação de uma conta de utilizador especificamente para o seu bot. Terá de convidar o utilizador do bot para um projeto partilhado para que este possa publicar comentários, realizar acções, etc.
### Configuração manual usando um token de API pessoal
1. Criação da aplicação Todoist
- Crie uma aplicação na [página Gestão de aplicações] (https://developer.todoist.com/appconsole.html).
- Copie o token de API pessoal do seu utilizador ou gere um token de teste na página Gestão de aplicações.
2. Configuração da integração do Todoist Botpress
- Instale a integração do Todoist no seu bot Botpress .
- Cole o token da API copiado anteriormente nos campos de configuração. Este é o token que seu bot usará para postar comentários, atualizar ou criar tarefas, etc.
- Guardar a configuração.
- Copie o URL Webhook do seu bot.
3. Configuração do aplicativo Todoist Webhook
- Vá para a página Gerenciamento de aplicativos do seu aplicativo no Todoist.
- Certifique-se de que os eventos Webhooks estão activados. Siga [estas instruções] (https://developer.todoist.com/sync/v9/#webhooks) fornecidas pelo Todoist para fazer isso.
- Cole o URL Webhook copiado anteriormente no campo _Webhook callback URL_.
- Verifique os seguintes _Watched Events_:
- _item:added_;
- _item:updated_;
- _item:completed_;
- _note:added_.
- Guardar a configuração de Webhook .
## Limitações
As limitações padrão da API do Todoist aplicam-se à integração do Todoist em Botpress. Essas limitações incluem limites de taxa, restrições de tamanho de carga útil e outras restrições impostas pelo Todoist. Certifique-se de que o seu chatbot adere a estas limitações para manter um desempenho e fiabilidade ideais.
Mais detalhes estão disponíveis na [Documentação do desenvolvedor Todoist] (https://developer.todoist.com/rest/v2/#request-limits).
