Напоминания клиентам в Telegram-боте: 8 шагов до автосообщения перед визитом

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

Постоянная переписка о свободных местах отнимала часы каждый день.

У меня расписание состоит из повторяющихся групповых занятий и отдельных тренировок. Я веду запись, тренеры проводят занятия, а свободные места появляются в последний момент из-за переносов и отмен. Если группа заполнена, клиент попадает в лист ожидания по времени заявки. Когда кто-то отменяет визит, первое место автоматически предлагается первому человеку в очереди.

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

В какой-то момент я собрала экран с занятиями и количеством мест. Запись закрывается, когда группа заполнена, а очередь поднимается сама после отмены. Я не стала внедрять большую CRM. Собрала рабочую вещь под порядок своей студии.

Именно тогда стало понятно, что к записи можно пристроить следующий слой. Таблица уже знает дату и время занятия, Telegram умеет отправлять сообщение, а помощник может связать эти части словами, а не длинной разработкой.

Что изменилось в записи клиентов после напоминаний?

Главное изменение начинается ещё до сообщения. Я вижу, сколько мест осталось в группе. Если свободных мест нет, новая запись не проваливается в переписку, а уходит в очередь. Каждый человек получает место по времени заявки, а не потому, что я первой заметила его сообщение.

Когда появляется отмена, система поднимает первого клиента в листе ожидания. Это и есть честная очередь. Она не зависит от того, кто написал громче, напомнил о себе или оказался у меня перед глазами в нужный момент.

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

Я держу текст сервисным:

Напоминание о занятии завтра в 15:00. Ждём тебя в группе.

В нём нет скидки, предложения другой услуги или просьбы записаться ещё раз. Это сообщение только о действующей записи. Если клиент не запускал бота, сообщение не уйдёт. Такой порядок нельзя обойти одним номером телефона.

Почему свою систему нельзя сравнивать с готовым сервисом?

Мне не нужно по очереди писать десяти людям, что появилось место. Очередь сама поднимается, а первое место предлагается первому человеку в списке. Это не означает, что самостоятельная сборка лучше готового сервиса во всём. У неё нет поддержки, гарантированной доставки и человека, который будет следить за поломками.

Зато правило можно сформулировать своими словами. Например: «При отмене предложи место первому клиенту в очереди, а если он не подтвердил, переходи к следующему». Или: «Не отправляй напоминание по отменённой записи». Помощник изменит логику под это условие.

В готовом сервисе похожие настройки иногда есть. Но заранее надо проверить, как именно он понимает группу, перенос, отмену и очередь. Слово «ожидание» в тарифе ещё не означает, что место будет предложено в нужном порядке.

Свою систему я не стала перегружать. Мне нужны занятия, вместимость, записи, очередь и сообщения. Не понадобились отчёты, маркетинговые цепочки и десятки экранов. Каждая лишняя функция добавляет место для ошибки.

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

Из чего состоит напоминание клиенту о визите?

Если искать «боты напоминания telegram», схема выглядит сложнее, чем она есть. На деле здесь нет отдельного сервера. Таблица выступает рабочим списком, Apps Script запускается по таймеру, а Telegram получает обычный запрос.

У меня в таблице такие колонки:

Клиент | Дата визита | Время | chat_id | sent_24h | sent_1h

chat_id появляется после того, как клиент сам открывает бота и отправляет ему /start. Имя, телефон и @username не заменяют этот идентификатор для надёжной отправки личного сообщения.

Telegram передаёт сообщение через метод sendMessage. В запросе нужны chat_id и text:

{
  "chat_id": 123456789,
  "text": "Напоминание о визите завтра в 15:00"
}

Apps Script читает таблицу, сравнивает дату и время визита с текущим моментом и проверяет два окна: около 24 часов и около часа. Триггер не обещает отправку секунда в секунду, поэтому формулировка «примерно за час» честнее, чем точное обещание.

Что поставить перед сборкой бота?

VS Code можно воспринимать как папку с файлами и окном, где помощник работает с проектом. Самой писать код не требуется. Ты описываешь задачу словами, а помощник создаёт и меняет файлы.

