Van Telegram naar Todoist: maak van losse ideeën gecontroleerde taken

Piotr Grudzień
Gepubliceerd 11 min leestijd
Een taak-Action van Quickchat AI naast een Todoist-project met drie voorbeeldtaken

Een Telegram-bot voor Todoist kan een bericht vol losse voornemens veranderen in een takenlijst die je hebt gecontroleerd. Je bouwt Pocket Inbox, een persoonlijke bot die de taken opsplitst, doorvraagt over onduidelijke datums en de reeks na jouw goedkeuring in één Todoist-project opslaat.

Begin met een bericht dat je bij het verlaten van kantoor zou kunnen sturen:

Vrijdag printerpapier kopen, de locatie misschien maandag mailen en de wandelgids lezen als ik tijd heb.

Het Todoist-project Capture demo met Buy printer paper op vrijdag, Email the venue op maandag en Read the trail guide zonder datum De lijst die je gaat maken: drie taken, twee datums en één bewust ongedateerd item. Deze echte Todoist-screenshots gebruiken handmatig voorbereide demotaken; de Quickchat AI-screenshots tonen lokale instellingen. In stap 6 controleer je de resultaten van je verbonden bot.

Het interessante deel is ‘misschien maandag’. Dat moet worden opgehelderd voordat er een deadline ontstaat. ‘Als ik tijd heb’ hoort zonder datum te blijven. Die korte controle maakt het gesprek nuttig: je kunt eerst de gedachte vastleggen en daarna de details bepalen zonder het hele bericht opnieuw te schrijven.

Volg zes stappen om de accounts voor te bereiden, toegang te beperken, Todoist te verbinden, de controle aan te leren, drie taken goed te keuren en het resultaat te verifiëren. Het Pocket Inbox-startpakket bevat de vier Action-recepten, de prompt en een testchecklist. Het zijn bestanden om te kopiëren, geen automatische import van een agent.

1. Wat heb je nodig om Telegram met Todoist te verbinden?

Je hebt een Telegram-bot onder je eigen beheer nodig, een Todoist-account en een Quickchat AI-agent met ruimte voor vier HTTP Actions. Beperk de eerste versie tot één persoon, één project en tekstberichten.

  1. Log in bij Todoist en maak een project met de naam Capture demo. Gebruik zo mogelijk een apart testaccount. Een persoonlijk API-token heeft de rechten van het account; een vast project-ID in je recept beperkt het token zelf niet.

Het dialoogvenster Add project van Todoist met Capture demo ingevuld, gevolgd door het lege project Capture demo Geef het project eerst een naam en open daarna de lege takenlijst. Dit is de bestemming die je bij elke aanmaak-Action kiest.

  1. Maak een Quickchat AI-account en kies Add new AI Agent → Set up manually. Geef het de naam Pocket Inbox. Controleer de actuele abonnementen en Action-limieten; AI-antwoorden en Simulation Testing kosten credits.
  2. Maak je bot met BotFather. De handleiding voor het maken van een Telegram-bot behandelt gebruikersnaam en token. Vul het token rechtstreeks in bij External Apps → Telegram → Your own bot → Connect to Telegram, schakel de integratie in en sla op.
  3. Schakel onder Your Website → Install → Availability and access de optie Widget & Embed access uit en zet Chat Page Access op Nobody. Gebruik voor deze werkwijze je privégesprek in Telegram.
  4. Open de bot in Telegram, druk op Start en stuur een korte begroeting. Laat de Todoist Actions inactief totdat je de onderstaande toegangsregels hebt ingesteld.

Telegram-instellingen in Quickchat AI met de verbindingsoptie Your own bot Geef Pocket Inbox een eigen Telegram-identiteit. Dit lokale configuratiescherm bevat geen actief bot-token.

Je hebt nu een plek om gedachten vast te leggen. Bepaal voordat je je taken verbindt welke Telegram-afzender er toegang toe krijgt.

2. Hoe houd je de Todoist-bot privé?

