Из Telegram в Todoist: превратите поток мыслей в проверенные задачи

Piotr Grudzień
Опубликовано Время чтения: 10 мин
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-токен получает разрешения аккаунта; фиксированный ID проекта в настройках не ограничивает сам токен.

Окно 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?

Для каждого чтения и записи требуйте ваш ID пользователя 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 добавьте оба условия ниже. Подставьте ID из этого разговора, а не имя пользователя или ID из текста сообщения.
Ключ метаданныхСравнениеЗначение
telegram_user_idequalsВаш проверенный числовой ID пользователя Telegram
telegram_chat_typeequalsprivate

Редактор Action с двумя обязательными условиями: ID пользователя Telegram и личный чат Должны выполняться оба условия. Числовой ID в этом локальном примере условный; замените его своим проверенным значением.

Схема проверки владельца и личного чата перед запросом к Todoist Telegram передаёт сведения о личности. Разговор передаёт предлагаемую задачу. Это разные входные данные.

Документация Run only when объясняет эти условия. Одного личного чата недостаточно: другой человек тоже может открыть личный чат с ботом. Промпта «только владелец» также недостаточно. Проверяйте Actions для чтения так же тщательно, как Actions для создания.

В обычном веб-превью нет проверенных метаданных Telegram, поэтому эти Actions должны отказываться выполняться. Сохраните условия и проводите итоговую проверку в настоящем канале.

3. Как подключить бота к API Todoist?

Создайте четыре HTTP Actions: получение активных задач проекта, создание задачи с датой, создание задачи без даты и повторное чтение сохранённой задачи. Раздельные Actions делают вариант без даты явным выбором.

Запрос использует те же поля, которые вы видите при добавлении задачи в Todoist: название, целевой проект и необязательную дату.

Форма добавления задачи в Todoist с Buy printer paper, выбором проекта Capture demo и элементом Date, а также увеличенный вид этих полей Рассмотрим поля задачи поближе. Настройки API ниже передают название как content, проект как project_id, а одобренную дату как due_date. Вариант без даты не передаёт дату.

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

  1. В веб-приложении Todoist откройте аватар → 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. Чтобы найти ID проекта, создайте временный выключенный Action с GET https://api.todoist.com/api/v1/projects, заголовком Authorization и Accept: application/json. Используйте инструмент Test в редакторе, просмотрите results и скопируйте id возле Capture demo. При необходимости передайте полученный next_cursor как значение параметра cursor следующего запроса. Затем удалите временный Action.
  4. Вставьте полученный от сервера ID везде, где указано YOUR_PROJECT_ID. Он должен оставаться фиксированным, а не заполняться AI. ID вида 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 пустым, чтобы были видны ID задач и данные о страницах. Для обоих POST Actions также добавьте Content-Type: application/json.

Action создания задачи с датой: метки content и due_date и фиксированный ID проекта в теле 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_idID задачи, возвращённый сервером при создании или в списке выбранного проекта. Не угадывайте его.Да

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.

Эндпоинт отдельной задачи сам по себе не ограничен проектом. Правило входного параметра направляет этот личный процесс к возвращённым ID задач, а условия доверенного отправителя обеспечивают контроль доступа. Если нужно отделить сами учётные данные от других проектов, используйте отдельный аккаунт 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. Вы должны увидеть чтение проекта, затем отдельные создания и чтения возвращённых ID.

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. Отправьте одобрение повторно. Убедитесь, что ещё три задачи не появились. Бот должен проверить предыдущие результаты и уточнить, нужны ли новые копии.

Схема проверки: одобренная задача, ID созданной записи и последующее чтение этого же ID Проверка означает чтение той же сохранённой записи и сверку её полей. Схема показывает, что сравнивать, а не реальный ответ API.

Проверьте обе границы доступа

С другого подконтрольного аккаунта Telegram отправьте «Покажи мои задачи». Для проверки в группе добавьте того же бота в тестовую группу, отправьте /start@YOUR_BOT_USERNAME и ответьте на его приветствие просьбой создать задачу. Так проверка будет работать с включённым по умолчанию режимом приватности Telegram для групп.

В Inbox убедитесь, что оба тестовых сообщения пришли, и проверьте идентификаторы отправителей и типы чатов. Проверка в группе должна показывать ваш идентификатор владельца и group или supergroup. В обоих тестах запросов к Todoist быть не должно. Также попробуйте отправить сообщение от имени владельца; текст не должен подменять метаданные отправителя. Отсутствие сообщения означает проблему доставки, а не успешную проверку доступа.

Обработайте частично сохранённый список

Создание трёх задач состоит из трёх отдельных запросов. Если второй завершился ошибкой, первая задача уже может существовать. Остановитесь, проверьте проект и возвращённые ID, затем решите, какие задачи ещё нужно создать.

Пример частичного сохранения: бумага подтверждена, письмо площадке неясно, чтение путеводителя не запускалось Пример восстановления: сохраните проверенную задачу, выясните результат неопределённой записи и не трогайте оставшуюся задачу, пока исход не станет понятен.

Если бот сохраняет до одобрения, уточните описания Actions создания и повторите тот же разговор. Если он угадывает дату, требуйте точную дату в черновике. Если сообщает об успехе после ошибки, пересмотрите инструкцию повторного чтения. Набор включает эти проверки, чтобы вы записали собственные результаты до работы с личными задачами.

Когда упражнение с тремя задачами заработает, используйте Pocket Inbox для коротких заметок, которые иначе остались бы в Saved Messages: поручения, письма, материалы для чтения. Для первых списков держите Todoist открытым и сравнивайте намерения с сохранённым. Так привычка проверять опирается на наблюдаемый результат.

Часто задаваемые вопросы

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

Да. Бот, подключённый к API Todoist, может создавать задачи из сообщений Telegram. В этой настройке Quickchat AI разбирает сообщение на предлагаемые задачи, уточняет даты, запрашивает одобрение и вызывает Todoist API v1. Проверьте созданные записи в своём проекте Todoist.

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

Примените оба серверных условия ко всем Actions чтения и записи: telegram_user_id должен совпадать с вашим проверенным числовым ID, а telegram_chat_type должен быть равен private. До использования личных данных проверьте другого отправителя и разговор в группе. Промпт «только владелец» не обеспечивает контроль доступа.

Поймёт ли бот «следующая пятница» или «возможно, понедельник»?

Промпт требует уточнять неясные даты и показывать точную дату YYYY-MM-DD до сохранения. Укажите часовой пояс и подтвердите окончательные даты. Для задачи без даты используется отдельный Action, полностью исключающий поля срока.

Предотвращает ли это дубликаты задач Todoist?

Нет. Чтение существующих задач и проверка возвращённых ID помогают заметить дубликаты, но эта настройка не обеспечивает атомарную обработку списка или гарантированную дедупликацию. Если запрос завершился по тайм-ауту, проверьте 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