Claude Code работает прямо внутри редактора. Он видит структуру проекта, задаёт вопросы и может объяснить ошибку. Если попросить «сделай напоминания клиентам», ответ получится слишком общим. Лучше сразу дать ему поля таблицы, правила отправки и ограничения.

Установка занимает около четверти часа: скачай VS Code, установи его, установи Claude Code, войди в аккаунт. На этом этапе я не стала разбираться в каждом окне. Поставила инструменты и вернулась к своей задаче.

Бот создаётся через официальный аккаунт @BotFather в Telegram. Отправь команду /newbot, задай имя и получи токен. Токен храни как пароль. Не вставляй его в открытую таблицу, скриншот или общий чат.

Подписка Claude Pro постоянная. Она не превращает Telegram и Google Apps Script в платные сервисы, но без неё Claude Code не входит в доступный набор инструментов. После лимита Pro могут появиться отдельные расходы по API.

Как настроить напоминания в Telegram по шагам?

1. Создай таблицу записи.

   Открой Google Таблицу и сделай первый лист с заголовками. Для фитнес-студии достаточно имени клиента, даты и времени занятия, chat_id и двух статусов.

   Структура таблицы для напоминанийСкопировать промпт

   Создай для фитнес-студии структуру Google Таблицы для записей на занятия. Нужны колонки: Клиент, Дата визита, Время, chat_id, sent_24h, sent_1h. Добавь отдельную колонку Статус записи со значениями активна, перенесена, отменена. Объясни простым языком, какой формат даты и времени использовать. Не добавляй рекламные поля и не выдумывай дополнительные данные. Подготовь пример одной активной записи на групповое занятие и покажи строку заголовков.

   Помощник должен вернуть понятную структуру и объяснить формат даты. В строке тестовой записи статусы оставь пустыми или поставь нет.

2. Создай бота через BotFather.

   В Telegram открой @BotFather, отправь /newbot, укажи имя и получи токен. Скопируй его временно в закрытую заметку, не в таблицу.

   Затем отправь боту /start со своего аккаунта. Без первого сообщения бот не сможет начать личный диалог. Для клиента действует то же правило: сначала открыть бота и написать ему.

3. Получи и сохрани `chat_id`.

   Попроси помощника добавить функцию, которая читает входящее обновление Telegram через getUpdates, находит message.chat.id и записывает его в таблицу. Для простой схемы не смешивай этот способ с webhook.

   Получить chat_id клиентаСкопировать промпт

   В проекте для фитнес-студии добавь функцию получения chat_id через Telegram getUpdates. Когда клиент отправляет боту /start, найди в обновлении значение message.chat.id и запиши его в таблицу рядом с именем клиента. Не записывай токен в исходный код и не меняй существующие данные записи. Объясни, как запустить проверку вручную и как понять, что chat_id записался в правильную строку. Если в таблице нельзя надёжно сопоставить клиента со строкой, сначала задай вопрос и предложи безопасный вариант.

   В ответе должна появиться инструкция проверки. Отправь /start сама, запусти функцию и убедись, что в таблице появился числовой идентификатор.

4. Отправь тестовое сообщение.

   Теперь проверь сам канал, не дожидаясь занятия. Помощник должен использовать метод sendMessage и взять токен из свойств проекта.

   Тестовое сообщение в TelegramСкопировать промпт

   Добавь в проект функцию тестовой отправки Telegram-сообщения. Она должна взять BOT_TOKEN из свойств проекта, использовать chat_id из тестовой строки Google Таблицы и вызвать метод sendMessage с коротким текстом: Напоминание о занятии. Это тест. Не отправляй сообщения всем строкам и не вставляй токен в код, таблицу или URL. После отправки запиши результат выполнения в журнал и объясни, где его посмотреть.

   Правильный результат простой: сообщение приходит в твой чат один раз, а токен не виден среди файлов. Если сообщение не пришло, не переходи дальше. Сначала исправь этот шаг.

