Z Telegramu do Todoistu: proměňte proud myšlenek v ověřené úkoly

Piotr Grudzień
Publikováno 10 min čtení
Action pro úkoly v Quickchat AI vedle projektu Todoist se třemi ukázkovými úkoly

Telegram bot pro Todoist může z volně formulovaných záměrů ve zprávě připravit seznam úkolů, který si zkontrolujete. Vytvoříte Pocket Inbox, osobního bota, který oddělí úkoly, doptá se na nejasná data a po vašem schválení uloží seznam do jednoho projektu Todoist.

Začněte zprávou, kterou byste mohli poslat cestou z kanceláře:

V pátek koupit papír do tiskárny, možná v pondělí napsat provozovateli místa konání a až bude čas přečíst průvodce po trase.

Projekt Capture demo v Todoistu s úkolem Buy printer paper na pátek, Email the venue na pondělí a Read the trail guide bez data Seznam, který vytvoříte: tři úkoly, dvě data a jedna položka záměrně bez data. Tyto skutečné snímky Todoistu používají ručně připravené ukázkové úkoly; snímky Quickchat AI ukazují místní nastavení. Krok 6 ověřuje výsledky vašeho živého bota.

Podstatné je „možná v pondělí“. To je potřeba vyjasnit před nastavením termínu. „Až bude čas“ má zůstat bez data. Právě tato krátká kontrola dává rozhovoru smysl: nejprve zachytíte myšlenku a potom doladíte podrobnosti, aniž byste přepisovali celou zprávu.

V šesti krocích připravíte účty, omezíte přístup, připojíte Todoist, nastavíte kontrolu, schválíte tři úkoly a ověříte výsledek. Startovní sada Pocket Inbox obsahuje postupy pro všechny čtyři Actions, prompt a seznam testů. Jde o soubory ke zkopírování, nikoli automatický import AI Agenta.

1. Co potřebujete k propojení Telegramu s Todoistem?

Potřebujete Telegram bota pod svou kontrolou, účet Todoist a AI Agenta v Quickchat AI s kapacitou pro čtyři HTTP Actions. První verzi omezte na jednu osobu, jeden projekt a textové zprávy.

  1. Přihlaste se do Todoistu a vytvořte projekt Capture demo. Pokud můžete, použijte samostatný testovací účet. Osobní API token má oprávnění účtu; pevné ID projektu v nastavení neomezuje samotný token.

Dialog Add project v Todoistu se zadaným názvem Capture demo a následně prázdný projekt Capture demo Nejprve projekt pojmenujte a potom otevřete jeho prázdný seznam úkolů. Tento cíl vyberete v každé Action pro vytvoření.

  1. Vytvořte účet Quickchat AI a vyberte Add new AI Agent → Set up manually. Agenta pojmenujte Pocket Inbox. Ověřte aktuální tarify a limity Actions; odpovědi AI i Simulation Testing spotřebovávají kredity.
  2. Vytvořte bota pomocí BotFather. Průvodce vytvořením Telegram bota vysvětluje uživatelské jméno a token. Token zadejte přímo v External Apps → Telegram → Your own bot → Connect to Telegram, pak integraci zapněte a uložte.
  3. V Your Website → Install → Availability and access vypněte Widget & Embed access a nastavte Chat Page Access na Nobody. Pro tento postup používejte soukromý rozhovor v Telegramu.
  4. Otevřete bota v Telegramu, stiskněte Start a pošlete krátký pozdrav. Actions pro Todoist nechte neaktivní, dokud nenastavíte níže uvedená pravidla přístupu.

Nastavení Telegramu v Quickchat AI s možností připojení Your own bot Dejte Pocket Inbox vlastní identitu v Telegramu. Tato místní obrazovka nastavení neobsahuje platný token bota.

Nyní máte místo pro zachycení myšlenek. Než připojíte úkoly, určete, který odesílatel Telegramu k nim smí přistupovat.

