Как вам помочь ?
Модуль "Telegram бот"
В данной статье рассмотрим настройки и работу модуля "Телеграм бота".
С помощью данного модуля можно подключить Телеграм бота к Вашему магазину и получать от него уведомления о событиях связанных с заказами.
Благодаря боту менеджеры Вашего магазина смогут оперативно узнавать об оформлении новых заказов, смене статусов существующих заказов, а также об их оплате. Также Вы сможете настроить шаблон сообщения с нужной информацией, которую бот будет присылать при возникновении нового события заказа.
Настройки у BotFather
Первым шагом в настройках требуется получить уникальный id бота, являющийся одновременно и токеном. Для этого в Telegram существует специальный бот — @BotFather (рис.1). Вызвать бота можно введя в поиске telegram - botfather или в браузере открыть по ссылке https://telegram.me/botfather.
Рисунок 1.
Нажимаем на кнопку "Start" или пишем сообщение "/start" и получаем список всех его команд (рис.2).
Рисунок 2.
Первая и главная команда для создания бота — "/newbot". В чате BotFather отправляем команду или выбираем из списка "/newbot". В диалоге BotFather просит придумать имя новому боту, затем адрес бота (рис.3).
Рисунок 3.
В случае успешного создания нового бота, BotFather возвращает токен бота и ссылку для быстрого добавления бота в контакты (рис.4). Дальше, если необходимо, можно настроить для своего бота аватарку, описание, и т.д. Также можно проверить полученный токен с помощью ссылки api.telegram.org/bot<TOKEN>/getMe.
Рисунок 4.
Настройки модуля
Перейдем в настройки модуля, для этого в панели администрировании перейдите в пункт меню "Модули", найдите модуль "Telegram бот", установите его и перейдите в настройки (рис.5)
Рисунок 5.
Настройки админ-бота
Для связи между ботом и магазином используется токен бот (скопируйте его из сообщения BotFather в момент создания бота (рис.4, цифра 2), затем вставьте в поле токен бот в настройках модуля (рис.6, цифра 1)
Рисунок 6.
Url магазина (рис.6, цифра 2) - это url вашего магазина, подставляется автоматически.
Ссылка на бота (рис.6, цифра 3) - это прямая ссылка на бота в telegram, данная ссылка появляется в случае правильно проделанных действий, а именно введения токена и url.
Заметка
Связь между сайтом и ботом telegram происходит в момент активации модуля, если заполнено поле токена в настройках модуля. Отвязывается во время деактивации модуля, или очистки поля токена и сохранения настроек.
Т.е., если чтобы перепривязать связь к новому токену нужно активировать/деактивировать модуль, после добавления нового токена в настройки.
Если токен и url магазина заданы правильно, после активации модуля, нужно обновить текущую вкладку. Если вверху страницы появилась ссылка на бота (рис.6, цифра 3), значит связь установлена и вы правильно проделали настройки.
Если поменялся токен бота, или url сайта и нужно изменить настройки, требуется сначала деактивировать модуль, обновить вкладку, проверить чтобы ссылка на бота исчезла, и после этого снова активировать модуль и задать другие значения.
На вкладке "Настройки админ-бота" можно отметить в каких случаях будет происходить оповещение в telegram (рис.7)
Рисунок 7.
Сообщать о новых заказах - данная настройка позволяет сообщать в бот telegram информацию о новых заказах, вы можете изменить текст сообщения, используя доступные переменные.
Сообщать об оплате заказа - данная настройка позволяет сообщать в бот telegram информацию о том, оплачен ли заказ, в поле "текст сообщения" вы можете написать текст, используя доступные переменные.
Сообщать о смене статуса заказа - данная настройка позволяет сообщать в бот telegram информацию о смене статуса заказа. Для настройки требуется добавлять шаблоны, указать для какого статуса будет использовано уведомление. В поле шаблон пишите текст сообщения, используя доступные переменные. (рис.8)
Рисунок 8.
Использовать дополнительные настройки менеджеров (для повышенной защиты данных)- данная настройка позволяет ввести ограничения для большего контроля, активируйте настройку и перейдите на вкладку "Настройки менеджеров" (рис.9).
Рисунок 9.
В этой вкладке, можно связать менеджеров/администраторов сайта с определенным чатом в telegram. Только связанные пользователи будут получать данные о заказах в чаты, которые с ними связаны.
Связываются они по id-чата – уникальному id который выдается каждому пользователю (группе) в teltegram. Для этого нажмите на кнопку "Добавить", в таблице выберите менеджера или администратора, в поле id-чата введите id, и нажмите на зеленый крестик (рис.10), после добавления таблица выглядит как на рис.11.
Рисунок 10.
Рисунок 11.
Чтобы узнать id чата, необходимо написать боту "/chatid" или "/start" (рис.12).
Рисунок 12.
После активации настройки "Использовать дополнительные настройки менеджеров (для повышенной защиты данных)", становится доступна опция "Сообщать о смене статуса заказа и оплате только менеджеру связанному с этим заказом" (рис.13). Если включить эту опциию, то в настройках менеджеров напротив каждого менеджера появляется доп. опция: "Сообщать в этот чат о сменах статуса и оплате для всех заказов", активировав ее, соответствующий менеджер будет получать уведомления по всем заказам (рис.14).
Рисунок 13.
Рисунок 14.
Посмотрим как работает уведомление менеджеру/администратору в telegram. Например, в магазине был оформлен новый заказ номер 4, а заказ номер 3 был оплачен, тогда данная информация поступит в качестве сообщения в telegram (рис.15).
Рисунок 15.
Заметка
Если в настройках менеджеров нет привязки к id чатам, то по умолчанию все чаты добавляются с привязкой к администратору сайта.
Настройки клиент-бота
Настройки клиент-бота аналогичны настройкам админ-бота, а именно создаете бота в BotFather, прописываете токен. Если все сделано корректно вверху появляется ссылка на бота. Также доступно два уведомления - "Сообщать о новых заказах" и "Сообщать о смене статуса заказа" (рис.16)
Рисунок 16.
Для клиента ссылка на бота доступна в шапке сайта в клиентской части (рис.17)
Рисунок 17.
Покупателю нужно перейти по ссылке в шапке сайта и связать свой аккаунт на сайте с аккаунтом telegram. При переходе по ссылке, если клиент не авторизовался в магазине, выйдет сообщение о том, что нужно перейти на сайт и зарегистрироваться (рис. 18, цифра 3).
Рисунок 18.
Далее отобразится сообщение об успешной регистрации (рис.19).
Рисунок 19.
После чего клиент сможет получать уведомления о заказах (если они включены в настройках модуля), и взаимодействовать с ботом с помощью команд (рис.20).
Рисунок 20.
Для того, чтобы вам проверить верно ли работает клиент-бот, необходимо проделать описанное выше действия с созданием нового бота, либо можно отвязать связь в настройках админ-бота, очистив токен в настройках, и привязать к клиент-боту. Это необходимо так как один и тот же бот не может использоваться как админ и клиент одновременно.
Заметка
Доступные команды в telegram боте
/start - начало работы с ботом
/order - получить информацию о заказе
/status - получить информацию о статусе заказа
/payment - получить информацию об оплате заказа
/cancel - отменить текущую команду
/help - список доступных команд
/chat - узнать id чата
/help - справка, чтобы узнать все командыКоманды /order, /status, /payment можно использовать сразу с номером заказа (например: "/order 5"), или ввести команду, и после ответа бота ввести номер заказа.
Готово. В данной инструкции мы рассмотрели как настроить и работать с telegram ботом.
Другие статьи по теме
Тэги: телеграм, telegram бот, сообщения, уведомления, заказ, оплата, чат, смена статуса заказа