Артем Бородатюк

Збудуй мені Telegram-бота — персонального коуча по цілях, який щодня пушить власника і веде облік прогресу в Google Таблиці.

## Стек (не обговорюється)
- Cloudflare Worker, plain JS, деплой npx wrangler deploy. Ніяких залежностей, крім @anthropic-ai/sdk.
- База — Google Sheets через сервісний акаунт (JWT RS256 → oauth2.googleapis.com, скоуп spreadsheets).
- Мозок — Claude API (модель claude-opus-5, effort low) з tool use.
- Розклад — cron triggers воркера. Все крутиться в хмарі 24/7, нічого не залежить від ноутбука.

## Що я дам (спитай і постав секретами через wrangler secret put)
- TELEGRAM_BOT_TOKEN — токен від BotFather
- ANTHROPIC_API_KEY
- GOOGLE_SA_JSON — повний JSON сервісного акаунта (таблицю я розшарю на його email як Editor)
- WEBHOOK_SECRET — згенеруй сам (openssl rand -hex 24)
- vars: SHEET_ID, ALLOWED_CHAT_ID (бот працює ТІЛЬКИ з цим chat_id, чужих ігнорує мовчки)

## Таблиця цілей
Вкладка з річними цілями. Колонки: A горизонт | B пріоритет (10–100) | C тип (Pers/Work) | D текст цілі | E відповідальний | F відповідальний #2 | G статус | H — колонка бота (нотатки).
Статуси (дропдаун): not started, in progress, almost, done, cancelled, postponed to next year, postponed to far future. «Активні» для бота — перші три.
Шапку шукай динамічно (рядок, де A починається з відомого заголовка), щоб вставка рядків зверху нічого не ламала.

## Поведінка
1. Щодня о 16:00 бот бере ОДНУ активну ціль і питає, що по ній. Вибір: спершу цілі, яких бот ще не торкався, далі — найдавніше торкані (остання дата з нотаток у колонці H), при рівності — вищий пріоритет. Вчорашня відповідана ціль виключається.

2. Відповідь власника обробляє Claude з інструментами:
- save_progress(summary) — дописати в H «дд.мм.рр: суть» (3–15 слів). Викликати на БУДЬ-ЯКУ змістовну відповідь.
- set_status(status) — коли зі слів ясно: зробив → done, майже → almost, почав → in progress, скасував/переніс → відповідний статус.

3. О 22:00 — якщо на питання дня не відповів, колюче нагадування (ігнор — теж відповідь).

4. Субота 09:00 — тижневе саммері: кількість цілей по статусах окремо Pers/Work/разом, % done; зміни статусів за тиждень (порівняння зі знімком минулої суботи в KV); по яких цілях були записи. Якщо тиждень без руху — сказати прямо, що тиждень злитий.

5. Задачі-нагадування (окрема вкладка, створюється автоматично): власник пише «впиши задачу: X, відповідальний Y, нагадуй раз на місяць» → бот вносить рядок (дата створення, задача, відповідальний, періодичність словами, інтервал у днях, дата наступного нагадування, статус active/paused/done). Якщо періодичність не назвав — бот ОБОВ'ЯЗКОВО питає. Коли настає дата — нагадує, пише дату нагадування в наступну вільну колонку справа, а суть відповіді — в сусідню клітинку. Інструменти: add_task, set_task_frequency, answer_task, set_task_status.

6. Команди: /goal (питання зараз), /goals (зведення по статусах), /focus (топ-3 найпріоритетніші без руху), /week (саммері зараз), /tasks (список задач). Зареєструй через setMyCommands.

Менеджмент — це про системи, відповідальність і результат. Саме це ми й будуємо у FRACTAL і завдяки місії відкриваємо в публічному просторі.

Напевно, це перша українська бізнес-література, яка має таку кількість відгуків від підприємців та менеджерів такої рівня :)

За традицією — конкурс серед глядачів. Щоб узяти участь, напишіть у коментарях цілі за фреймворком SMART (або SMARTCBP) для вакансії, яку плануєте відкрити, чи для власної посади. Найкращий коментар обере Юлія — переможець отримає безплатний обід і персональну консультацію з рекрутингу.

Побудуй телеграм-бота на Cloudflare Workers, який із переписки робить подію в Google Calendar.

ЩО РОБИТЬ
1. Я пересилаю боту переписку. Якщо повідомлень кілька — зачекай 20 секунд
і збери їх в ОДИН матеріал, а не відповідай на кожне.
2. LLM зі строгою json-схемою витягує: імʼя співрозмовника, усі пошти (крім моїх),
місто, місце, дату й час (відносні дати рахуй від київського «зараз»), тривалість,
дату домовленості й канал, контекст на 2-3 речення і список того, чого бракує.
3. Місце уточни через Google Places Text Search: «назва + місто» → повна адреса.
Якщо збігів кілька — покажи альтернативи в картці.
4. Покажи картку: назва, час, адреса, пошти, контекст + кнопки «Створити» і «Скасувати».
5. Наступне повідомлення після картки — це ПРАВКА до неї: передай стару картку моделі
як контекст, онови тільки назване, решту збережи.
6. Після підтвердження створи подію:
- назва «Імʼя Прізвище + [моє імʼя]»
- календар шукай за назвою (напр. One time meetings), id закешуй
- учасники = всі знайдені пошти, sendUpdates=all
- guestsCanModify, guestsCanInviteOthers, guestsCanSeeOtherGuests = true
- таймзона Europe/Kyiv
- опис: тема (= назва), місто, час, місце, «Домовились: дата, канал»,
«Контекст перед зустріччю: …» і мої контакти з проханням писати, а не дзвонити
7. У відповідь дай посилання на створену подію.

ПРАВИЛА
- Нічого не вигадувати. Немає часу, пошти чи адреси — напиши, чого бракує.
Без часу кнопку «Створити» не показувати взагалі.
- Реагувати тільки на мій chat_id, чужі апдейти ігнорувати мовчки.

ТЕХНІЧНО
- Секрети: TELEGRAM_BOT_TOKEN, WEBHOOK_SECRET, GOOGLE_OAUTH_CLIENT_ID і SECRET,
GOOGLE_MAPS_KEY, ключ моделі.
- OAuth від того акаунта, від якого мають іти запрошення. Refresh-токен у KV, оновлювати самому.
- Вебхук /tg з перевіркою x-telegram-bot-api-secret-token, allowed_updates = message + callback_query.
- KV: буфер повідомлень, поточна картка, id календаря.
- parse_mode=HTML, екранувати & < >.

ЩО ВІДДАТИ
Код, wrangler.toml і кроки: створити бота, увімкнути Calendar API та Places API,
зробити OAuth-клієнт, задеплоїти воркер, поставити вебхук, перевірити на тестовій переписці.

Напишіть, якщо вам подобаються дописи, де я викладатиму промпти для готових ботів, яких ви зможете самостійно запустити у себе. Це заощадить вам час або дасть змогу робити те, що раніше здавалося неможливим (наприклад, створити бота, який читає подкасти та новини).

Коли я почав робити чатботів саме в Telegram, а не просто рутинні scheduled-таски в Cloud Code, я нарешті почав відчувати користь від AI.