Telegram-бот: подключение и работа с клиентами

Настройка занимает примерно 3-5 минут. После подключения бот сможет:

• напоминать клиентам о занятиях с кнопками «Приду» и «Не приду» - ответ клиента сразу виден в журнале посещений;
• сообщать о записи на занятие, отмеченном посещении, пропуске и отмене занятия;
• показывать остаток занятий;
• предупреждать о последнем занятии и окончании срока абонемента;
• напоминать о себе клиентам, которые давно не приходили (через 7, 14, 30 или другое число дней, включается в настройках уведомлений);
• показывать цены, реквизиты для оплаты и адрес студии;
• принимать заявки на запись от новых людей;
• передавать сообщения клиентов в раздел Чат.

Шаг 1. Создайте бота в Telegram

1. Откройте @BotFather

   В Telegram найдите бота @BotFather и нажмите «Start». Это официальный бот Telegram, который создаёт всех остальных ботов.

2. Отправьте команду /newbot

   Напишите /newbot и следуйте подсказкам.

3. Придумайте название

   Укажите название бота - например, FitClub Assistant. Его клиенты увидят в переписке.

4. Придумайте username

   Username должен быть уникальным и заканчиваться на bot - например, fitclub_helper_bot.

5. Скопируйте токен

   BotFather пришлёт токен вида 123456789:AAHxxxxxxxxxxxxxxxxxxxx. Скопируйте его целиком - он понадобится на следующем шаге.

Шаг 2. Подключите бота к Abonio

1. Откройте настройки

   В Abonio перейдите в Настройки -> Интеграции и найдите карточку Telegram.

2. Вставьте токен

   Вставьте скопированный токен в поле бота.

3. Нажмите «Подключить»

   Abonio проверит токен и подключит бота - появятся его имя и статус Подключено.

Готово! Теперь бот может отправлять уведомления вашим клиентам. В карточке видно имя бота и список Что умеет бот: что доступно всем пользователям Telegram, а что только клиентам, привязанным к карточке. Ниже показано, включена ли запись через бота. Какие уведомления отправлять и с каким текстом, настраивается в настройках студии на вкладке Уведомления.

Что видит человек в боте

У бота есть меню команд:

• /prices - Стоимость абонементов. Список берётся из раздела Абонементы, поэтому новые цены бот показывает сразу.
• /pay - Как оплатить. Бот показывает реквизиты из Настройки -> Студия -> Способы оплаты. После перевода клиент нажимает «Я оплатил». Если он привязан к карточке, отметка об оплате появится в его переписке в Чате.
• /find - Как нас найти. Адрес, фото и видео из карточки локации. Если локаций несколько, бот сначала предложит выбрать нужную.
• /balance - Остаток занятий по действующим абонементам. Работает только для клиентов, привязанных к карточке. Если к Telegram привязано несколько детей, бот покажет остаток по каждому.
• /start и /stop - подписаться на уведомления и отписаться от них.

Можно и просто написать боту, например «цены», «адрес» или «остаток».

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

Привяжите клиентов к боту

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

1. Откройте карточку клиента

   В боковой колонке карточки есть блок Telegram. Нажмите Подключить Telegram - Abonio покажет QR-код и персональную ссылку.

2. Передайте QR или ссылку клиенту

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

3. Клиент нажимает «Старт»

   Telegram привязывается к карточке, и бот пишет: «Готово! Вы будете получать уведомления от студии».

Несколько детей у одного родителя

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

• Уведомления по всем детям приходят в один чат, и в начале каждого стоит имя ребёнка.
• Кнопки «Приду» и «Не приду» относятся к тому ребёнку, о котором напоминание, даже если дети записаны на одно занятие.
• /balance показывает остаток по каждому ребёнку.
• В разделе Чат у семьи одна общая переписка, её можно открыть из карточки любого из детей.

Если в карточке ребёнка указан Telegram родителя, а родитель уже подключён через другого ребёнка, в блоке Telegram появится «Этот Telegram уже подключён к боту» и кнопка Отправить ссылку в бот: родителю останется нажать «Старт». Отключение бота у одного ребёнка не затрагивает остальных.

Запись через бота

Бот может принимать заявки от людей, которые ещё не ваши клиенты: например, нашли бота сами или пришли по ссылке с сайта. Форма настраивается в разделе Клиенты на вкладке Гости: в карточке Запись через бота нажмите Настроить.

• Принимать заявки через бота - включает кнопку записи в боте.
• Надпись на кнопке - выберите готовый вариант или напишите свой. Строка В боте: показывает, как кнопка будет выглядеть.
• Условия первого визита (необязательно) - бот покажет этот текст перед анкетой, например «первое занятие бесплатно».
• Уровень подготовки (необязательно) - добавьте варианты кнопкой Добавить вариант, и бот спросит уровень. Без вариантов вопрос пропускается.