2. Jak zachovat soukromí bota pro Todoist?

U každého čtení i zápisu vyžadujte své uživatelské ID Telegramu a soukromý chat. Quickchat AI tyto podmínky vyhodnocuje před odesláním HTTP požadavku.

  1. V Inbox otevřete skutečný rozhovor Telegramu s vaším pozdravem. Vyberte Details → Visitor. Zkopírujte číselnou hodnotu u Telegram User Id a ověřte, že Telegram Chat Type je private.
  2. U každé Action vytvořené v dalším kroku nastavte When to run na AI decides.
  3. Do Run only when přidejte obě následující podmínky. Použijte ID z tohoto rozhovoru, ne uživatelské jméno ani ID napsané ve zprávě.
Klíč metadatPorovnáníHodnota
telegram_user_idequalsVaše ověřené číselné uživatelské ID Telegramu
telegram_chat_typeequalsprivate

Editor Action se dvěma povinnými podmínkami: uživatelským ID Telegramu a soukromým chatem Musí platit obě podmínky. Číselné ID v této místní ukázce je ilustrativní; nahraďte je svou ověřenou hodnotou.

Schéma kontroly vlastníka a soukromého chatu před požadavkem na Todoist Telegram poskytuje identitu. Rozhovor poskytuje navrhovaný úkol. Jde o odlišné vstupy.

Podmínky vysvětluje dokumentace Run only when. Samotný soukromý chat nestačí, protože soukromý rozhovor s botem může otevřít i někdo jiný. Nestačí ani prompt určující pouze vlastníka. Obě kontroly nastavte stejně pečlivě u čtecích Actions i u vytváření.

Běžný webový náhled nemá ověřená metadata Telegramu, takže tam mají tyto Actions odmítnout spuštění. Podmínky ponechte a závěrečný test proveďte ve skutečném kanálu.

3. Jak připojit bota k API Todoistu?

Vytvořte čtyři HTTP Actions: načtení aktivních úkolů projektu, vytvoření úkolu s datem, vytvoření úkolu bez data a opětovné načtení uloženého úkolu. Oddělené vytvářecí Actions dělají z varianty bez data výslovnou volbu.

Požadavek používá stejná pole, která vidíte při přidávání úkolu v Todoistu: název, cílový projekt a nepovinné datum.

Formulář pro zadání úkolu v Todoistu s Buy printer paper, výběrem projektu Capture demo a ovládacím prvkem Date spolu se zvětšeným pohledem na tato pole Podrobnější pohled na pole úkolu. Níže uvedené postupy API předávají název jako content, projekt jako project_id a schválené datum jako due_date. Varianta bez data datum vynechává.

Připravte token a ID projektu

  1. Ve webové aplikaci Todoist otevřete avatar → Settings → Integrations → Developer → Copy API token, jak popisuje oficiální návod k tokenu.
  2. V Quickchat AI zvolte Actions & MCPs → Add Action → API Action → Create manually. Pro každý postup vložte token přímo do Headers → Authorization jako Bearer YOUR_TODOIST_TOKEN. Počítejte s tím, že pevné hlavičky mohou zobrazit lidé s právem upravovat AI Agenta. Token nepatří do promptu, chatu ani snímků obrazovky.
  3. ID projektu získáte pomocí dočasné neaktivní Action s GET https://api.todoist.com/api/v1/projects, hlavičkou Authorization a Accept: application/json. Použijte Test v editoru, prohlédněte results a zkopírujte id vedle Capture demo. Je-li třeba, předejte vrácený next_cursor jako hodnotu parametru cursor dalšího požadavku. Potom pomocnou Action smažte.
  4. ID vrácené serverem vložte všude místo YOUR_PROJECT_ID. Musí být pevné, nikoli vyplňované AI. ID začínající tmp- ještě není synchronizované a nelze je zde použít.

