Telegram bot действия с токеном — Модуль «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 ботом.