Модуль "Telegram бот"

В данной статье рассмотрим настройки и работу модуля "Телеграм бота".

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

• Настройки у BotFather
• Настройки модуля

Настройки у 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 ботом.