5. Научи помощника читать строки.

   Попроси его брать только активные записи, у которых есть дата, время и chat_id. Отменённые и перенесённые строки нельзя считать готовыми к отправке.

   Читать активные записиСкопировать промпт

   Сделай функцию чтения Google Таблицы для напоминаний о занятиях. Обрабатывай только строки со статусом записи активна, заполненными датой и временем визита и непустым chat_id. Для каждой строки верни имя клиента, дату, время, chat_id, sent_24h и sent_1h. Не считай текстовое отображение даты надёжным: преобразуй дату и время в единое значение даты-времени с учётом часового пояса проекта. Покажи в журнале причину пропуска строки, если не хватает данных. Не отправляй сообщения на этом шаге.

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

6. Вычисли два момента отправки.

   Для каждой активной записи нужны момент визита минус 24 часа и момент визита минус 1 час. Добавь небольшое окно проверки, потому что триггер Apps Script может запускаться с небольшим смещением.

   Вычислить время двух напоминанийСкопировать промпт

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

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

7. Добавь триггер по таймеру.

   Apps Script должен запускать проверку примерно раз в минуту. Telegram сам не хранит отложенные сообщения, поэтому планировщик нужен в проекте.

   Добавить планировщик напоминанийСкопировать промпт

   Добавь установочную функцию для триггера Google Apps Script. Триггер должен запускать проверку напоминаний примерно раз в минуту. При каждом запуске проект читает активные строки, вычисляет моменты за 24 часа и за 1 час до занятия, отправляет только готовые сообщения и записывает результат. Не создавай второй такой триггер при повторном запуске установочной функции. Покажи, где в Apps Script посмотреть созданный триггер и историю запусков. Объясни, что время может немного смещаться и что это не отправка секунда в секунду.

   После создания открой список триггеров. Там должен быть один запуск для функции проверки. Поставь тестовую запись на ближайший безопасный момент и проверь отправку отдельно.

8. Записывай статусы отправки.

   После успешного ответа Telegram поставь да в sent_24h или sent_1h. При ошибке сохрани текст ошибки и не отмечай сообщение как отправленное.

   Статусы и безопасная отправкаСкопировать промпт

   Доработай отправку напоминаний для Google Таблицы и Telegram. Для каждого типа сообщения используй отдельный статус: sent_24h и sent_1h. Перед отправкой проверь, что статус ещё не да. После успешного ответа Telegram запиши да и время отправки. При ошибке сохрани код ошибки, текст и число попыток, но не ставь статус да. Для сетевого тайм-аута не делай бесконечные повторы: используй уникальный ключ записи и типа напоминания, например appointment_id плюс reminder_type, и объясни, как проверить спорную отправку вручную. Токен бери только из свойств проекта.

   В конце попроси помощника сохранить BOT_TOKEN, SPREADSHEET_ID и SHEET_NAME через getScriptProperties(). В открытом коде должны остаться только названия настроек, а не их значения.

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

Какие файлы появятся после сборки?

Обычно назначение частей выглядит так:

• настройки проекта: идентификатор таблицы, имя листа и имена свойств;
• чтение записей: поиск активных строк и проверка обязательных полей;
• Telegram: вызов sendMessage и подготовка текста;
• планировщик: запуск проверки по триггеру;
• статусы: отметки sent_24h, sent_1h, число попыток и ошибка;
• журнал: история запусков и неотправленных сообщений.

Текст напоминания меняется в части, где формируется text. Не ищи её глазами по всему проекту. Попроси помощника показать файл и конкретный участок, а затем проверь сообщение на тестовой записи.

Секреты лежат в свойствах проекта. В таблице остаётся chat_id, но токен бота туда переносить нельзя. Если токен уже попал в открытый код, перевыпусти его через @BotFather.

Что делать, если напоминание не приходит?

Неверный часовой пояс

Telegram не передаёт боту часовой пояс клиента. Если таблица и проект считают время по-разному, сообщение придёт слишком рано или поздно. Для небольшой студии проще заранее выбрать одну часовую зону бизнеса и использовать её во всех расчётах.

