Do Telegram ao Todoist: transforme ideias soltas em tarefas revisadas

Piotr Grudzień
Publicado em 12 min de leitura
Uma Action de tarefas do Quickchat AI ao lado de um projeto do Todoist com três tarefas de exemplo

Um bot do Telegram para Todoist pode transformar uma mensagem cheia de intenções soltas em uma lista de tarefas que você revisou. Você vai criar o Pocket Inbox, um bot pessoal que separa as tarefas, pergunta sobre datas pouco claras e salva o conjunto em um projeto do Todoist após sua aprovação.

Comece com uma mensagem que você poderia enviar ao sair do escritório:

Comprar papel para a impressora na sexta, mandar um e-mail para o local do evento talvez na segunda e ler o guia de trilhas quando tiver tempo.

O projeto Capture demo do Todoist com Buy printer paper marcada para sexta, Email the venue para segunda e Read the trail guide sem data A lista que você vai criar: três tarefas, duas datas e um item deliberadamente sem data. Estas capturas reais do Todoist usam tarefas de demonstração preparadas manualmente; as capturas do Quickchat AI mostram a configuração local. A etapa 6 verifica os resultados do seu bot conectado.

A parte interessante é «talvez na segunda». É uma dúvida a resolver antes de criar um prazo. «Quando tiver tempo» deve continuar sem data. Essa pequena revisão torna a conversa útil: você pode primeiro capturar o pensamento e depois definir os detalhes sem reescrever a mensagem inteira.

Siga seis etapas para preparar as contas, restringir o acesso, conectar o Todoist, ensinar a revisão, aprovar três tarefas e verificar o resultado. O kit inicial do Pocket Inbox contém as quatro receitas de Actions, o prompt e uma lista de testes. São arquivos para copiar, não uma importação automática do agente.

1. O que você precisa para conectar Telegram ao Todoist?

Você precisa de um bot do Telegram que controle, uma conta do Todoist e um agente Quickchat AI com espaço para quatro HTTP Actions. Limite a primeira versão a uma pessoa, um projeto e mensagens de texto.

  1. Entre no Todoist e crie um projeto chamado Capture demo. Use uma conta de teste dedicada, se possível. Um token de API pessoal tem as permissões da conta; um ID de projeto fixo na receita não restringe o próprio token.

A janela Add project do Todoist com Capture demo preenchido, seguida pelo projeto Capture demo vazio Dê um nome ao projeto e abra sua lista de tarefas vazia. Esse é o destino que você selecionará em cada Action de criação.

  1. Crie uma conta Quickchat AI e escolha Add new AI Agent → Set up manually. Dê o nome Pocket Inbox. Confira os planos e limites de Actions atuais; respostas de AI e Simulation Testing consomem créditos.
  2. Crie seu bot com o BotFather. O guia de criação de bots do Telegram explica o nome de usuário e o token. Insira o token diretamente em External Apps → Telegram → Your own bot → Connect to Telegram, ative a integração e salve.
  3. Em Your Website → Install → Availability and access, desative Widget & Embed access e defina Chat Page Access como Nobody. Use sua conversa privada no Telegram para este fluxo.
  4. Abra o bot no Telegram, pressione Start e envie uma saudação curta. Mantenha as Actions do Todoist inativas até configurar as regras de acesso abaixo.

Configurações do Telegram no Quickchat AI com a opção de conexão Your own bot Dê ao Pocket Inbox sua própria identidade no Telegram. Esta tela de configuração local não contém um token de bot ativo.

Agora você tem o lugar para capturar pensamentos. Antes de conectar suas tarefas, defina qual remetente do Telegram pode acessá-las.

2. Como manter o bot do Todoist privado?

Condicione cada leitura e escrita ao seu ID de usuário do Telegram e a uma conversa privada. Quickchat AI avalia essas condições antes de enviar a solicitação HTTP.

  1. Em Inbox, abra a conversa real do Telegram com sua saudação. Selecione Details → Visitor. Copie o valor numérico ao lado de Telegram User Id e confirme que Telegram Chat Type é private.
  2. Em cada Action criada na próxima etapa, defina When to run como AI decides.
  3. Em Run only when, adicione as duas condições abaixo. Use o ID daquela conversa, não um nome de usuário ou um ID digitado em uma mensagem.
Chave de metadadosComparaçãoValor
telegram_user_idequalsSeu ID numérico verificado de usuário do Telegram
telegram_chat_typeequalsprivate

