От Telegram към Todoist: превърнете потока от мисли в проверени задачи

Piotr Grudzień
Публикувано 11 мин четене
Action за задачи в Quickchat AI до проект в Todoist с три примерни задачи

Telegram бот за Todoist може да превърне свободно написаните намерения в съобщението ви в списък със задачи за преглед. Ще създадете Pocket Inbox, личен бот, който отделя задачите, пита за неясните дати и записва списъка в един проект в Todoist след вашето одобрение.

Започнете със съобщение, което бихте изпратили на излизане от офиса:

Да купя хартия за принтера в петък, да пиша на мястото за събитието може би в понеделник и да прочета пътеводителя за маршрута, когато имам време.

Проектът Capture demo в Todoist със задачите Buy printer paper за петък, Email the venue за понеделник и Read the trail guide без дата Списъкът, който ще създадете: три задачи, две дати и една задача, умишлено оставена без дата. Тези истински екранни снимки на Todoist използват ръчно подготвени демонстрационни задачи; екранните снимки на Quickchat AI показват локална конфигурация. Стъпка 6 проверява резултатите от вашия работещ бот.

Важното е „може би в понеделник“. Това трябва да се уточни, преди да се зададе краен срок. „Когато имам време“ трябва да остане без дата. Тъкмо този кратък преглед прави разговора полезен: първо улавяте мисълта, после уточнявате подробностите, без да пренаписвате съобщението.

В шест стъпки ще подготвите акаунтите, ограничите достъпа, свържете Todoist, настроите прегледа, одобрите три задачи и проверите резултата. Началният комплект Pocket Inbox включва настройките на четирите Actions, промпта и списък с тестове. Това са файлове за копиране, а не автоматичен импорт на AI Agent.

1. Какво ви трябва, за да свържете Telegram с Todoist?

Трябват ви Telegram бот под ваш контрол, акаунт в Todoist и AI Agent в Quickchat AI с капацитет за четири HTTP Actions. Ограничете първата версия до един човек, един проект и текстови съобщения.

  1. Влезте в Todoist и създайте проект Capture demo. Ако е възможно, използвайте отделен тестов акаунт. Личният API токен има правата на акаунта; фиксираният идентификатор на проект в настройките не ограничава самия токен.

Диалогът Add project в Todoist с въведено Capture demo, последван от празния проект Capture demo Първо дайте име на проекта, после отворете празния му списък със задачи. Това е местоназначението, което ще изберете във всяка Action за създаване.

  1. Създайте акаунт в Quickchat AI и изберете Add new AI Agent → Set up manually. Наречете агента Pocket Inbox. Проверете актуалните планове и лимити за Actions; AI отговорите и Simulation Testing използват кредити.
  2. Създайте бот чрез BotFather. Ръководството за създаване на Telegram бот обяснява потребителското име и токена. Въведете токена директно в External Apps → Telegram → Your own bot → Connect to Telegram, след което включете и запазете интеграцията.
  3. В Your Website → Install → Availability and access изключете Widget & Embed access и задайте Chat Page Access на Nobody. За това ръководство използвайте личния разговор в Telegram.
  4. Отворете бота в Telegram, натиснете Start и изпратете кратък поздрав. Оставете Actions за Todoist неактивни, докато не зададете правилата за достъп по-долу.

Настройки на Telegram в Quickchat AI с опцията за свързване Your own bot Дайте на Pocket Inbox собствена самоличност в Telegram. Този локален екран за настройка не съдържа действащ токен на бот.

Вече имате място за записване на мисли. Преди да свържете задачите, определете кой изпращач в Telegram има право на достъп до тях.

2. Как да запазите бота за Todoist личен?

Изисквайте вашия потребителски идентификатор в Telegram и личен чат при всяко четене и записване. Quickchat AI оценява тези условия, преди да изпрати HTTP заявката.

  1. В Inbox отворете истинския разговор в Telegram с вашия поздрав. Изберете Details → Visitor. Копирайте числовата стойност до Telegram User Id и проверете дали Telegram Chat Type е private.
  2. За всяка Action, която създадете в следващата стъпка, задайте When to run на AI decides.
  3. В Run only when добавете и двете условия по-долу. Използвайте идентификатора от този разговор, а не потребителско име или идентификатор, написан в съобщение.
Ключ на метаданнитеСравнениеСтойност
telegram_user_idequalsВашият потвърден числов потребителски идентификатор в Telegram
telegram_chat_typeequalsprivate

