Telegram бот за Todoist може да превърне свободно написаните намерения в съобщението ви в списък със задачи за преглед. Ще създадете Pocket Inbox, личен бот, който отделя задачите, пита за неясните дати и записва списъка в един проект в Todoist след вашето одобрение.
Започнете със съобщение, което бихте изпратили на излизане от офиса:
Да купя хартия за принтера в петък, да пиша на мястото за събитието може би в понеделник и да прочета пътеводителя за маршрута, когато имам време.
Списъкът, който ще създадете: три задачи, две дати и една задача, умишлено оставена без дата. Тези истински екранни снимки на Todoist използват ръчно подготвени демонстрационни задачи; екранните снимки на Quickchat AI показват локална конфигурация. Стъпка 6 проверява резултатите от вашия работещ бот.
Важното е „може би в понеделник“. Това трябва да се уточни, преди да се зададе краен срок. „Когато имам време“ трябва да остане без дата. Тъкмо този кратък преглед прави разговора полезен: първо улавяте мисълта, после уточнявате подробностите, без да пренаписвате съобщението.
В шест стъпки ще подготвите акаунтите, ограничите достъпа, свържете Todoist, настроите прегледа, одобрите три задачи и проверите резултата. Началният комплект Pocket Inbox включва настройките на четирите Actions, промпта и списък с тестове. Това са файлове за копиране, а не автоматичен импорт на AI Agent.
1. Какво ви трябва, за да свържете Telegram с Todoist?
Трябват ви Telegram бот под ваш контрол, акаунт в Todoist и AI Agent в Quickchat AI с капацитет за четири HTTP Actions. Ограничете първата версия до един човек, един проект и текстови съобщения.
- Влезте в Todoist и създайте проект Capture demo. Ако е възможно, използвайте отделен тестов акаунт. Личният API токен има правата на акаунта; фиксираният идентификатор на проект в настройките не ограничава самия токен.
Първо дайте име на проекта, после отворете празния му списък със задачи. Това е местоназначението, което ще изберете във всяка Action за създаване.
- Създайте акаунт в Quickchat AI и изберете Add new AI Agent → Set up manually. Наречете агента Pocket Inbox. Проверете актуалните планове и лимити за Actions; AI отговорите и Simulation Testing използват кредити.
- Създайте бот чрез BotFather. Ръководството за създаване на Telegram бот обяснява потребителското име и токена. Въведете токена директно в External Apps → Telegram → Your own bot → Connect to Telegram, след което включете и запазете интеграцията.
- В Your Website → Install → Availability and access изключете Widget & Embed access и задайте Chat Page Access на Nobody. За това ръководство използвайте личния разговор в Telegram.
- Отворете бота в Telegram, натиснете Start и изпратете кратък поздрав. Оставете Actions за Todoist неактивни, докато не зададете правилата за достъп по-долу.
Дайте на Pocket Inbox собствена самоличност в Telegram. Този локален екран за настройка не съдържа действащ токен на бот.
Вече имате място за записване на мисли. Преди да свържете задачите, определете кой изпращач в Telegram има право на достъп до тях.
2. Как да запазите бота за Todoist личен?
Изисквайте вашия потребителски идентификатор в Telegram и личен чат при всяко четене и записване. Quickchat AI оценява тези условия, преди да изпрати HTTP заявката.
- В Inbox отворете истинския разговор в Telegram с вашия поздрав. Изберете Details → Visitor. Копирайте числовата стойност до Telegram User Id и проверете дали Telegram Chat Type е
private. - За всяка Action, която създадете в следващата стъпка, задайте When to run на AI decides.
- В Run only when добавете и двете условия по-долу. Използвайте идентификатора от този разговор, а не потребителско име или идентификатор, написан в съобщение.
| Ключ на метаданните | Сравнение | Стойност |
|---|---|---|
telegram_user_id | equals | Вашият потвърден числов потребителски идентификатор в Telegram |
telegram_chat_type | equals | private |
И двете условия трябва да са изпълнени. Числовият идентификатор в тази локална демонстрация е примерен; заменете го с вашата потвърдена стойност.
Telegram предоставя самоличността. Разговорът предоставя предложената задача. Това са различни входни данни.
Условията са описани в документацията за Run only when. Сам по себе си личният чат не е достатъчен, защото и друг човек може да започне личен разговор с бота. Не е достатъчен и промпт, който допуска само собственика. Задайте и двете проверки толкова внимателно за четящите Actions, колкото за създаващите.
Обикновеният уеб преглед няма потвърдени метаданни от Telegram, затова тези Actions трябва да откажат изпълнение там. Запазете условията и направете финалния тест в истинския канал.
3. Как да свържете бота с API на Todoist?
Създайте четири HTTP Actions: прочитане на активните задачи в проекта, създаване на задача с дата, създаване на задача без дата и повторно прочитане на запазена задача. Отделните Actions за създаване превръщат без дата в изричен избор.
Заявката използва същите полета, които виждате при добавяне на задача в Todoist: заглавие, целеви проект и незадължителна дата.
По-близък поглед към полетата на задачата. Настройките на API по-долу подават заглавието като content, проекта като project_id и одобрената дата като due_date. Вариантът без дата пропуска датата.
Подгответе токена и идентификатора на проекта
- В уеб приложението на Todoist отворете avatar → Settings → Integrations → Developer → Copy API token, както е описано в официалното ръководство за токена.
- В Quickchat AI изберете Actions & MCPs → Add Action → API Action → Create manually. За всяка настройка поставете токена директно в Headers → Authorization като
Bearer YOUR_TODOIST_TOKEN. Имайте предвид, че хората с права да редактират AI Agent могат да виждат фиксираните хедъри. Не поставяйте токена в промпт, чат или екранна снимка. - За да получите идентификатора на проекта, създайте временна неактивна Action с
GET https://api.todoist.com/api/v1/projects, хедър Authorization иAccept: application/json. Използвайте Test в редактора, прегледайтеresultsи копирайтеidдо Capture demo. Ако е нужно, подайте върнатияnext_cursorкато стойност на параметъраcursorв следващата заявка. След това изтрийте помощната Action. - Поставете върнатия от сървъра идентификатор навсякъде вместо
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.
Копирайте Action 1 от 4: Read capture tasks
API Action Name: Read capture tasks
What to ask the user first:
| Формат | Име | Описание | Задължително |
|---|---|---|---|
| Text | cursor | Пропуснете на първата страница. За следващите копирайте 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:
| Формат | Име | Описание | Задължително |
|---|---|---|---|
| Text | content | Точното заглавие на задачата от окончателния списък, одобрен от потребителя. | Да |
| Text | due_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:
| Формат | Име | Описание | Задължително |
|---|---|---|---|
| Text | content | Точното заглавие на задачата, одобрена без дата. | Да |
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:
| Формат | Име | Описание | Задължително |
|---|---|---|---|
| Text | task_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 неактивни, докато попълвате стойностите и проверявате условията.
4. Какви инструкции трябва да следва ботът за задачи?
Кажете на Pocket Inbox първо да състави чернова, да изясни неяснотите и да поиска одобрението ви за окончателните полета. Поставете следния текст в Identity → Main Prompt → Edit.
Промптът определя прегледа. Условията на 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.
Това са фиксирани примерни дати, а не значението на „този петък“, когато четете текста. Заменете ги с датите за своя тест.
Изяснете несигурността, преди да създадете задачите. Тук са показани примерните входни данни и предвидените окончателни полета.
Сравнете окончателната чернова на бота с таблицата:
| Задача | Потвърдена дата | Проект |
|---|---|---|
| Да купя хартия за принтера | 2026-11-20 | Capture demo |
| Да пиша на мястото за събитието | 2026-11-23 | Capture demo |
| Да прочета пътеводителя за маршрута | Без дата | Capture demo |
Коригирайте разликите и прегледайте обновения списък. След това изпратете:
Looks good, save all three.
Одобряването е поведение, управлявано от промпта, затова го проверете, а не го приемайте за гарантирано. В Inbox прегледайте картите на Actions в разговора и View logs. Трябва да видите прочитане на проекта, последвано от отделни създавания и прочитания на върнатите идентификатори.
6. Как да проверите дали задачите наистина са записани?
Отворете Capture demo в Todoist и сравнете трите записа с одобрената чернова. Само любезното „готово“ не е потвърждение.
Проследете датата в двете приложения: due_date в Action на Quickchat AI съответства на Date в Todoist. Увеличената странична лента е от ръчно подготвената задача за хартия за принтера. Отворете Date в собствената си задача, за да проверите точната календарна дата.
- Проверете двете точни дати и липсата на дата за задачата с пътеводителя.
- Сравнете
idот всеки отговор за създаване с последващия отговор за четене. Проверете далиcontent,project_idиdueсъвпадат с одобрената задача. Оставете всяко несъответствие нерешено, докато не го проучите. - Попитайте „Какво има в Capture demo в момента?“ и проверете дали ботът отново извлича активните задачи. Когато завършите задача в Todoist, тя изчезва от активния списък.
- Изпратете одобрението повторно. Проверете дали не са създадени още три задачи. Ботът трябва да провери предишните резултати и да изясни дали наистина искате нови копия.
Проверката означава повторно прочитане на същия запис и сравняване на полетата му. Диаграмата показва какво да сравните, а не реално получен отговор от 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. Тези възможности изискват отделна настройка и тестване.