Editor de Actions mostrando ID de usuário do Telegram e conversa privada como duas condições obrigatórias As duas condições precisam ser atendidas. O ID numérico destes dados locais de teste é ilustrativo; substitua pelo seu próprio valor verificado.

Diagrama de um remetente do Telegram passando pelas verificações de proprietário e conversa privada antes de uma solicitação ao Todoist O Telegram fornece a identidade. A conversa fornece a tarefa proposta. São entradas diferentes.

A documentação de Run only when explica as condições. Uma conversa privada sozinha é insuficiente porque outra pessoa pode abrir uma conversa privada com seu bot. Um prompt que permite apenas o proprietário também é insuficiente. Aplique as duas verificações às Actions de leitura com o mesmo cuidado que às de criação.

A prévia web comum não tem os metadados verificados do Telegram, então essas Actions devem ser recusadas nela. Mantenha as condições e use o canal real para o teste final.

3. Como conectar o bot à API do Todoist?

Crie quatro HTTP Actions: listar as tarefas ativas do projeto, criar uma tarefa com data, criar uma tarefa sem data e reler uma tarefa salva. As Actions separadas de criação tornam sem data uma escolha explícita.

A solicitação usa os mesmos campos que você vê ao adicionar uma tarefa no Todoist: um título, um projeto de destino e uma data opcional.

O formulário de tarefas do Todoist com Buy printer paper, o seletor de projeto Capture demo e o controle Date, além de uma visualização ampliada desses campos Os campos da tarefa em detalhe. As receitas de API abaixo fornecem o título como content, o projeto como project_id e uma data aprovada como due_date. A receita sem data omite a data.

Prepare o token e o ID do projeto

  1. No aplicativo web do Todoist, abra avatar → Settings → Integrations → Developer → Copy API token, conforme as instruções oficiais do token.
  2. No Quickchat AI, escolha Actions & MCPs → Add Action → API Action → Create manually. Para cada receita, insira o token diretamente em Headers → Authorization como Bearer YOUR_TODOIST_TOKEN. Considere os cabeçalhos fixos acessíveis a quem pode editar o agente. Mantenha o token fora do prompt, da conversa e das capturas de tela.
  3. Para encontrar o ID do projeto, crie uma Action temporária e inativa de configuração com GET https://api.todoist.com/api/v1/projects, o cabeçalho Authorization e Accept: application/json. Use Test no editor, examine results e copie o id ao lado de Capture demo. Se necessário, passe o next_cursor retornado como valor de consulta cursor da próxima solicitação. Depois exclua a Action de configuração.
  4. Cole esse ID retornado pelo servidor onde as receitas indicarem YOUR_PROJECT_ID. Mantenha-o fixo, não como parâmetro preenchido pela AI. Um ID tmp- ainda não foi sincronizado e não pode ser usado aqui.

A referência atual da API do Todoist documenta esses endpoints. Use /api/v1, incluindo sua resposta de lista paginada, em vez de copiar uma receita antiga de REST-v2.

Configure as quatro Actions

O guia do construtor de API Actions explica o editor. Adicione cada entrada em What to ask the user first. Use Add AI Data para inserir o chip do parâmetro na URL, na linha de consulta ou no corpo; a notação {{...}} abaixo identifica esses chips.

Nas quatro Actions, adicione Accept: application/json, mantenha ambas as condições do proprietário e deixe Response Filter vazio para que os IDs retornados e as informações de paginação continuem visíveis. Nas duas POST Actions, adicione também Content-Type: application/json.

Action de tarefa com data mostrando chip content, ID de projeto fixo e chip due_date no corpo JSON O título e a data vêm do rascunho aprovado. O projeto de destino permanece fixo na Action.

Copie a Action 1 de 4: Read capture tasks

API Action Name: Read capture tasks

What to ask the user first:

FormatoNomeDescriçãoObrigatório
TextcursorOmita na primeira página. Na próxima, copie next_cursor do resultado anterior.Não

API Endpoint, Query Params e Headers:

GET https://api.todoist.com/api/v1/tasks

Query Params
project_id: YOUR_PROJECT_ID
limit: 50
cursor: {{cursor}}

Headers
Authorization: Bearer YOUR_TODOIST_TOKEN
Accept: application/json

Deixe vazio o valor padrão da entrada opcional cursor e use seu chip como valor inteiro da linha de consulta. Não o acrescente à URL do endpoint.

Body: vazio.

API Action Description:

Read active tasks in the fixed Capture demo project before saving a batch and when the user asks what is currently there. Start without a cursor. Follow next_cursor until it is empty; after five pages, explain that the list is incomplete and do not create a batch based on an incomplete duplicate check. Preserve returned IDs and dates. Similar titles are candidates to review, not proof of duplicates.
Copie a Action 2 de 4: Create dated capture task

API Action Name: Create dated capture task

What to ask the user first:

FormatoNomeDescriçãoObrigatório
TextcontentTítulo exato da tarefa no conjunto final aprovado pelo usuário.Sim
Textdue_dateData exata aprovada no formato YYYY-MM-DD, sem horário.Sim

API Endpoint e Headers:

POST https://api.todoist.com/api/v1/tasks

Headers
Authorization: Bearer YOUR_TODOIST_TOKEN
Accept: application/json
Content-Type: application/json

Aba Body, modo JSON:

{
  "content": "{{content}}",
  "project_id": "YOUR_PROJECT_ID",
  "due_date": "{{due_date}}"
}

API Action Description:

Create one task only after the user explicitly approves the final title, exact date and Capture demo destination. Use only for a dated task. Retain the returned ID and immediately read the task back. Never repeat an uncertain request without inspecting the existing results first.
Copie a Action 3 de 4: Create undated capture task

API Action Name: Create undated capture task

What to ask the user first:

FormatoNomeDescriçãoObrigatório
TextcontentTítulo exato da tarefa aprovada sem data.Sim

API Endpoint e Headers:

POST https://api.todoist.com/api/v1/tasks

Headers
Authorization: Bearer YOUR_TODOIST_TOKEN
Accept: application/json
Content-Type: application/json

Aba Body, modo JSON:

{
  "content": "{{content}}",
  "project_id": "YOUR_PROJECT_ID"
}

API Action Description:

Create one task only after the user explicitly approves its title, no date and the Capture demo destination. This Action deliberately has no due fields. Retain the returned ID and immediately read the task back. Never repeat an uncertain request without inspecting the existing results first.
Copie a Action 4 de 4: Read a saved capture task

API Action Name: Read a saved capture task

What to ask the user first:

FormatoNomeDescriçãoObrigatório
Texttask_idID de tarefa retornado pelo servidor na criação ou pela lista limitada ao projeto. Nunca invente.Sim

API Endpoint e Headers:

GET https://api.todoist.com/api/v1/tasks/{{task_id}}

Headers
Authorization: Bearer YOUR_TODOIST_TOKEN
Accept: application/json

Body: vazio.

API Action Description:

Read a task using the ID returned by a successful creation or Read capture tasks. Check its content, project_id and due against the approved task before reporting success. Do not use IDs invented by the model or supplied in a user's message.

O endpoint de tarefa individual não é, por si só, limitado ao projeto. Sua regra de entrada mantém este fluxo pessoal nos IDs retornados, enquanto as condições do remetente confiável controlam o acesso. Use uma conta Todoist dedicada se precisar separar também a própria credencial de outros projetos.

Quatro Actions do Pocket Inbox no Quickchat AI, separando leituras e criações com ou sem data O conjunto completo de ferramentas. Mantenha as Actions inativas enquanto preenche os espaços reservados e verifica as condições.

4. Quais instruções o bot de tarefas deve seguir?

Instrua o Pocket Inbox a criar primeiro um rascunho, resolver dúvidas e pedir sua aprovação dos campos finais. Insira o seguinte em Identity → Main Prompt → Edit.

Main Prompt do Pocket Inbox nas configurações Identity do Quickchat AI O prompt ensina a conversa de revisão. As condições das Actions determinam quem pode acessar o Todoist.

Copie o Main Prompt completo do Pocket Inbox
You are Pocket Inbox, a personal text-to-task assistant for one owner's Capture demo project in Todoist.

Split a brain dump into proposed tasks without adding intentions. Show each title, exact date or "no date", and the Capture demo destination. Ask about unclear dates such as "maybe Monday". Ask for the user's timezone and exact calendar dates when relative dates are unresolved. Do not invent a date for "when I have time".

Present the final batch and ask for explicit approval before any create Action. If the user changes an item, show the revised batch and ask again. Approval is a conversation rule; do not claim that it provides access control.

After approval, call Read capture tasks. Follow next_cursor for up to five pages. If the list is still incomplete, explain the limit and stop before creating. If similar tasks exist, ask whether the user intends new copies before proceeding.