Редакторът на Action с две задължителни условия: потребителски идентификатор в Telegram и личен чат И двете условия трябва да са изпълнени. Числовият идентификатор в тази локална демонстрация е примерен; заменете го с вашата потвърдена стойност.

Диаграма на проверката за собственик и личен чат преди заявка към Todoist Telegram предоставя самоличността. Разговорът предоставя предложената задача. Това са различни входни данни.

Условията са описани в документацията за Run only when. Сам по себе си личният чат не е достатъчен, защото и друг човек може да започне личен разговор с бота. Не е достатъчен и промпт, който допуска само собственика. Задайте и двете проверки толкова внимателно за четящите Actions, колкото за създаващите.

Обикновеният уеб преглед няма потвърдени метаданни от Telegram, затова тези Actions трябва да откажат изпълнение там. Запазете условията и направете финалния тест в истинския канал.

3. Как да свържете бота с API на Todoist?

Създайте четири HTTP Actions: прочитане на активните задачи в проекта, създаване на задача с дата, създаване на задача без дата и повторно прочитане на запазена задача. Отделните Actions за създаване превръщат без дата в изричен избор.

Заявката използва същите полета, които виждате при добавяне на задача в Todoist: заглавие, целеви проект и незадължителна дата.

Формулярът за въвеждане на задача в Todoist с Buy printer paper, избора на проект Capture demo и контролата Date, заедно с увеличен изглед на тези полета По-близък поглед към полетата на задачата. Настройките на API по-долу подават заглавието като content, проекта като project_id и одобрената дата като due_date. Вариантът без дата пропуска датата.

Подгответе токена и идентификатора на проекта

  1. В уеб приложението на Todoist отворете avatar → Settings → Integrations → Developer → Copy API token, както е описано в официалното ръководство за токена.
  2. В Quickchat AI изберете Actions & MCPs → Add Action → API Action → Create manually. За всяка настройка поставете токена директно в Headers → Authorization като Bearer YOUR_TODOIST_TOKEN. Имайте предвид, че хората с права да редактират AI Agent могат да виждат фиксираните хедъри. Не поставяйте токена в промпт, чат или екранна снимка.
  3. За да получите идентификатора на проекта, създайте временна неактивна Action с GET https://api.todoist.com/api/v1/projects, хедър Authorization и Accept: application/json. Използвайте Test в редактора, прегледайте results и копирайте id до Capture demo. Ако е нужно, подайте върнатия next_cursor като стойност на параметъра cursor в следващата заявка. След това изтрийте помощната Action.
  4. Поставете върнатия от сървъра идентификатор навсякъде вместо YOUR_PROJECT_ID. Той трябва да е фиксиран, а не попълван от AI. Идентификатор, започващ с tmp-, още не е синхронизиран и не може да се използва тук.

Тези крайни точки са описани в актуалната документация на API на Todoist. Използвайте /api/v1, включително списъчните отговори със странициране, вместо да копирате по-старо ръководство за REST-v2.

Настройте четирите Actions

Редакторът е обяснен в ръководството за API Action builder. Добавете входните данни в What to ask the user first. Използвайте Add AI Data, за да поставите етикетите на параметрите в URL адреса, реда за заявка или тялото; записът {{...}} по-долу обозначава тези етикети.

За всичките четири Actions добавете Accept: application/json, оставете и двете условия за собственик и запазете Response Filter празен, за да останат видими идентификаторите на задачите и страницирането. За двете POST Actions добавете и Content-Type: application/json.

Action за задача с дата с параметри content и due_date и фиксиран идентификатор на проект в JSON тялото Заглавието и датата идват от одобрения проект на списъка. Целевият проект остава фиксиран в Action.

Копирайте Action 1 от 4: Read capture tasks

API Action Name: Read capture tasks

What to ask the user first:

ФорматИмеОписаниеЗадължително
TextcursorПропуснете на първата страница. За следващите копирайте next_cursor от предишния резултат.Не

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

Оставете празна стойността по подразбиране на незадължителния вход cursor и попълнете целия ред за стойност на параметъра на заявката с неговия етикет. Не го добавяйте към URL адреса на крайната точка.

Body: празно.

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.
Копирайте Action 2 от 4: Create dated capture task

API Action Name: Create dated capture task

What to ask the user first:

ФорматИмеОписаниеЗадължително
TextcontentТочното заглавие на задачата от окончателния списък, одобрен от потребителя.Да
Textdue_dateТочната одобрена дата във формат YYYY-MM-DD, без час.Да

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

Раздел Body, режим 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.
Копирайте Action 3 от 4: Create undated capture task