Koppel elke lees- en schrijfactie aan je Telegram-gebruikers-ID en een privéchat. Quickchat AI controleert deze voorwaarden voordat het HTTP-verzoek wordt verstuurd.

  1. Open in Inbox het echte Telegram-gesprek met je begroeting. Kies Details → Visitor. Kopieer de numerieke waarde naast Telegram User Id en controleer of Telegram Chat Type private is.
  2. Zet bij elke Action die je in de volgende stap maakt When to run op AI decides.
  3. Voeg onder Run only when beide onderstaande voorwaarden toe. Gebruik het ID uit dat gesprek, geen gebruikersnaam of een ID dat in een bericht is getypt.
MetadatasleutelVergelijkingWaarde
telegram_user_idequalsJe geverifieerde numerieke Telegram-gebruikers-ID
telegram_chat_typeequalsprivate

Action-editor met Telegram-gebruikers-ID en privéchat als twee verplichte uitvoeringsvoorwaarden Beide voorwaarden moeten kloppen. Het numerieke ID in deze lokale testgegevens is een voorbeeld; vervang het door je eigen geverifieerde waarde.

Diagram van een Telegram-afzender die de controles voor eigenaar en privéchat doorloopt voordat een Todoist-verzoek wordt verstuurd Telegram levert de identiteit. Het gesprek levert de voorgestelde taak. Dat zijn verschillende invoergegevens.

De documentatie voor Run only when legt de voorwaarden uit. Alleen een privéchat is onvoldoende, omdat iemand anders ook een privéchat met je bot kan openen. Een prompt die uitsluitend de eigenaar toestaat is evenmin voldoende. Pas de twee controles even zorgvuldig toe op lees-Actions als op aanmaak-Actions.

De normale webpreview mist geverifieerde Telegram-metadata, dus deze Actions horen daar te worden geweigerd. Laat de voorwaarden staan en gebruik het echte kanaal voor de eindtest.

3. Hoe verbind je de bot met de Todoist-API?

Maak vier HTTP Actions: actieve projecttaken opvragen, een taak met datum maken, een taak zonder datum maken en een opgeslagen taak teruglezen. De aparte aanmaak-Actions maken geen datum een bewuste keuze.

Het verzoek gebruikt dezelfde velden die je ziet wanneer je een taak in Todoist toevoegt: een titel, een doelproject en een optionele datum.

Het invoerformulier van Todoist met Buy printer paper, de projectkeuze Capture demo en het veld Date, plus een vergrote weergave van die velden De taakvelden van dichterbij. De API-recepten hieronder geven de titel mee als content, het project als project_id en een goedgekeurde datum als due_date. Het recept zonder datum laat de datum weg.

Bereid het token en project-ID voor

  1. Open in de webapp van Todoist avatar → Settings → Integrations → Developer → Copy API token, zoals beschreven in de officiële tokeninstructies.
  2. Kies in Quickchat AI Actions & MCPs → Add Action → API Action → Create manually. Vul bij elk recept het token rechtstreeks in onder Headers → Authorization als Bearer YOUR_TODOIST_TOKEN. Ga ervan uit dat mensen die de agent kunnen bewerken ook toegang tot vaste headers hebben. Houd het token buiten de prompt, chat en screenshots.
  3. Maak om het project-ID te vinden een tijdelijke, inactieve setup-Action met GET https://api.todoist.com/api/v1/projects, de Authorization-header en Accept: application/json. Gebruik Test in de editor, bekijk results en kopieer het id naast Capture demo. Geef zo nodig de teruggegeven next_cursor mee als querywaarde cursor bij het volgende verzoek. Verwijder de setup-Action daarna.
  4. Plak het door de server teruggegeven ID overal waar de recepten YOUR_PROJECT_ID vermelden. Houd het vast, niet als parameter die de AI invult. Een tmp--ID is nog niet gesynchroniseerd en kan hier niet worden gebruikt.

De actuele Todoist-API-referentie beschrijft deze endpoints. Gebruik /api/v1, inclusief het gepagineerde lijstantwoord, in plaats van een ouder REST-v2-recept te kopiëren.

Configureer de vier Actions