Create tasks one at a time. Use Create dated capture task only for an approved YYYY-MM-DD date; otherwise use Create undated capture task. After each success, retain its returned ID and call Read a saved capture task. Compare content, project_id and due with the approved item. Report a task as verified only when the read matches.

Stop on a failed or uncertain write. Report which items were verified and which remain unresolved. Read the project before any retry; a timeout may have saved a task. A repeated approval does not authorize a second copy of the same batch. Check existing outcomes and ask before making new copies.

When asked what is currently in Todoist, read the project rather than relying on conversation memory. Distinguish current active tasks from the exact tasks created in this conversation. Never invent task IDs or links. If an Action is refused by its run conditions, explain that it needs the configured owner's private Telegram chat. Do not suggest removing the conditions.

This setup handles text, date-only tasks and undated tasks. Do not claim voice transcription, scheduled reminders, recurring tasks or access to other people's accounts.

Você também pode preparar as configurações compatíveis pela conexão de gerenciamento de conta do Quickchat AI no ChatGPT ou Claude. Entregue ao assistente conectado o kit e esta solicitação:

Prepare Pocket Inbox using the four HTTP Action recipes and Main Prompt in this kit. Keep the Actions inactive. Preserve the fixed project ID and both Telegram run conditions on every Action. Ask me for non-secret IDs when needed, and leave token entry to me in the dashboard. Show me the saved configuration before any test that creates Todoist tasks or spends credits.

Essa conexão gerencia as configurações do Quickchat AI. Você ainda cria o bot do Telegram, insere as credenciais diretamente e testa sua conexão real entre Telegram e Todoist.

5. Como ideias soltas viram três tarefas aprovadas?

Use a mensagem original para testar a conversa antes de autorizar um salvamento. Quando as quatro Actions tiverem credenciais, projeto e condições corretos, ative-as e envie a mensagem na sua conversa privada do Telegram.

Buy printer paper Friday, email the venue maybe Monday, and read the trail guide when I have time.

O bot deve propor três tarefas e perguntar sobre as datas. Nenhuma Action de criação deve executar ainda. Para um exemplo repetível, responda com datas explícitas:

Use Europe/Warsaw. Friday means 2026-11-20. Make the venue email Monday, 2026-11-23. Leave the trail guide without a date.

São datas fixas de exemplo, não uma definição de «esta sexta» válida sempre que você ler o artigo. Substitua pelas datas que quiser usar no seu teste.

Diagrama que esclarece sexta como 20 de novembro, talvez segunda como 23 de novembro e quando tiver tempo como sem data Esclareça a dúvida antes de criar as tarefas. Estas são entradas de exemplo e os campos finais pretendidos.

Compare o rascunho final do bot com esta tabela:

TarefaData confirmadaProjeto
Comprar papel para a impressora2026-11-20Capture demo
Enviar e-mail ao local do evento2026-11-23Capture demo
Ler o guia de trilhasSem dataCapture demo

Se algo estiver diferente, corrija e confira o conjunto revisado. Depois envie:

Looks good, save all three.

A aprovação é um comportamento orientado pelo prompt, então teste em vez de presumir que é garantida. Em Inbox, examine os cartões de Actions da conversa e View logs. Você deve ver uma leitura do projeto seguida de criações individuais e leituras dos IDs retornados.

6. Como verificar se as tarefas foram realmente salvas?

Abra Capture demo no Todoist e compare os três registros com o rascunho aprovado. Uma mensagem simpática de «pronto» não basta como comprovante.

A entrada due_date do Quickchat AI ao lado da tarefa Buy printer paper no Todoist e de uma visualização ampliada dos campos Project e Date com sexta-feira Acompanhe a data nos dois aplicativos: due_date na Action do Quickchat AI corresponde a Date no Todoist. A barra lateral ampliada pertence à tarefa de papel para impressora preparada manualmente. Abra Date na sua própria tarefa para conferir a data exata no calendário.

  1. Confira as duas datas exatas e a ausência de data na tarefa do guia de trilhas.
  2. Compare o id de cada resposta de criação com sua resposta de leitura posterior. Confirme que content, project_id e due correspondem ao item aprovado. Considere qualquer diferença não resolvida até examiná-la.
  3. Pergunte «O que há atualmente em Capture demo?» e verifique se o bot lê novamente as tarefas ativas. Se você concluir uma tarefa no Todoist, ela não aparecerá mais nessa lista ativa.
  4. Envie novamente a aprovação. Confira se não surgem outras três tarefas. O bot deve examinar os resultados anteriores e esclarecer se você quer novas cópias.