API Action Name: Create undated capture task

What to ask the user first:

ФорматИмеОписаниеЗадължително
TextcontentТочното заглавие на задачата, одобрена без дата.Да

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

Раздел Body, режим 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.
Копирайте Action 4 от 4: Read a saved capture task

API Action Name: Read a saved capture task

What to ask the user first:

ФорматИмеОписаниеЗадължително
Texttask_idИдентификатор на задача, върнат от сървъра при създаване или в списъка на избрания проект. Никога не го отгатвайте.Да

API Endpoint and Headers:

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

Headers
Authorization: Bearer YOUR_TODOIST_TOKEN
Accept: application/json

Body: празно.

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.

Крайната точка за отделна задача сама по себе си не е ограничена до проект. Правилото за входните данни задържа този личен процес върху върнатите идентификатори, а условията за доверен изпращач контролират достъпа. Ако трябва да изолирате и самите идентификационни данни от други проекти, използвайте отделен акаунт в Todoist.

Четирите Actions на Pocket Inbox в Quickchat AI, които отделят четенето и създаването на задачи с дата и без дата Пълният набор от инструменти. Оставете Actions неактивни, докато попълвате стойностите и проверявате условията.

4. Какви инструкции трябва да следва ботът за задачи?

Кажете на Pocket Inbox първо да състави чернова, да изясни неяснотите и да поиска одобрението ви за окончателните полета. Поставете следния текст в Identity → Main Prompt → Edit.

Main Prompt на Pocket Inbox в настройките Identity на Quickchat AI Промптът определя прегледа. Условията на Actions определят кой може да има достъп до Todoist.

Копирайте целия 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.

Можете да подготвите поддържаните настройки и чрез връзката за управление на акаунта в Quickchat AI в ChatGPT или Claude. Дайте на свързания асистент комплекта и тази заявка:

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.

Тази връзка управлява настройките на Quickchat AI. Все още трябва да създадете Telegram бота, да въведете директно идентификационните данни и да тествате реалната връзка от Telegram към Todoist.

5. Как потокът от мисли се превръща в три одобрени задачи?

Изпробвайте разговора с първоначалното съобщение, преди да разрешите записването. След като и четирите Actions имат правилните идентификационни данни, проект и условия, включете ги и изпратете съобщението в личния чат в Telegram.

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

Ботът трябва да предложи три задачи и да попита за датите. Все още не бива да се изпълнява Action за създаване. За повторяем пример отговорете с точни дати:

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

Това са фиксирани примерни дати, а не значението на „този петък“, когато четете текста. Заменете ги с датите за своя тест.

Диаграма за уточняване на датите: петък е 20 ноември, колебливият понеделник е 23 ноември, а свободното време остава без дата Изяснете несигурността, преди да създадете задачите. Тук са показани примерните входни данни и предвидените окончателни полета.

Сравнете окончателната чернова на бота с таблицата:

ЗадачаПотвърдена датаПроект
Да купя хартия за принтера2026-11-20Capture demo
Да пиша на мястото за събитието2026-11-23Capture demo
Да прочета пътеводителя за маршрутаБез датаCapture demo

Коригирайте разликите и прегледайте обновения списък. След това изпратете:

Looks good, save all three.

Одобряването е поведение, управлявано от промпта, затова го проверете, а не го приемайте за гарантирано. В Inbox прегледайте картите на Actions в разговора и View logs. Трябва да видите прочитане на проекта, последвано от отделни създавания и прочитания на върнатите идентификатори.

6. Как да проверите дали задачите наистина са записани?

Отворете Capture demo в Todoist и сравнете трите записа с одобрената чернова. Само любезното „готово“ не е потвърждение.

Входът due_date в Quickchat AI до задачата Buy printer paper в Todoist и увеличен изглед на полетата ѝ Project и Date със стойност петък Проследете датата в двете приложения: due_date в Action на Quickchat AI съответства на Date в Todoist. Увеличената странична лента е от ръчно подготвената задача за хартия за принтера. Отворете Date в собствената си задача, за да проверите точната календарна дата.

  1. Проверете двете точни дати и липсата на дата за задачата с пътеводителя.
  2. Сравнете id от всеки отговор за създаване с последващия отговор за четене. Проверете дали content, project_id и due съвпадат с одобрената задача. Оставете всяко несъответствие нерешено, докато не го проучите.
  3. Попитайте „Какво има в Capture demo в момента?“ и проверете дали ботът отново извлича активните задачи. Когато завършите задача в Todoist, тя изчезва от активния списък.
  4. Изпратете одобрението повторно. Проверете дали не са създадени още три задачи. Ботът трябва да провери предишните резултати и да изясни дали наистина искате нови копия.