Tyto endpointy popisuje aktuální reference API Todoistu. Použijte /api/v1 včetně stránkovaného seznamu odpovědí, místo kopírování staršího postupu pro REST-v2.

Nastavte čtyři Actions

Editor vysvětluje průvodce API Action builderem. Vstupy přidávejte do What to ask the user first. Pomocí Add AI Data vkládejte štítky parametrů do URL, řádku dotazu nebo těla; zápis {{...}} níže označuje tyto štítky.

U všech čtyř Actions přidejte Accept: application/json, ponechte obě podmínky vlastníka a nechte Response Filter prázdný, aby zůstala viditelná ID úkolů i stránkování. U obou POST Actions přidejte také Content-Type: application/json.

Action úkolu s datem s parametry content a due_date a pevným ID projektu v těle JSON Název a datum pocházejí ze schváleného návrhu. Cílový projekt zůstává v Action pevný.

Zkopírovat Action 1 ze 4: Read capture tasks

API Action Name: Read capture tasks

What to ask the user first:

FormátNázevPopisPovinné
TextcursorNa první stránce vynechte. Pro další zkopírujte next_cursor z předchozího výsledku.Ne

API Endpoint, Query Params and 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

Výchozí hodnotu nepovinného vstupu cursor nechte prázdnou a celý řádek hodnoty dotazu vyplňte jeho štítkem. Nepřipojujte jej k URL endpointu.

Body: prázdné.

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.
Zkopírovat Action 2 ze 4: Create dated capture task

API Action Name: Create dated capture task

What to ask the user first:

FormátNázevPopisPovinné
TextcontentPřesný název úkolu z konečného seznamu schváleného uživatelem.Ano
Textdue_datePřesné schválené datum ve formátu YYYY-MM-DD, bez času.Ano

API Endpoint and Headers:

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

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

Karta Body, režim 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.
Zkopírovat Action 3 ze 4: Create undated capture task

API Action Name: Create undated capture task

What to ask the user first:

FormátNázevPopisPovinné
TextcontentPřesný název úkolu schváleného bez data.Ano

API Endpoint and Headers:

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

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

Karta Body, režim 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.
Zkopírovat Action 4 ze 4: Read a saved capture task

API Action Name: Read a saved capture task

What to ask the user first:

FormátNázevPopisPovinné
Texttask_idID úkolu vrácené serverem při vytvoření nebo v seznamu vybraného projektu. Nikdy je neodhadujte.Ano

API Endpoint and Headers:

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

Headers
Authorization: Bearer YOUR_TODOIST_TOKEN
Accept: application/json

Body: prázdné.

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.

Endpoint jednotlivého úkolu sám o sobě není omezen na projekt. Pravidlo vstupu udržuje tento osobní postup u vrácených ID, zatímco podmínky důvěryhodného odesílatele řídí přístup. Potřebujete-li oddělit i samotné přihlašovací údaje od jiných projektů, použijte samostatný účet Todoist.

Čtyři Actions Pocket Inbox v Quickchat AI oddělující čtení a vytváření úkolů s datem či bez data Kompletní sada nástrojů. Při doplňování hodnot a kontrole podmínek nechte Actions neaktivní.

4. Jakými pokyny se má bot na úkoly řídit?

Řekněte Pocket Inbox, aby nejprve vytvořil návrh, vyjasnil nejasnosti a požádal vás o schválení konečných polí. Následující text vložte do Identity → Main Prompt → Edit.

Main Prompt Pocket Inbox v nastavení Identity v Quickchat AI Prompt určuje průběh kontroly. Podmínky Actions vynucují, kdo smí přistupovat k Todoistu.

Zkopírovat celý Main Prompt 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.

Podporovaná nastavení můžete připravit také prostřednictvím propojení správy účtu Quickchat AI v ChatGPT nebo Claude. Připojenému asistentovi dejte sadu a tento požadavek:

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.