De handleiding voor de API Action-builder legt de editor uit. Voeg elke invoer toe onder What to ask the user first. Gebruik Add AI Data om de parameterchip in de URL, queryrij of body te plaatsen; de notatie {{...}} hieronder benoemt die chips.

Voeg bij alle vier de Actions Accept: application/json toe, behoud beide eigenaarsvoorwaarden en laat Response Filter leeg zodat teruggegeven taak-ID’s en paginagegevens zichtbaar blijven. Voeg bij beide POST Actions ook Content-Type: application/json toe.

Action voor een taak met datum, met een content-chip, vast project-ID en due_date-chip in de JSON-body Titel en datum komen uit het goedgekeurde concept. Het doelproject blijft vast ingesteld in de Action.

Kopieer Action 1 van 4: Read capture tasks

API Action Name: Read capture tasks

What to ask the user first:

GegevenstypeNaamBeschrijvingVerplicht
TextcursorLaat weg op de eerste pagina. Kopieer voor de volgende pagina next_cursor uit het vorige resultaat.Nee

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

Laat de standaardwaarde van de optionele invoer cursor leeg en gebruik de chip als volledige waarde van de queryrij. Voeg hem niet toe aan de endpoint-URL.

Body: leeg.

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.
Kopieer Action 2 van 4: Create dated capture task

API Action Name: Create dated capture task

What to ask the user first:

GegevenstypeNaamBeschrijvingVerplicht
TextcontentExacte taaktitel uit de definitieve reeks die de gebruiker heeft goedgekeurd.Ja
Textdue_dateExacte goedgekeurde datum in YYYY-MM-DD, zonder tijdstip.Ja

API Endpoint en Headers:

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

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

Tabblad Body, JSON-modus:

{
  "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.
Kopieer Action 3 van 4: Create undated capture task

API Action Name: Create undated capture task

What to ask the user first:

GegevenstypeNaamBeschrijvingVerplicht
TextcontentExacte taaktitel die zonder datum is goedgekeurd.Ja

API Endpoint en Headers:

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

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

Tabblad Body, JSON-modus:

{
  "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.
Kopieer Action 4 van 4: Read a saved capture task

API Action Name: Read a saved capture task

What to ask the user first:

GegevenstypeNaamBeschrijvingVerplicht
Texttask_idServer-ID van een taak, teruggegeven bij aanmaak of door de projectgebonden lijst. Nooit raden.Ja

API Endpoint en Headers:

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

Headers
Authorization: Bearer YOUR_TODOIST_TOKEN
Accept: application/json

Body: leeg.

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.

Het endpoint voor één taak is zelf niet projectgebonden. De invoerregel houdt deze persoonlijke werkwijze bij teruggegeven taak-ID’s, terwijl de voorwaarden voor de vertrouwde afzender de toegang regelen. Gebruik een apart Todoist-account als ook de toegangsgegevens zelf van andere projecten gescheiden moeten zijn.

Vier Pocket Inbox Actions in Quickchat AI, verdeeld in lezen en aanmaken met of zonder datum De volledige set tools. Laat de Actions inactief terwijl je tijdelijke waarden invult en de voorwaarden controleert.

4. Welke instructies moet de takenbot volgen?

Vertel Pocket Inbox eerst een concept te maken, onzekerheid op te lossen en je goedkeuring voor de definitieve velden te vragen. Plaats het volgende onder Identity → Main Prompt → Edit.

Main Prompt van Pocket Inbox in de Identity-instellingen van Quickchat AI De prompt leert het controlegesprek aan. De Action-voorwaarden bepalen wie toegang tot Todoist krijgt.

Kopieer de volledige Main Prompt van 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.

Je kunt ondersteunde instellingen ook voorbereiden via de verbinding voor Quickchat AI-accountbeheer in ChatGPT of Claude. Geef de verbonden assistent het pakket en dit verzoek:

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.

Die verbinding beheert Quickchat AI-instellingen. Je maakt nog steeds zelf de Telegram-bot, vult de toegangsgegevens rechtstreeks in en test je echte Telegram/Todoist-verbinding.

5. Hoe worden losse ideeën drie goedgekeurde taken?

Gebruik het oorspronkelijke bericht om het gesprek te testen voordat je toestemming geeft om op te slaan. Zodra de vier Actions de juiste toegangsgegevens, het juiste project en de juiste voorwaarden hebben, schakel je ze in en stuur je het bericht in je privéchat op Telegram.

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

De bot hoort drie taken voor te stellen en naar de datums te vragen. Er hoort nog geen aanmaak-Action te draaien. Antwoord voor een herhaalbaar voorbeeld met expliciete datums:

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

Dit zijn vaste voorbeelddatums, geen definitie van ‘deze vrijdag’ voor elk moment waarop je het artikel leest. Vervang ze door de datums die je in je eigen test wilt gebruiken.

Diagram dat vrijdag verduidelijkt als 20 november, misschien maandag als 23 november en als ik tijd heb als geen datum Los de onzekerheid op voordat je taken maakt. Dit zijn voorbeeldinvoeren en de beoogde definitieve velden.

Vergelijk het definitieve concept van de bot met deze tabel:

TaakBevestigde datumProject
Printerpapier kopen2026-11-20Capture demo
De locatie mailen2026-11-23Capture demo
De wandelgids lezenGeen datumCapture demo

Als iets afwijkt, corrigeer het dan en bekijk de aangepaste reeks. Stuur vervolgens:

Looks good, save all three.

Goedkeuring is gedrag dat door de prompt wordt aangestuurd. Test het dus in plaats van aan te nemen dat het gegarandeerd is. Bekijk in Inbox de Action-kaarten van het gesprek en View logs. Je hoort eerst een projectlezing te zien, gevolgd door afzonderlijke aanmaken en lezingen van de teruggegeven ID’s.

6. Hoe controleer je of de taken echt zijn opgeslagen?

Open Capture demo in Todoist en vergelijk de drie records met je goedgekeurde concept. Een vriendelijk ‘klaar’ is op zichzelf geen bewijs.

De due_date-invoer van Quickchat AI naast de taak Buy printer paper in Todoist en een vergrote weergave van de velden Project en Date met vrijdag Volg de datum door beide apps: due_date in de Quickchat AI-Action komt overeen met Date in Todoist. De vergrote zijbalk hoort bij de handmatig voorbereide printerpapiertaak. Open Date in je eigen taak om de exacte kalenderdatum te controleren.

  1. Controleer de twee exacte datums en het ontbreken van een datum bij de wandelgidstaak.
  2. Vergelijk het id van elk aanmaakantwoord met het daaropvolgende leesantwoord. Controleer of content, project_id en due overeenkomen met het goedgekeurde item. Laat een afwijking onopgelost totdat je die hebt onderzocht.
  3. Vraag ‘Wat staat er momenteel in Capture demo?’ en controleer of de bot de actieve taken opnieuw leest. Als je een taak in Todoist voltooit, verschijnt die niet meer in de actieve lijst.
  4. Stuur de goedkeuring nogmaals. Controleer of er geen drie extra taken verschijnen. De bot hoort eerdere resultaten te bekijken en te vragen of je nieuwe kopieën bedoelt.

Verificatiediagram dat een goedgekeurde taak vergelijkt met het aangemaakte ID en het daaropvolgende lezen van hetzelfde ID Verifiëren betekent hetzelfde opgeslagen record lezen en de velden controleren. Het diagram toont wat je moet vergelijken, geen daadwerkelijk uitgevoerd API-antwoord.

Test de twee toegangsgrenzen

Stuur vanuit een afzonderlijk Telegram-account onder je beheer ‘Toon mijn taken.’ Voeg voor de groepstest dezelfde bot toe aan een testgroep, stuur /start@YOUR_BOT_USERNAME en beantwoord zijn begroeting met een verzoek om een taak te maken. Zo werkt de test met Telegrams standaard privacymodus voor groepen.

Bevestig in Inbox dat beide testberichten zijn aangekomen en controleer de afzender-ID’s en chattypen. De groepstest moet jouw eigenaars-ID en group of supergroup tonen. Beide tests horen geen Todoist-verzoek op te leveren. Probeer ook een bericht dat beweert van de eigenaar te zijn; tekst mag de afzendermetadata niet overschrijven. Een ontbrekend bericht is een bezorgprobleem, geen geslaagde toegangstest.

Handel een gedeeltelijk opgeslagen reeks af

Drie taken aanmaken betekent drie afzonderlijke verzoeken. Als het tweede verzoek mislukt, kan de eerste taak al bestaan. Stop, bekijk het project en de teruggegeven ID’s en bepaal welke items nog moeten worden gemaakt.

Voorbeeld van een gedeeltelijke reeks: printerpapier geverifieerd, e-mail aan de locatie onzeker en wandelgids nog niet geprobeerd Herstelvoorbeeld: behoud de geverifieerde taak, onderzoek de onzekere schrijfactie en laat de resterende taak ongemoeid totdat de uitkomst duidelijk is.

Als de bot vóór goedkeuring opslaat, scherp dan de beschrijvingen van de aanmaak-Actions aan en herhaal hetzelfde gesprek. Als hij een datum raadt, vereis dan de exacte datum in het concept. Als hij na een fout toch succes meldt, bekijk dan de instructie voor het teruglezen opnieuw. Het pakket bevat deze controles zodat je je eigen resultaten kunt vastleggen voordat je persoonlijke taken gebruikt.

Zodra deze oefening met drie items werkt, gebruik je Pocket Inbox voor korte berichten die anders in Saved Messages blijven liggen: een boodschap, een te versturen e-mail, iets om te lezen. Houd Todoist bij de eerste reeksen open en vergelijk je bedoeling met wat is opgeslagen. Zo wordt de controle een gewoonte waarop je door eigen waarneming kunt vertrouwen.

Veelgestelde vragen

Kan een Telegram-bot Todoist-taken maken?

Ja. Een bot die met de Todoist-API is verbonden, kan taken maken van Telegram-berichten. Dit recept gebruikt Quickchat AI om een bericht in voorgestelde taken te splitsen, datums te verduidelijken, goedkeuring te vragen en Todoist API v1 aan te roepen. Controleer de aangemaakte records in je eigen Todoist-project.

Kunnen andere Telegram-gebruikers mijn Todoist-taken zien?

Pas beide op de server gecontroleerde voorwaarden toe op elke lees- en schrijf-Action: telegram_user_id moet gelijk zijn aan je geverifieerde numerieke ID en telegram_chat_type moet private zijn. Test een andere afzender en een groepsgesprek voordat je persoonlijke gegevens gebruikt. Een prompt die alleen de eigenaar toestaat, biedt geen toegangscontrole.

Begrijpt de bot volgende vrijdag of misschien maandag?

De prompt vraagt de bot onzekere datums te verduidelijken en vóór het opslaan een exacte datum in de vorm YYYY-MM-DD te tonen. Geef je tijdzone op en bevestig de definitieve datums. Een taak zonder datum gebruikt een aparte Action die alle vervaldatumvelden weglaat.

Voorkomt dit dubbele Todoist-taken?

Nee. Bestaande taken lezen en teruggegeven ID’s controleren helpt duplicaten te herkennen, maar dit recept is geen atomaire batchbewerking of gegarandeerd ontdubbelingssysteem. Controleer Todoist na een time-out voordat je opnieuw probeert; de taak kan al opgeslagen zijn.

Heb ik code of een Todoist-MCP-server nodig?

Je configureert vier HTTP Actions en een Main Prompt in Quickchat AI. Je hoeft geen Todoist-MCP-server te draaien. Je hebt een Telegram-bot, een Todoist-API-token en een Quickchat AI-abonnement met voldoende Action-capaciteit en credits voor tests en gesprekken nodig.

Kan de bot spraakberichten verwerken of herinneringen sturen?

Deze eerste versie verwerkt tekst en maakt taken met of zonder datum. De bot transcribeert geen spraakberichten, plant geen herinneringen, voltooit geen taken en verbindt geen Todoist-accounts van anderen. Voor die mogelijkheden zijn aparte configuratie en tests nodig.

Quickchat AI Quickchat AI Ask Quickchat AI a question