Диаграма на проверката, сравняваща одобрената задача, създадения идентификатор и последващо четене на същия идентификатор Проверката означава повторно прочитане на същия запис и сравняване на полетата му. Диаграмата показва какво да сравните, а не реално получен отговор от API.

Тествайте двете граници на достъпа

От друг акаунт в Telegram под ваш контрол изпратете „Покажи задачите ми.“ За теста в група добавете същия бот към тестова група, изпратете /start@YOUR_BOT_USERNAME и отговорете на поздрава му с искане за създаване на задача. Така тестът работи с включения по подразбиране режим за поверителност на групите в Telegram.

В Inbox потвърдете, че и двете тестови съобщения са пристигнали, и проверете идентификаторите на изпращачите и типовете чат. Тестът в група трябва да показва вашия идентификатор на собственик и group или supergroup. И двата теста трябва да завършат без заявка към Todoist. Изпробвайте и съобщение, в което твърдите, че сте собственикът; текстът не трябва да замества метаданните на изпращача. Липсващото съобщение е проблем с доставянето, а не успешен тест за достъп.

Обработете частично записан списък

Създаването на три задачи означава три отделни заявки. Ако втората се провали, първата задача вече може да съществува. Спрете, проверете проекта и върнатите идентификатори, после решете кои задачи остават за създаване.

Пример за частично записване: хартията е проверена, имейлът е с неясен резултат, а пътеводителят още не е опитан Пример за възстановяване: запазете проверената задача, проучете неясния запис и оставете останалата задача да чака, докато резултатът се изясни.

Ако ботът записва преди одобрение, уточнете описанията на създаващите Actions и повторете същия разговор. Ако отгатва дата, изисквайте точна дата в черновата. Ако съобщава успех след грешка, прецизирайте инструкцията за повторно четене. Комплектът включва тези проверки, за да запишете собствените си резултати, преди да използвате лични задачи.

Щом упражнението с три задачи заработи, използвайте Pocket Inbox за кратките съобщения, които иначе остават в Saved Messages: покупка, имейл или четиво. При първите списъци оставете Todoist отворен и сравнявайте намерението със записания резултат. Така прегледът става навик, основан на наблюдение.

Често задавани въпроси

Може ли Telegram бот да създава задачи в Todoist?

Да. Бот, свързан с API на Todoist, може да създава задачи от съобщения в Telegram. Този процес използва Quickchat AI, за да раздели съобщението на предложени задачи, да уточни датите, да поиска одобрение и да извика Todoist API v1. Проверете получените записи в собствения си проект в Todoist.

Могат ли други потребители на Telegram да виждат задачите ми в Todoist?

Приложете и двете сървърни условия към всяка Action за четене и записване: telegram_user_id трябва да съвпада с вашия потвърден числов идентификатор, а telegram_chat_type трябва да е private. Преди да използвате лични данни, тествайте друг изпращач и групов разговор. Промпт, който допуска само собственика, не осигурява контрол на достъпа.

Разбира ли ботът следващия петък или може би понеделник?

Промптът изисква уточняване на неясните дати и показване на точната дата YYYY-MM-DD преди записване. Посочете часовата зона и потвърдете окончателните дати. Задачата без дата използва отделна Action, която изцяло пропуска полетата за срок.

Предотвратява ли това дублирани задачи в Todoist?

Не. Прочитането на съществуващите задачи и проверката на върнатите идентификатори помагат за откриване на дубликати, но това не е атомарна групова операция или гарантирано премахване на дубликатите. След изтичане на времето за заявка първо проверете Todoist; задачата може вече да е записана.

Нужни ли са код или MCP сървър за Todoist?

Ще настроите четири HTTP Actions и Main Prompt в Quickchat AI. Не е нужно да поддържате MCP сървър за Todoist. Нужни са Telegram бот, API токен за Todoist и план в Quickchat AI с достатъчно капацитет за Actions и кредити за тестове и разговори.

Може ли да обработва гласови съобщения или да изпраща напомняния?

Тази първа версия приема текст и създава задачи с дата или без дата. Тя не транскрибира гласови съобщения, не планира напомняния, не завършва задачи и не свързва чужди акаунти в Todoist. Тези възможности изискват отделна настройка и тестване.

Quickchat AI Quickchat AI Ask Quickchat AI a question