Toto připojení spravuje nastavení Quickchat AI. Stále musíte vytvořit Telegram bota, přímo zadat přihlašovací údaje a otestovat živé propojení Telegramu s Todoistem.

5. Jak se proud myšlenek změní ve tři schválené úkoly?

Před povolením uložení vyzkoušejte rozhovor původní zprávou. Až budou mít všechny čtyři Actions správné přihlašovací údaje, projekt i podmínky, zapněte je a pošlete zprávu v soukromém chatu Telegramu.

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

Bot má navrhnout tři úkoly a doptat se na data. Zatím se nesmí spustit žádná Action pro vytvoření. Pro opakovatelný příklad odpovězte přesnými daty:

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

Jde o pevná ukázková data, ne o význam „tohoto pátku“ v okamžiku čtení. Nahraďte je daty pro vlastní test.

Schéma upřesnění dat: pátek jako 20. listopadu, možné pondělí jako 23. listopadu a volný čas bez data Nejasnosti vyřešte před vytvořením úkolů. Zde jsou ukázkové vstupy a zamýšlená konečná pole.

Porovnejte konečný návrh bota s tabulkou:

ÚkolPotvrzené datumProjekt
Koupit papír do tiskárny2026-11-20Capture demo
Napsat provozovateli místa konání2026-11-23Capture demo
Přečíst průvodce po traseBez dataCapture demo

Případné rozdíly opravte a zkontrolujte upravený seznam. Potom pošlete:

Looks good, save all three.

Schvalování je chování řízené promptem, proto je ověřte a nepovažujte za zaručené. V Inbox prohlédněte karty Actions rozhovoru a View logs. Měli byste vidět načtení projektu a potom jednotlivá vytvoření a čtení vrácených ID.

6. Jak ověřit, že se úkoly skutečně uložily?

Otevřete Capture demo v Todoistu a porovnejte tři záznamy se schváleným návrhem. Samotné přátelské „hotovo“ není potvrzením.

Vstup due_date v Quickchat AI vedle úkolu Buy printer paper v Todoistu a zvětšený pohled na jeho pole Project a Date s pátečním datem Sledujte datum napříč oběma aplikacemi: due_date v Action Quickchat AI odpovídá poli Date v Todoistu. Zvětšený postranní panel patří k ručně připravenému úkolu s papírem do tiskárny. U vlastního úkolu otevřete Date a ověřte přesné kalendářní datum.

  1. Zkontrolujte obě přesná data a chybějící datum u úkolu s průvodcem.
  2. Porovnejte id každé odpovědi na vytvoření s následnou odpovědí na čtení. Ověřte, že content, project_id a due odpovídají schválené položce. Neshodu neuzavírejte, dokud ji neprozkoumáte.
  3. Zeptejte se „Co je právě v Capture demo?“ a ověřte, že bot znovu načte aktivní úkoly. Dokončený úkol se v Todoistu z aktivního seznamu ztratí.
  4. Pošlete schválení znovu. Ověřte, že nevznikly další tři úkoly. Bot má zkontrolovat předchozí výsledky a vyjasnit, zda opravdu chcete nové kopie.

Schéma ověření porovnávající schválený úkol, vytvořené ID a následné čtení stejného ID Ověření znamená znovu načíst tentýž uložený záznam a porovnat jeho pole. Schéma ukazuje, co porovnat, nikoli provedenou odpověď API.

Otestujte obě hranice přístupu

Z jiného účtu Telegramu, který ovládáte, pošlete „Ukaž moje úkoly.“ Pro test ve skupině přidejte stejného bota do testovací skupiny, pošlete /start@YOUR_BOT_USERNAME a na jeho pozdrav odpovězte žádostí o vytvoření úkolu. Test tak funguje i s výchozím režimem soukromí skupin v Telegramu.