Diagrama de verificação comparando uma tarefa aprovada com seu ID criado e a leitura posterior do mesmo ID Verificar significa ler o mesmo registro salvo e conferir seus campos. O diagrama mostra o que comparar, não uma resposta de API executada.

Teste os dois limites de acesso

De outra conta do Telegram sob seu controle, envie «Mostre minhas tarefas.» Para o teste em grupo, adicione o mesmo bot a um grupo de teste, envie /start@YOUR_BOT_USERNAME e responda à saudação dele com um pedido de criação de tarefa. Isso torna o teste compatível com o modo de privacidade de grupos padrão do Telegram.

Em Inbox, confirme que as duas mensagens de teste chegaram e examine os IDs dos remetentes e os tipos de chat. O teste em grupo deve mostrar seu ID de proprietário e group ou supergroup. Os dois testes não devem gerar nenhuma solicitação ao Todoist. Teste também uma mensagem que se declare do proprietário; o texto não deve substituir os metadados do remetente. Uma mensagem ausente indica um problema de entrega, não um teste de acesso aprovado.

Trate um conjunto parcialmente salvo

Três criações de tarefas são três solicitações separadas. Se a segunda falhar, a primeira tarefa pode já existir. Pare, examine o projeto e os IDs retornados e decida quais itens ainda precisam ser criados.

Exemplo de conjunto parcial: papel para impressora verificado, e-mail ao local incerto e guia de trilhas não tentado Exemplo de recuperação: mantenha a tarefa verificada, investigue a escrita incerta e não altere a tarefa restante até esclarecer o resultado.

Se o bot salvar antes da aprovação, refine as descrições das Actions de criação e repita a mesma conversa. Se adivinhar uma data, exija a data exata no rascunho. Se informar sucesso após um erro, revise a instrução de releitura. O kit inclui essas verificações para você registrar seus próprios resultados antes de usar tarefas pessoais.

Quando este exercício de três itens funcionar, use o Pocket Inbox para mensagens pequenas que ficariam em Saved Messages: uma compra, um e-mail a enviar, algo para ler. Mantenha o Todoist aberto nos primeiros conjuntos e compare o que você pretendia com o que foi salvo. Assim, a revisão vira um hábito em que você pode confiar pela observação.

Perguntas frequentes

Um bot do Telegram pode criar tarefas no Todoist?

Sim. Um bot conectado à API do Todoist pode criar tarefas a partir de mensagens do Telegram. Esta receita usa Quickchat AI para separar uma mensagem em propostas de tarefas, esclarecer datas, pedir aprovação e chamar Todoist API v1. Verifique os registros resultantes no seu próprio projeto do Todoist.

Outros usuários do Telegram podem ver minhas tarefas do Todoist?

Aplique as duas condições avaliadas no servidor a cada Action de leitura e escrita: telegram_user_id deve ser igual ao seu ID numérico verificado e telegram_chat_type deve ser private. Teste outro remetente e uma conversa de grupo antes de usar dados pessoais. Um prompt dizendo «somente o proprietário» não oferece controle de acesso.

O bot vai entender próxima sexta-feira ou talvez segunda-feira?

O prompt pede que ele esclareça datas incertas e mostre uma data exata no formato YYYY-MM-DD antes de salvar. Informe seu fuso horário e confirme as datas finais. Uma tarefa sem data usa uma Action separada que omite completamente os campos de vencimento.

Isso impede tarefas duplicadas no Todoist?

Não. Ler tarefas existentes e verificar os IDs retornados ajuda a identificar duplicatas, mas esta receita não é uma operação atômica em lote nem um sistema garantido de deduplicação. Se uma solicitação exceder o tempo limite, confira o Todoist antes de tentar novamente: a tarefa pode já ter sido salva.

Preciso de código ou de um servidor MCP do Todoist?

Você configura quatro HTTP Actions e um Main Prompt no Quickchat AI. Não precisa executar um servidor MCP do Todoist. Precisa de um bot do Telegram, um token de API do Todoist e um plano Quickchat AI com capacidade de Actions e créditos suficientes para testes e conversas.

Ele pode processar mensagens de voz ou enviar lembretes?

Esta primeira versão aceita texto e cria tarefas com ou sem data. Não transcreve mensagens de voz, agenda lembretes, conclui tarefas nem conecta contas do Todoist de outras pessoas. Essas funções precisam de configuração e testes separados.

Quickchat AI Quickchat AI Ask Quickchat AI a question