Напоминание о занятии приходит не в то время. Проверь часовой пояс Google Таблицы и проекта Apps Script, сравни его с часовым поясом фитнес-студии и покажи, какое время система использует для записи. Не меняй настройки молча. Сначала объясни причину простыми словами, затем предложи исправление и тестовую запись.

Нет chat_id

Телефон клиента в таблице не даёт боту адрес личного чата. Клиент должен открыть бота и отправить /start, после чего идентификатор надо сохранить рядом с его записью.

Для активной записи Анны напоминание не отправилось. Проверь, есть ли в её строке chat_id, приходил ли от этого клиента /start и записал ли проект значение message.chat.id. Не отправляй сообщение повторно, пока причина не найдена. Сформируй короткую инструкцию для клиента, как открыть бота и запустить его.

Дубль после тайм-аута

Иногда запрос дошёл до Telegram, но ответ не вернулся. Повторная отправка может создать два одинаковых сообщения. Поэтому после тайм-аута нельзя бесконечно нажимать «повторить».

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

Ошибка 429

429 означает, что Telegram ограничил частоту запросов. Отправляй сообщения последовательно, делай паузу и обрабатывай время ожидания из ответа. Для обычных напоминаний клиентам это не должно становиться постоянной проблемой.

При отправке напоминаний Telegram вернул ошибку 429. Найди в ответе время ожидания, добавь последовательную отправку с паузой и запиши ошибку в журнал. Не помечай неотправленные строки как отправленные. Покажи, как повторить проверку после паузы.

Остановился триггер

Проверь список триггеров и историю выполнений Apps Script. Если запусков нет, создай один триггер заново. Не создавай несколько одинаковых: они могут отправлять дубли.

Напоминания перестали отправляться, хотя активные строки и chat_id заполнены. Проверь наличие одного триггера для функции проверки, историю запусков, последнюю ошибку и квоты Apps Script. Не создавай второй триггер, пока не проверишь существующий. Составь последовательность исправления простым языком.

Токен в открытом коде

Токен даёт полный контроль над ботом. Если он попал в код, таблицу или журнал, его нельзя считать секретным. Перевыпусти токен через BotFather и перенеси новое значение в свойства проекта.

Проверь проект и найди места, где BOT_TOKEN может быть записан открытым текстом: исходники, таблица, URL, журнал и тестовые файлы. Не выводи сам токен в ответе. Перенеси секрет в свойства проекта Apps Script, очисти открытые значения и объясни, как перевыпустить токен через @BotFather, если он уже засветился.

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

Сколько стоит своя система против готового сервиса?

У самостоятельной схемы есть цена, которую таблица не показывает. Это собственное время, возможный хостинг, дополнительные интеграции и ИИ-токены после исчерпания лимита Claude. Их сумма зависит от того, что именно добавляется.

Claude Pro стоит $20 в месяц по официальному прайсу Anthropic. Около 1 480 ₽ при оплате через посредника, но это не официальный тариф Anthropic. Для сборки Claude Code входит в Pro отдельно оплачивать его не надо.

Готовый сервис выигрывает поддержкой и готовым интерфейсом. Своя схема выигрывает гибкостью и отсутствием обязательной подписки на сервис. Но она не даёт гарантированной доставки. Клиент также должен сначала написать боту.

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

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

С чего начать сегодня, если технологии не для тебя?

Не начинай со всей студии. Возьми одну группу и одну запись. Проверь сценарий вручную:

1. клиент запускает бота;
2. chat_id попадает в таблицу;
3. дата и время читаются правильно;
4. тестовое сообщение приходит;
5. после отправки меняется статус;
6. повторный запуск не создаёт дубль.

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

Если ошибка звучит непонятно, не пытайся угадывать по названию. Напиши помощнику: «Объясни, что произошло, какой строкой таблицы это вызвано и что проверить руками». Так технология остаётся инструментом, а не новой профессией.

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

Вопросы и ответы

Это собирательная история выпускников практикума, а не рассказ одного человека: так эта работа устроена в большинстве таких дел.