V Inbox ověřte, že obě testovací zprávy dorazily, a zkontrolujte ID odesílatelů a typy chatů. Test ve skupině musí zobrazovat vaše ID vlastníka a group nebo supergroup. Ani jeden test nesmí odeslat žádný požadavek na Todoist. Vyzkoušejte také zprávu, ve které se vydáváte za vlastníka; text nesmí přepsat metadata odesílatele. Chybějící zpráva je problém s doručením, ne úspěšný test přístupu.

Vyřešte částečně uložený seznam

Vytvoření tří úkolů znamená tři samostatné požadavky. Když druhý selže, první úkol už může existovat. Zastavte se, zkontrolujte projekt a vrácená ID a pak rozhodněte, které položky ještě vytvořit.

Příklad částečného uložení: papír ověřen, e-mail nejistý a průvodce dosud nezkoušen Příklad obnovy: ponechte ověřený úkol, prozkoumejte nejistý zápis a zbývající úkol nechte být, dokud nebude výsledek jasný.

Pokud bot ukládá před schválením, zpřesněte popisy vytvářecích Actions a zopakujte stejný rozhovor. Odhaduje-li datum, vyžadujte přesné datum v návrhu. Hlásí-li úspěch po chybě, upravte pokyn k opětovnému čtení. Sada tyto kontroly obsahuje, abyste mohli zaznamenat vlastní výsledky před použitím osobních úkolů.

Jakmile toto cvičení se třemi položkami funguje, používejte Pocket Inbox pro drobné zprávy, které by jinak zůstaly v Saved Messages: pochůzku, e-mail nebo čtení. U prvních seznamů nechte Todoist otevřený a porovnávejte záměr s uloženým výsledkem. Kontrola se tak stane návykem podloženým pozorováním.

Často kladené otázky

Může Telegram bot vytvářet úkoly Todoist?

Ano. Bot připojený k API Todoistu může vytvářet úkoly ze zpráv Telegramu. Tento postup používá Quickchat AI k rozdělení zprávy na navrhované úkoly, upřesnění dat, vyžádání souhlasu a volání Todoist API v1. Výsledné záznamy ověřte ve vlastním projektu Todoist.

Mohou ostatní uživatelé Telegramu vidět moje úkoly Todoist?

Na každou čtecí i zapisovací Action použijte obě serverové podmínky: telegram_user_id musí odpovídat vašemu ověřenému číselnému ID a telegram_chat_type musí být private. Před použitím osobních údajů otestujte jiného odesílatele i skupinový rozhovor. Prompt určující pouze vlastníka neposkytuje řízení přístupu.

Pochopí bot příští pátek nebo možná pondělí?

Prompt požaduje upřesnění nejasných dat a zobrazení přesného data YYYY-MM-DD před uložením. Uveďte časové pásmo a potvrďte konečná data. Úkol bez data používá samostatnou Action, která zcela vynechává pole termínu.

Brání to duplicitním úkolům Todoist?

Ne. Načítání stávajících úkolů a kontrola vrácených ID pomáhají duplicity odhalit, ale nejde o atomickou dávku ani zaručenou deduplikaci. Po vypršení časového limitu požadavku nejprve zkontrolujte Todoist; úkol už mohl být uložen.

Potřebuji kód nebo MCP server Todoist?

V Quickchat AI nastavíte čtyři HTTP Actions a Main Prompt. MCP server Todoist provozovat nemusíte. Potřebujete Telegram bota, API token Todoistu a tarif Quickchat AI s dostatečnou kapacitou Actions a kredity na testy i rozhovory.

Umí zpracovávat hlasové zprávy nebo posílat připomenutí?

Tato první verze přijímá text a vytváří úkoly s datem nebo bez data. Nepřepisuje hlasové zprávy, neplánuje připomenutí, nedokončuje úkoly ani nepřipojuje cizí účty Todoist. Tyto možnosti vyžadují samostatné nastavení a testování.

Quickchat AI Quickchat AI Ask Quickchat AI a question