Telegram
Telegram используется в трёх сценариях. Собственный бот заведения, созданный у BotFather, служит для входа гостя в
личный кабинет и как канал связи с гостем в блоке «Репутация». Общий бот Смартомато присылает сотрудникам
уведомления о заказах.
Бот заведения: вход гостя и «Репутация»
- Вход гостя. Гость получает подтверждение в чате с ботом и входит одной кнопкой, без SMS и звонка. По статье для
заведения это бесплатно. С мобильного сайта и из приложения сразу открывается установленное приложение
Telegram.
- «Репутация». От имени бота гость получает просьбу оценить заказ и переписывается с оператором.
Что нужно до подключения
- Имя бота.
- Описание бота — до 120 символов.
- Иконка бота с соотношением сторон 1:1.
- Отдельный бот на каждую организацию, даже в мультибрендовом аккаунте.
- С одного аккаунта Telegram можно создать не больше 4 ботов в сутки. Дальше придётся ждать до конца дня.
Создание бота в BotFather
Статьи о входе и о «Репутации» приводят одни и те же шаги.
1. Открыть @BotFather.
2. «Меню» → команда /newbot.
3. Ввести название бота, обычно это название заведения. Зачем: оно отображается в шапке чата, от него гость получает
сообщения.
4. Ввести имя бота — адрес, по которому бота находят и добавляют. Имя должно оканчиваться на bot, например
smartomato_MyBurger_bot.
5. Скопировать API-токен, который выдаст BotFather.
6. «Меню» → /setabouttext → выбрать бота → ввести описание (пример текста для «Репутации» — в исходной статье
«Репутация»).
7. «Меню» → /setuserpic → выбрать бота → загрузить иконку 1:1.
Если бота создаёт поддержка и передаёт клиенту (прежняя схема)
Эти шаги есть только в статье «Telegram» (раздел «Авторизация через мессенджеры»).
1. На аккаунте Telegram, где создаётся бот и с которого передаются права, должна быть включена двухфакторная
авторизация (облачный пароль).
2. У клиента запрашивают имя пользователя Telegram (через @) — ему будут переданы права на бота.
3. Регистрируют вебхук бота запросом к Bot API Telegram (в статье — через Postman). Вместо <API_Token> подставляют
токен из шага 5.
curl -F "url=telegram-order-and-auth-bot.smartomato.ru/telegram/<API_Token>/webhook" \
-F "max_connections=40" \
-F "allowed_updates=['message', 'callback_query']" \
https://api.telegram.org/bot<API_Token>/setWebhook
- Зачем: Telegram начинает пересылать сообщения бота на сервер Смартомато.
4. Новый владелец хотя бы раз взаимодействует с ботом: авторизуется через него на сайте или в приложении. Без этого
права передать не получится.
5. Передать права: /mybots → выбрать бота → «Transfer Ownership» → «Choose recipient» → указать имя пользователя →
подтвердить.
Бот уведомлений о заказах
Уведомления о заказах сотрудникам заведения приходят через общий бот Смартомато @Smartomato_notifications_bot. Бота
добавляют в личный чат или в группу смены. Что и по каким ресторанам присылать, настраивается командами в самом
боте.
Что нужно до подключения
- Учётная запись сотрудника в Смартомато — логин и пароль от неё вводятся в боте.
Шаги на стороне Telegram
1. Написать боту https://t.me/Smartomato_notifications_bot или добавить его в группу.
2. В группе выдать боту права администратора и доступ к сообщениям. Зачем: без этого бот не сможет писать в группу.
3. Запустить бота командой /start.
4. Авторизоваться командой /auth — ввести логин и пароль от учётной записи в Смартомато.
5. Командой /edit_restaurants выбрать ресторан, по которому нужны уведомления.
6. При необходимости изменить набор уведомлений командой /notifications_settings.
7. Проверить работу бота тестовым заказом.
Что умеет бот
- Уведомления о новых заказах или только об оплаченных.
- Об отменённых заказах и об оценке заказа.
- Об ошибке отправки заказа в кассу (если касса подключена).
- О задолженности по оплате тарифа — только для учётных записей «Администратор».
- О назначении курьера аутсорс-службы на доставку.
- В уведомлении о новом заказе — данные заказа (статус, номер, даты, тип и адрес доставки, состав, комментарий,
приборы, слот), гостя (имя, кликабельный телефон) и оплаты (способ, статус, сумма, сдача, списанные бонусы).
- Шаблон уведомления о заказе меняется командой /edit_order_template.
Что передать в Смартомато
Для бота заведения (вход гостя и «Репутация»):
- API-токен бота.
- Имя бота (username), которое оканчивается на bot.
Типовые ошибки и вопросы клиентов
Бот заведения
- BotFather не даёт создать бота. С одного аккаунта создаётся не больше 4 ботов в сутки. Нужно подождать до конца дня.
- Не получается передать права на бота. Новый владелец ни разу не взаимодействовал с ботом, или на аккаунте, с
которого передают права, нет двухфакторной авторизации.
- Один бот на несколько организаций. Нельзя: у каждой организации свой бот.
Бот уведомлений о заказах
- Заказ с оплатой «Картой онлайн» пришёл со статусом «не оплачен». Так и должно быть: после оплаты бот обновит это
сообщение на актуальный статус и дополнительно пришлёт ответом на него сообщение, что заказ оплачен.
- Как поменять шаблон уведомления о заказе? Командой /edit_order_template в боте, дальше — по инструкции бота.
Связь заведения с поддержкой Смартомато
Отдельно от ботов заведения: сотрудники заведения пишут в поддержку Смартомато через Telegram-группу с ботом Смартомато.
1. Создать группу в Telegram и добавить в неё сотрудников, которым нужна связь с поддержкой.
2. Добавить в группу бота @smartomato_help.
3. Выдать боту права администратора («Управление группой» → «Администраторы» → «Добавить администратора»).
4. Включить в группе «Темы».
Каждое обращение становится отдельной темой: новое сообщение в General превращается в тему, к которой подключается
сотрудник поддержки; в закрытую тему можно написать снова.
Связанные статьи
- Вход через мессенджер
- Набор и порядок способов входа
- Каналы коммуникации
- Оценка заказа и работа с отзывами
- Переписка с гостем
- Уведомления о заказах сотрудникам