Telegramin Todoist-botti voi muuttaa irrallisia aikomuksia sisältävän viestin tehtävälistaksi, jonka olet tarkistanut. Rakennat Pocket Inboxin, henkilökohtaisen botin, joka erottaa tehtävät, kysyy epäselvistä päivämääristä ja tallentaa kokonaisuuden yhteen Todoist-projektiin hyväksyntäsi jälkeen.
Aloita viestillä, jonka voisit lähettää lähtiessäsi toimistolta:
Osta tulostinpaperia perjantaina, lähetä tapahtumapaikalle sähköpostia ehkä maanantaina ja lue retkeilyopas, kun on aikaa.
Rakentamasi lista: kolme tehtävää, kaksi päivää ja yksi tarkoituksella päivämäärätön kohta. Näissä aidoissa Todoist-kuvakaappauksissa käytetään käsin valmisteltuja demotehtäviä; Quickchat AI -kuvat näyttävät paikalliset asetukset. Vaiheessa 6 tarkistat yhdistetyn bottisi tulokset.
Kiinnostava kohta on ”ehkä maanantaina”. Se on selvitettävä ennen määräpäivän luomista. ”Kun on aikaa” pitää jättää ilman päivämäärää. Lyhyt tarkistus tekee keskustelusta hyödyllisen: voit ensin kirjata ajatuksen ja sitten täsmentää yksityiskohdat kirjoittamatta koko viestiä uudelleen.
Seuraa kuutta vaihetta: valmistele tilit, rajaa pääsy, yhdistä Todoist, ohjeista tarkistus, hyväksy kolme tehtävää ja varmista tulos. Pocket Inbox -aloituspaketti sisältää kaikki neljä Action-ohjetta, promptin ja testien tarkistuslistan. Se on joukko kopioitavia tiedostoja, ei automaattinen agentin tuonti.
1. Mitä tarvitset Telegramin yhdistämiseen Todoistiin?
Tarvitset hallinnassasi olevan Telegram-botin, Todoist-tilin ja Quickchat AI -agentin, jossa on tilaa neljälle HTTP Actionille. Rajaa ensimmäinen versio yhteen henkilöön, yhteen projektiin ja tekstiviesteihin.
- Kirjaudu Todoistiin ja luo projekti nimeltä Capture demo. Käytä mahdollisuuksien mukaan erillistä testitiliä. Henkilökohtaisella API-tunnuksella on tilin käyttöoikeudet; ohjeen kiinteä projektitunniste ei rajaa itse API-tunnusta.
Nimeä ensin projekti ja avaa sitten sen tyhjä tehtävälista. Tämä on kohde, jonka valitset jokaisessa tehtäviä luovassa Actionissa.
- Luo Quickchat AI -tili ja valitse Add new AI Agent → Set up manually. Anna nimeksi Pocket Inbox. Tarkista nykyiset tilaukset ja Action-rajat; AI-vastaukset ja Simulation Testing kuluttavat krediittejä.
- Luo bottisi BotFatherilla. Telegram-botin luontiohje käsittelee käyttäjänimen ja tunnuksen. Syötä tunnus suoraan kohtaan External Apps → Telegram → Your own bot → Connect to Telegram, ota integraatio käyttöön ja tallenna.
- Poista Widget & Embed access käytöstä kohdassa Your Website → Install → Availability and access ja aseta Chat Page Access arvoon Nobody. Käytä tähän työnkulkuun yksityistä Telegram-keskusteluasi.
- Avaa botti Telegramissa, paina Start ja lähetä lyhyt tervehdys. Pidä Todoist Actionit poissa käytöstä, kunnes olet määrittänyt alla olevat pääsysäännöt.
Anna Pocket Inboxille oma Telegram-identiteetti. Tämä paikallinen asetusnäkymä ei sisällä aktiivisen botin tunnusta.
Nyt sinulla on paikka ajatusten keräämiseen. Päätä ennen tehtävien yhdistämistä, kuka Telegram-lähettäjä saa käyttää niitä.
2. Miten pidät Todoist-botin yksityisenä?
Edellytä jokaiselta luku- ja kirjoitustoiminnolta omaa Telegram-käyttäjätunnistettasi ja yksityistä keskustelua. Quickchat AI arvioi ehdot ennen HTTP-pyynnön lähettämistä.
- Avaa Inboxissa oikea Telegram-keskustelu, jossa lähetit tervehdyksen. Valitse Details → Visitor. Kopioi numeerinen arvo kohdan Telegram User Id vierestä ja varmista, että Telegram Chat Type on
private. - Aseta jokaisessa seuraavassa vaiheessa luomassasi Actionissa When to run arvoon AI decides.
- Lisää Run only when -kohtaan molemmat alla olevat ehdot. Käytä tunnistetta kyseisestä keskustelusta, älä käyttäjänimeä tai viestiin kirjoitettua tunnistetta.
| Metatietoavain | Vertailu | Arvo |
|---|---|---|
telegram_user_id | equals | Vahvistettu numeerinen Telegram-käyttäjätunnisteesi |
telegram_chat_type | equals | private |
Molempien ehtojen on täytyttävä. Näiden paikallisten testitietojen numeerinen tunniste on esimerkki; korvaa se omalla vahvistetulla arvollasi.
Telegram antaa henkilöllisyyden. Keskustelu antaa ehdotetun tehtävän. Ne ovat eri syötteitä.
Run only when -dokumentaatio selittää ehdot. Pelkkä yksityinen keskustelu ei riitä, sillä muutkin voivat avata yksityisen keskustelun bottisi kanssa. Myöskään vain omistajan salliva prompt ei riitä. Käytä molempia tarkistuksia lukevissa Actioneissa yhtä huolellisesti kuin luovissa.
Tavallisesta verkkoesikatselusta puuttuvat Telegramin vahvistetut metatiedot, joten nämä Actionit pitäisi estää siellä. Säilytä ehdot ja käytä lopputestiin oikeaa kanavaa.
3. Miten yhdistät botin Todoistin APIin?
Luo neljä HTTP Actionia: projektin aktiivisten tehtävien listaus, päivämäärällisen tehtävän luonti, päivämäärättömän tehtävän luonti ja tallennetun tehtävän uudelleenlukeminen. Erilliset luonti-Actionit tekevät valinnasta ei päivämäärää nimenomaisen.
Pyyntö käyttää samoja kenttiä, jotka näet lisätessäsi tehtävän Todoistiin: nimeä, kohdeprojektia ja valinnaista päivämäärää.
Tehtäväkentät lähempää. Alla olevat API-ohjeet antavat nimen kenttänä content, projektin kenttänä project_id ja hyväksytyn päivämäärän kenttänä due_date. Päivämäärätön ohje jättää päivän pois.
Valmistele API-tunnus ja projektitunniste
- Avaa Todoistin verkkosovelluksessa avatar → Settings → Integrations → Developer → Copy API token, kuten virallinen tunnusohje neuvoo.
- Valitse Quickchat AIssa Actions & MCPs → Add Action → API Action → Create manually. Syötä jokaisessa ohjeessa tunnus suoraan kohtaan Headers → Authorization muodossa
Bearer YOUR_TODOIST_TOKEN. Oleta, että agenttia muokkaavat henkilöt pääsevät myös kiinteisiin otsakkeisiin. Älä laita tunnusta promptiin, keskusteluun tai kuvakaappauksiin. - Selvitä projektitunniste luomalla väliaikainen, käytöstä poistettu määritys-Action:
GET https://api.todoist.com/api/v1/projects, Authorization-otsake jaAccept: application/json. Käytä editorin Test-työkalua, tutkiresultsja kopioiidkohdan Capture demo vierestä. Tarvittaessa välitä palautettunext_cursorseuraavan pyynnöncursor-kyselyarvoksi. Poista määritys-Action lopuksi. - Liitä palvelimen palauttama tunniste kaikkiin kohtiin, joissa ohjeissa lukee
YOUR_PROJECT_ID. Pidä se kiinteänä arvona, älä AI:n täyttämänä parametrina.tmp--tunnistetta ei ole synkronoitu, eikä sitä voi käyttää tässä.
Todoistin nykyinen API-viite dokumentoi nämä päätepisteet. Käytä /api/v1-versiota ja sen sivutettua listavastausta vanhan REST-v2-ohjeen kopioimisen sijaan.
Määritä neljä Actionia
API Action -rakentajan ohje selittää editorin. Lisää jokainen syöte kohtaan What to ask the user first. Lisää parametrimerkki URL-osoitteeseen, kyselyriville tai runkoon valinnalla Add AI Data; alla oleva {{...}}-merkintä nimeää nämä merkit.
Lisää kaikkiin neljään Actioniin Accept: application/json, säilytä molemmat omistajaehdot ja jätä Response Filter tyhjäksi, jotta palautetut tehtävätunnisteet ja sivutustiedot näkyvät. Lisää molempiin POST Actioneihin myös Content-Type: application/json.
Nimi ja päivämäärä tulevat hyväksytystä luonnoksesta. Kohdeprojekti pysyy kiinteänä Actionissa.
Kopioi Action 1/4: Read capture tasks
API Action Name: Read capture tasks
What to ask the user first:
| Tietotyyppi | Nimi | Kuvaus | Pakollinen |
|---|---|---|---|
| Text | cursor | Jätä pois ensimmäisellä sivulla. Kopioi seuraavalle sivulle next_cursor edellisestä tuloksesta. | Ei |
API Endpoint, Query Params ja 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
Jätä valinnaisen cursor-syötteen oletusarvo tyhjäksi ja aseta sen parametrimerkki kyselyrivin koko arvoksi. Älä lisää sitä päätepisteen URL-osoitteeseen.
Body: tyhjä.
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.
Kopioi Action 2/4: Create dated capture task
API Action Name: Create dated capture task
What to ask the user first:
| Tietotyyppi | Nimi | Kuvaus | Pakollinen |
|---|---|---|---|
| Text | content | Tehtävän tarkka nimi käyttäjän hyväksymästä lopullisesta kokonaisuudesta. | Kyllä |
| Text | due_date | Tarkka hyväksytty päivämäärä muodossa YYYY-MM-DD, ilman kellonaikaa. | Kyllä |
API Endpoint ja Headers:
POST https://api.todoist.com/api/v1/tasks
Headers
Authorization: Bearer YOUR_TODOIST_TOKEN
Accept: application/json
Content-Type: application/json
Body-välilehti, JSON-tila:
{
"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.
Kopioi Action 3/4: Create undated capture task
API Action Name: Create undated capture task
What to ask the user first:
| Tietotyyppi | Nimi | Kuvaus | Pakollinen |
|---|---|---|---|
| Text | content | Ilman päivämäärää hyväksytyn tehtävän tarkka nimi. | Kyllä |
API Endpoint ja Headers:
POST https://api.todoist.com/api/v1/tasks
Headers
Authorization: Bearer YOUR_TODOIST_TOKEN
Accept: application/json
Content-Type: application/json
Body-välilehti, JSON-tila:
{
"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.
Kopioi Action 4/4: Read a saved capture task
API Action Name: Read a saved capture task
What to ask the user first:
| Tietotyyppi | Nimi | Kuvaus | Pakollinen |
|---|---|---|---|
| Text | task_id | Luonnin tai projektiin rajatun listan palauttama palvelimen tehtävätunniste. Älä koskaan arvaa. | Kyllä |
API Endpoint ja Headers:
GET https://api.todoist.com/api/v1/tasks/{{task_id}}
Headers
Authorization: Bearer YOUR_TODOIST_TOKEN
Accept: application/json
Body: tyhjä.
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.
Yksittäisen tehtävän päätepiste ei itsessään rajoitu projektiin. Syötesääntö pitää tämän henkilökohtaisen työnkulun palautetuissa tehtävätunnisteissa, ja luotetun lähettäjän ehdot hallitsevat pääsyä. Käytä erillistä Todoist-tiliä, jos myös itse API-tunnus on erotettava muista projekteista.
Koko työkalujoukko. Pidä Actionit poissa käytöstä, kun täytät paikkamerkkejä ja tarkistat ehtoja.
4. Mitä ohjeita tehtäväbotin pitäisi seurata?
Ohjeista Pocket Inbox tekemään ensin luonnos, selvittämään epävarmuudet ja pyytämään sinua hyväksymään lopulliset kentät. Lisää seuraava kohtaan Identity → Main Prompt → Edit.
Prompt opettaa tarkistuskeskustelun. Action-ehdot valvovat, kuka pääsee Todoistiin.
Kopioi Pocket Inboxin koko Main Prompt
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.
Voit myös valmistella tuettuja asetuksia Quickchat AI -tilinhallintayhteydellä ChatGPT:ssä tai Claudessa. Anna yhdistetylle avustajalle paketti ja tämä pyyntö:
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.
Yhteys hallinnoi Quickchat AI -asetuksia. Luot silti Telegram-botin itse, syötät tunnukset suoraan ja testaat oikean Telegram/Todoist-yhteytesi.
5. Miten irrallisista ajatuksista syntyy kolme hyväksyttyä tehtävää?
Testaa keskustelu alkuperäisellä viestillä ennen tallennuksen hyväksymistä. Kun neljän Actionin tunnukset, projekti ja ehdot ovat oikein, ota ne käyttöön ja lähetä viesti yksityisessä Telegram-keskustelussasi.
Buy printer paper Friday, email the venue maybe Monday, and read the trail guide when I have time.
Botin pitäisi ehdottaa kolmea tehtävää ja kysyä päivämääristä. Yhtäkään luonti-Actionia ei pitäisi vielä suorittaa. Vastaa toistettavaa esimerkkiä varten täsmällisillä päivämäärillä:
Use Europe/Warsaw. Friday means 2026-11-20. Make the venue email Monday, 2026-11-23. Leave the trail guide without a date.
Nämä ovat kiinteitä esimerkkipäiviä, eivät ”tämän perjantain” määritelmä aina artikkelia luettaessa. Korvaa ne omassa testissäsi haluamillasi päivillä.
Selvitä epävarmuus ennen tehtävien luomista. Tässä näkyvät esimerkkisyötteet ja tavoitellut lopulliset kentät.
Vertaa botin lopullista luonnosta tähän taulukkoon:
| Tehtävä | Vahvistettu päivä | Projekti |
|---|---|---|
| Osta tulostinpaperia | 2026-11-20 | Capture demo |
| Lähetä sähköpostia tapahtumapaikalle | 2026-11-23 | Capture demo |
| Lue retkeilyopas | Ei päivämäärää | Capture demo |
Jos jokin eroaa, korjaa se ja tarkista päivitetty kokonaisuus. Lähetä sitten:
Looks good, save all three.
Hyväksyntä on promptin ohjaamaa toimintaa, joten testaa se sen sijaan, että pitäisit sitä taattuna. Tutki Inboxissa keskustelun Action-kortit ja View logs. Ensin pitäisi näkyä projektin luku ja sen jälkeen yksittäiset luonnit ja palautettujen tunnisteiden lukukutsut.
6. Miten tarkistat, että tehtävät todella tallentuivat?
Avaa Capture demo Todoistissa ja vertaa kolmea tietuetta hyväksyttyyn luonnokseen. Ystävällinen ”valmista”-viesti ei yksin ole todiste.
Seuraa päivämäärää molemmissa sovelluksissa: Quickchat AI -Actionin due_date vastaa Todoistin Date-kenttää. Suurennettu sivupalkki kuuluu käsin valmisteltuun tulostinpaperitehtävään. Avaa oman tehtäväsi Date ja tarkista tarkka kalenteripäivä.
- Tarkista kaksi täsmällistä päivää ja se, ettei retkeilyoppaan tehtävällä ole päivämäärää.
- Vertaa jokaisen luontivastauksen
id-arvoa sitä seuraavaan lukuvastaukseen. Varmista, ettäcontent,project_idjaduevastaavat hyväksyttyä kohtaa. Pidä poikkeamaa selvittämättömänä, kunnes olet tutkinut sen. - Kysy ”Mitä Capture demossa on tällä hetkellä?” ja tarkista, että botti lukee aktiiviset tehtävät uudelleen. Jos merkitset tehtävän valmiiksi Todoistissa, se ei enää näy aktiivisten listalla.
- Lähetä hyväksyntä uudelleen. Tarkista, ettei synny kolmea uutta tehtävää. Botin pitäisi tutkia aiemmat tulokset ja selvittää, haluatko uusia kopioita.
Varmistaminen tarkoittaa saman tallennetun tietueen lukemista ja sen kenttien tarkistamista. Kaavio näyttää, mitä verrataan, ei toteutuneen API-kutsun vastausta.
Testaa kaksi pääsyrajaa
Lähetä toiselta hallinnassasi olevalta Telegram-tililtä ”Näytä tehtäväni.” Lisää ryhmätestiä varten sama botti testiryhmään, lähetä /start@YOUR_BOT_USERNAME ja vastaa sen tervehdykseen tehtävän luontipyynnöllä. Näin testi toimii Telegramin oletusarvoisen ryhmien yksityisyystilan kanssa.
Varmista Inbox-näkymässä, että molemmat testiviestit saapuivat, ja tutki niiden lähettäjätunnukset ja keskustelutyypit. Ryhmätestissä pitää näkyä oma omistajatunnuksesi sekä group tai supergroup. Kummankaan testin ei pitäisi aiheuttaa yhtäkään Todoist-pyyntöä. Kokeile myös omistajaksi tekeytyvää viestiä; teksti ei saa ohittaa lähettäjän metatietoja. Puuttuva viesti on toimitusongelma, ei läpäisty pääsytesti.
Käsittele osittain tallentunut kokonaisuus
Kolmen tehtävän luonti tarkoittaa kolmea erillistä pyyntöä. Jos toinen epäonnistuu, ensimmäinen tehtävä voi jo olla olemassa. Pysähdy, tutki projekti ja palautetut tunnisteet ja päätä sitten, mitkä kohdat pitää vielä luoda.
Palautumisesimerkki: säilytä varmistettu tehtävä, tutki epävarma kirjoitus ja jätä viimeinen tehtävä rauhaan, kunnes tulos on selvä.
Jos botti tallentaa ennen hyväksyntää, täsmennä luonti-Actionien kuvauksia ja toista sama keskustelu. Jos se arvaa päivän, vaadi tarkka päivämäärä luonnokseen. Jos se ilmoittaa onnistumisesta virheen jälkeen, tarkista uudelleenlukuohje. Paketti sisältää nämä tarkistukset, jotta voit kirjata omat tuloksesi ennen henkilökohtaisten tehtävien käyttöä.
Kun kolmen kohdan harjoitus toimii, käytä Pocket Inboxia lyhyisiin viesteihin, jotka muuten jäisivät Saved Messages -osioon: asiointiin, lähetettävään sähköpostiin tai luettavaan tekstiin. Pidä Todoist auki ensimmäisten kokonaisuuksien aikana ja vertaa tarkoitustasi tallennettuun tulokseen. Näin tarkistuksesta tulee tapa, johon voit luottaa omien havaintojesi perusteella.
Usein kysytyt kysymykset
Voiko Telegram-botti luoda Todoist-tehtäviä?
Kyllä. Todoistin APIin yhdistetty botti voi luoda tehtäviä Telegram-viesteistä. Tässä ohjeessa Quickchat AI jakaa viestin tehtäväehdotuksiksi, selvittää päivämäärät, pyytää hyväksynnän ja kutsuu Todoist API v1:tä. Tarkista syntyneet tietueet omassa Todoist-projektissasi.
Voivatko muut Telegram-käyttäjät nähdä Todoist-tehtäväni?
Käytä jokaisessa lukevassa ja kirjoittavassa Actionissa molempia palvelimella arvioitavia ehtoja: telegram_user_id vastaa vahvistettua numeerista tunnistettasi ja telegram_chat_type on private. Testaa toinen lähettäjä ja ryhmäkeskustelu ennen henkilökohtaisten tietojen käyttöä. Vain omistajan salliva prompt ei ole pääsynhallintaa.
Ymmärtääkö botti ilmaukset ensi perjantai tai ehkä maanantai?
Prompt ohjaa sitä selvittämään epävarmat päivät ja näyttämään tarkan päivämäärän muodossa YYYY-MM-DD ennen tallennusta. Anna aikavyöhykkeesi ja vahvista lopulliset päivät. Päivämäärätön tehtävä käyttää erillistä Actionia, joka jättää kaikki eräpäiväkentät pois.
Estääkö tämä päällekkäiset Todoist-tehtävät?
Ei. Olemassa olevien tehtävien lukeminen ja palautettujen tunnisteiden tarkistus auttavat havaitsemaan kaksoiskappaleita, mutta ohje ei toteuta atomista eräoperaatiota eikä takaa kaksoiskappaleiden estoa. Jos pyyntö aikakatkaistaan, tarkista Todoist ennen uutta yritystä: tehtävä on saattanut jo tallentua.
Tarvitsenko koodia tai Todoist-MCP-palvelimen?
Määrität Quickchat AIhin neljä HTTP Actionia ja Main Promptin. Sinun ei tarvitse käyttää Todoist-MCP-palvelinta. Tarvitset Telegram-botin, Todoist-API-tunnuksen ja Quickchat AI -tilauksen, jossa on riittävästi Action-kapasiteettia ja krediittejä testaukseen ja keskusteluihin.
Voiko botti käsitellä ääniviestejä tai lähettää muistutuksia?
Tämä ensimmäinen versio vastaanottaa tekstiä ja luo tehtäviä päivämäärällä tai ilman. Se ei litteroi ääniviestejä, ajasta muistutusviestejä, merkitse tehtäviä valmiiksi eikä yhdistä muiden Todoist-tilejä. Nämä ominaisuudet vaativat erilliset määritykset ja testit.