Не забудьте нажать Сохранить. Бот спросит, для кого запись (для себя или для ребёнка), имя и фамилию, дату рождения ребёнка, способ связи, имя родителя, локацию (если их несколько), уровень и комментарий, а затем попросит подтвердить данные. Заявка появится на вкладке Гости. Кнопка Создать на модерации превращает её в карточку клиента, к которой бот уже привязан, а галочка Дать бесплатное пробное занятие (при платном пробном Дать пробное занятие) сразу выдаёт пробное. Если заявку на ещё одного ребёнка оставил родитель, который уже подключён к боту, новая карточка привяжется к тому же Telegram. Запись через бота работает на любом тарифе, а менять её настройки могут сотрудники с правом «Интеграции: редактирование».

Языки бота

Бот может говорить с клиентами на разных языках, независимо от языка интерфейса студии. Например, студия работает на русском, а часть клиентов получает бота и уведомления на грузинском. Несколько языков есть на тарифе Business; на других тарифах бот, уведомления и письма идут на основном языке, а добавленные языки и выбор клиентов сохраняются до перехода на Business.

1. Откройте Настройки -> Языки и нажмите Добавить язык. Язык добавится черновиком: клиенты его пока не видят. Ваши языки видны только вашей студии.
2. Для украинского, грузинского и турецкого меню, ответы и анкета записи уже переведены. Тексты уведомлений проверьте в Настройки -> Уведомления: над шаблонами появится переключатель языка, а у каждого шаблона пометка, откуда берётся текст.
3. Включите Предлагать клиентам. Бот предложит выбрать язык на первом /start, а в меню появится команда /language. Клиенты, которые писали боту раньше, увидят выбор языка один раз, при следующем сообщении.

Язык клиента виден в его карточке, в строке Язык бота, а меняется в форме редактирования клиента, в поле с тем же названием: когда клиент выбирает язык в боте, поле заполняется само. Если выбранный клиентом язык студия сейчас не предлагает, в карточке написано, на каком языке сообщения уходят на самом деле. Если один Telegram привязан к нескольким детям, язык ставится всем им. Если перевода на язык клиента нет (текста уведомления, названия группы, адреса), он уходит на основном языке бота, как записан в студии. Другие переводы, например английский, вместо него не подставляются. Имена в сообщениях стоят подписью, например «Занятие проводит: Иван Петров», поэтому не склоняются.

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

Язык клиента виден и в других местах: в шапке диалога в Чате (чтобы отвечать на нём), у гостей бота и в фильтре Язык бота над списком клиентов. Рассылка уходит так, как написана: если среди получателей есть клиенты на другом языке, окно рассылки покажет, сколько их. В импорте клиентов есть необязательный столбец Язык бота.

Названия, имена и адреса на других языках

Названия групп, имена тренеров, адреса, абонементы, реквизиты и тексты анкеты записи вводятся на вашем языке. Чтобы клиент видел их на своём, переведите их:

• в Настройки -> Языки, раздел Переводы данных: там всё, что попадает в бот и уведомления, с отметкой «N из M» по каждому разделу;
• или кнопкой с глобусом рядом с полем: в карточке группы, тренера, локации, абонемента, в реквизитах и в настройках анкеты записи.

Имя клиента переводится только на его язык: глобус появится в карточке, когда у клиента выбран язык, отличный от основного. На вкладке Уведомления у шаблона на другом языке видно, какие данные ещё не переведены, а кнопка Перевести открывает именно их. Без перевода данные уходят как в оригинале. Если оригинал потом изменился (например, группу переименовали), перевод помечается и не используется, пока его не обновят.

Общайтесь с клиентами

Когда клиент привязан, переписка идёт через раздел Чат:

• пишите клиенту лично - текст или фото уйдут ему в Telegram;
• всё, что клиент пишет боту, попадает в Чат, и вы можете ответить;
• делайте рассылки всем клиентам, отдельной группе или своей команде.

Вкладка Переписки входит в тариф Business. Вкладка Статусы с журналом отправок показывает, кому и когда ушли уведомления.

Необязательно: сделайте бота красивее

Эти шаги можно пропустить и вернуться к ним позже. В @BotFather откройте /mybots и выберите своего бота.

Фотография бота

Откройте «Edit Bot -> Edit Botpic» и отправьте изображение. Лучше всего подойдёт:

• квадратная картинка;
• логотип клуба;
• размер от 512×512 px.

Описание

Откройте «Edit Bot -> Edit Description». Оно показывается в профиле бота. Пример:

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

Короткое описание

Откройте «Edit Bot -> Edit About». Эта строка видна в поиске Telegram и в списке чатов. Пример:

Напоминания и управление тренировками в FitClub.

Если бот не отвечает

Проверьте, что:

• токен скопирован полностью;
• бот подключён только к одному сервису;
• на вкладке Интеграции у бота статус Подключено.

Если в меню бота нет нужных команд или кнопки «Приду» и «Не приду» не срабатывают, нажмите Обновить бота на вкладке Интеграции. Если проблема осталась - отключите и подключите бота заново. Один бот в Telegram может работать только с одной интеграцией одновременно.

Дальше: Чат и настройки студии.