Как вам помочь ?

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

Актуально для версии магазина: 7.0

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

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

Настройки у 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 бот, сообщения, уведомления, заказ, оплата, чат, смена статуса заказа