Подключение Telegram-бота салона

1. Что вы получите

• Обращения клиентов из Telegram собираются в разделе «Чаты» кабинета.
• Переписка привязывается к карточке клиента — история не теряется между сотрудниками.
• В боте появляется кнопка «Записаться» — клиент выбирает услугу и время прямо в Telegram, запись падает в журнал.

2. Создайте бота в @BotFather

1. Откройте в Telegram @BotFather и отправьте команду /newbot.
2. Задайте имя бота (его увидит клиент, например «Салон Аляска») и адрес — он должен заканчиваться на bot, например alaska_salon_bot.
3. BotFather пришлёт токен — длинную строку вида «123456789:AAE…». Скопируйте её целиком.

3. Вставьте токен в кабинет

Откройте Настройки → Мессенджеры, нажмите «Подключить бота» и вставьте токен. Раздел доступен владельцу и администратору: токен бота открывает доступ ко всей переписке клиентов, поэтому это настройка уровня организации.

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

4. Что произойдёт само

После сохранения токена кабинет сам сообщает Telegram, куда присылать сообщения (вебхук), и сам ставит боту кнопку меню «Записаться». Никаких дополнительных команд в BotFather отправлять не нужно.

Команда /setdomain для мини-приложения записи не нужна. Она относится только к входу через Telegram на сайте (Login Widget). Совет «сделайте /setdomain, иначе мини-апп не заработает» широко тиражируется в блогах, но к кнопке записи отношения не имеет — выполнять его бессмысленно.

5. Пауза и отключение — это разные вещи

• Пауза — временная тишина: бот не принимает входящие, но токен и вся история остаются. Возврат в один клик, переподключать ничего не нужно.
• Отключение — удаление канала: переписки в «Чатах» стираются без возможности восстановить. Если нужно просто «чтобы бот замолчал» — ставьте паузу.

6. AI-режим: бот отвечает сам

Тумблер «AI-режим» на том же экране включает авто-ответ на входящие. Что важно понимать до включения:

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

7. Второй бот — для сотрудников

Кроме клиентского бота на том же экране подключается бот для сотрудников. Через него команда открывает рабочий кабинет прямо в Telegram: свой день, записи, смену. Боты именно разные, и это не прихоть: кнопка меню у Telegram-бота всего одна, поэтому на одном боте пришлось бы выбирать между записью клиента и кабинетом мастера.

• Создаётся так же, в @BotFather (шаг 2) — назовите его так, чтобы не путать с клиентским, например «Аляска для своих».
• Кнопка меню у него будет «Кабинет», а не «Записаться» — кабинет ставит её сам, как и клиентскому.
• Клиенты в него не пишут, а сообщения сотрудников не попадают в «Чаты» и не заводят лидов: это рабочий инструмент, а не канал обращений.

Что сотрудник видит внутри кабинета: «Мой день» (расписание на дату и отметка «Пришёл» / «Не пришёл»), «Клиенты» (поиск по имени или телефону, карточка со звонком в один тап и историей визитов), «Записать» (клиент → услуга → мастер → время), «Чаты» (переписки клиентов из мессенджеров и ответ прямо с телефона),«Смена и касса» (открыть смену, снять X-отчёт, сдать наличные и закрыть смену с пересчётом), «Сводка» (записи за день, неоплаченное, ближайшее) и «Ещё» — переход в полный веб-кабинет. Кабинет в Telegram намеренно узкий: это то, что делают между клиентами, стоя. Правки состава услуг, скидки, предоплата и отчёты остаются в вебе, где есть место под форму.

• Что человек увидит, определяет его роль — та же, что в веб-кабинете. Например, суммы и платежи клиента открыты руководителю, а рядовому мастеру — нет.
• Касса с телефона — намеренно неполная: открытие, X-отчёт, инкассация и закрытие смены. Приход, расход и переводы между кассами делаются в веб-кабинете, где видно статью операции и её легко исправить.
• Записи в «Моём дне» — только те, что назначены на этого сотрудника. Чтобы мастер видел записи, заведённые администратором, его учётная запись должна быть привязана к карточке сотрудника (карточка сотрудника → «Доступ и Telegram»).

Нажать «Старт» у этого бота может кто угодно — ссылка на бота публична. Кабинет откроется только тому, чей Telegram привязан к учётной записи; остальные получат отказ, а не чужие записи и деньги. Привязка делается на том же экране «Мессенджеры» кнопкой «Привязать мой Telegram» в чек-листе «Как открыть кабинет». Не путайте её с привязкой в карточке сотрудника: та отвечает за доставку уведомлений мастеру, а не за вход. Поэтому подключение бота и выдача доступа — два разных действия.

8. Кнопка «Открыть» у бота сотрудников — один раз в @BotFather

Кроме кнопки меню у бота бывает Main Mini App — та самая кнопка «Открыть», которая видна прямо в списке чатов, рядом с названием бота. Её кабинет поставить не может: у Telegram нет такой команды для программ, только @BotFather. Поэтому шаг ручной — но делается один раз для бота и больше к нему возвращаться не нужно.

• Откройте @BotFather → /mybots → выберите бота сотрудников.
• Bot Settings → Configure Mini App → Enable Mini App.
• Вставьте адрес, который кабинет показывает готовым: Настройки → Мессенджеры → чек-лист «Как открыть кабинет» → кнопка «Скопировать». Адрес у каждой организации свой — в нём зашит ваш бот, поэтому чужой не подойдёт.

Проверять «получилось ли» вручную не нужно: в чек-листе рядом с шагом есть кнопка «Проверить» — кабинет спрашивает Telegram и ставит галочку. Если он отвечает «не удалось спросить Telegram», это сбой связи, а не ваша настройка: повторите позже.

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

9. Если что-то пошло не так

• «Telegram пока некуда присылать сообщения» — на сервере не задан публичный адрес приёма. Это настройка администратора платформы, с вашей стороны чинить нечего: отвечать из «Чатов» уже можно, входящие появятся после его правки.
• Кнопка «Записаться» не появилась — попробуйте переподключить токен, затем перезапустите клиент Telegram (кнопка меню кэшируется на устройстве). Если не помогло, поставьте её вручную: @BotFather → Bot Settings → Menu Button.
• Окно записи не открывается — причина на стороне сертификата или настроек сайта, а не BotFather. Напишите в поддержку: домен бота тут ни при чём.
• У бота сотрудников нет кнопки «Открыть» — не включено мини-приложение в @BotFather (шаг 8). Кабинет поставить её не может; после включения нажмите «Проверить» в чек-листе. Кнопка меню внутри чата бота работает и без этого.
• «Telegram не принял этот токен» — токен скопирован не целиком либо бот удалён в BotFather. Запросите токен заново командой /mybots.