Telegram BOT
Описание
Telegram - мессенджер, который позволяет переписываться на различных устройствах.
Боты - приложения в Telegram позволяющие использовать часть функционала сайта не заходя на него.
В данный момент доступно два бота: для пользователей и для менеджеров
Функции бота пользователей:
Создание и проведение обменов
Создание и оплата счетов (инвойсов) (отключено по умолчанию)
Просмотр резервов валют
Запрос пополнения резервов валют (отключено по умолчанию)
Просмотр тарифов на обмены
Просмотр и добавление отзывов (отключено по умолчанию)
Ответы на вопросы (FAQ)
Обращение в техподдержку (по умолчанию не доступно для не зарегистрированных пользователей (группа Гость))
Панель пользователя (регистрация, вход, смена и восстановление пароля)
Списки обменов и счетов (инвойсов) пользователя
Верификация карт и личных данных (отключено по умолчанию)
Статистика партнерской программы
Поиск транзакции по хэшу
Ссылки на файлы мониторингов (только через команду в меню)
Получение оповещений
Выбор языка (если включено)
Функции бота менеджеров:
Просмотр и изменение статусов транзакций
Ответы на запросы в техподдержку
Обработка запросов на верификации
Модерация отзывов
Получение оповещений (согласно настройкам)
Выбор языка (если включено)
Создание ботов
Для создания бота нужно в Telegram найти бота с логином BotFather и начать с ним чат.
Нажмите Старт и в появившемся меню (или в приветственном сообщении бота) выберите первую команду /newbot
BotFather попросит ввести имя бота. Оно будет отображаться в заголовке чата с вашим ботом.
После этого BotFather попросит ввести логин бота. Логин должен быть без пробелов и заканчиваться на bot, например moneytopbot
Если логин уже занят, вас попросят ввести другой.
Если все прошло успешно, вы получите токен бота. Скопировать токен можно обычным кликом/тапом по нему.
Токен нужно ввести в админке Настройки - Конфигурация - Telegram BOT - Токен бота пользователей / Токен бота менеджеров
Если вы собираетесь использовать оба бота (пользователей и менеджеров), вам нужно создать двух ботов с разными логинами и токенами.
Проверить, что token верный и ваш бот зарегистрирован можно по ссылке https://api.telegram.org/bot<Token>/getMe
Вместо <Token> введите ваш токен
Выглядеть будет примерно так:
https://api.telegram.org/bot5997799257:AAE-Mlk6e0IcOKSFKhH5VGGI6-YEZCgy25M/getMe
В браузере будет выведены username и имя вашего бота:
{"ok":true,"result":{"id":5997799257,"is_bot":true,"first_name":"MoneyTop","username":"mtoptestbot","can_join_groups":true,"can_read_all_group_messages":false,"supports_inline_queries":false}}
Далее нужно активировать бота. Для этого нажмите соответствующую кнопку под полем ввода токена и дождитесь завершения активации.
Сообщение Webhook was set - означает успешную активацию.
Если вы используете оба бота, их нужно активировать по отдельности.
Рядом с полем ввода токена для бота пользователей есть поле Логин бота, туда нужно ввести логин (без @) или нажать на кнопку Получить для автоматического определения логина бота.
После этого обязательно сохраните настройки
Теперь вы можете открыть ботов (кнопки рядом с токенами). Бот пользователей должен полностью функционировать, а для бота менеджеров нужно выдать доступ для ID чата.
Перейдя в бот менеджеров, вы получите сообщение со своим ID чата
Скопируйте ваш ID чата (кликом или тапом) и введите его в поле Telegram CHAT ID в админке. Вы можете вводить в это поле несколько ID через запятую.
Сохраните настройки и отправьте боту сообщение любого содержания, чтобы он перепроверил ваш доступ. Если все в порядке - бот не будет писать об ошибке доступа и откроется меню бота.
Настройки бота менеджеров
Дополнительные настройки бота менеджеров:
Оповещения - короткие сообщения всем активным чатам с ботом
Изменение файлов - Оповещать об изменении файлов на сервере
Запросы резерва - Оповещать о запросах резерва (обменник). Подробности здесь
Контакты - Оповещать о отправке сообщения с формы обратной связи
Техподдержка - Оповещать о запросах в техподдержку
Верификация - Оповещать о запросе верификации
Вывод средств - Оповещать о запросе вывода средств (партнерка)
Менеджеры - Оповещать о добавлении отзыва о работе менеджера
Отзывы - Оповещать о добавлении отзыва (обменник)
Курсы валют - Оповещения о сбоях получения курсов. Подробности здесь
Ошибки обменов - Оповещать об ошибках обменов
Обработка оператором - Оповещать о новых заявках с типом Обработка оператором
Обработка оператором оплачена - Оповещать о оплаченных заявках с типом Обработка оператором
Обмен завершен (автомат) - Оповещать об успешно завершенных обменах
Средства получены (полуавтомат) - Оповещать о оплаченных заявках с типом Полуавтомат
Ошибки автоматических торгов - Оповещать об ошибках при проведении автоматических торгов. Подробности здесь
Кол-во отзывов на страницу - сколько элементов будет показано на одной странице списка отзывов пользователей
Кол-во запросов в поддержку на страницу - сколько элементов будет показано на одной странице списка запросов в поддержку
Кол-во транзакций на страницу (3 в ряду) - сколько элементов будет показано на одной странице списка транзакций. Оптимально вводить число кратное трем.
Кол-во верификаций на страницу - сколько элементов будет показано на одной странице списка запросов на верификацию
Настройки бота пользователей
Дополнительные настройки бота пользователей:
Загрузка файлов - где будут храниться файлы загруженные через бота. Загрузка файлов возможна для верификации и в запросах в поддержку.
В файловое хранилище - если оно включено, все файлы загруженные через бота будут добавлены в хранилище. Если хранилище отключено (не введен токен), файлы остаются в Telegram. Настройки хранилищ смотрите во вкладке "Файловые хранилища".
Оставлять в Telegram - файлы будут загружены на сервера Telegram. Срок хранения файлов точно неизвестен.
Ссылка на отзыв - отправлять ссылку (кнопку) на добавление отзыва в уведомлениях об успешном обмене, если отзывы включены. Если отключено - не зарегистрированные пользователи не смогут оставлять отзывы через бота, а зарегистрированные только через список своих транзакций.
Кол-во отзывов на страницу - сколько отзывов будет показано на одной странице списка отзывов пользователей. Отзывы показываются сразу в полном объеме, без сокращения их текстов.
Кол-во вопросов (помощь) на страницу - сколько элементов будет показано на одной странице списка ответов на вопросы модуля Помощь. Вопросы выводятся списком и открытием ответа по нажатию на вопрос.
Кол-во запросов в поддержку на страницу - сколько элементов будет показано на одной странице списка запросов в поддержку.
Кол-во транзакций на страницу (3 в ряду) - сколько элементов будет показано на одной странице списка транзакций. Оптимально вводить число кратное трем.
Кол-во инвойсов на страницу (2 в ряду) - сколько элементов будет показано на одной странице списка счетов (инвойсов). Оптимально вводить число кратное двум.
Кол-во партнерских отчислений на страницу - сколько элементов будет показано на одной странице списка партнерских отчислений пользователя.
Текст на главной странице бота - такой текст будет выведен на главной странице бота. {siteurl} - вывести адрес сайта обменника, {sitename} - вывести название обменника.
Оповещения для пользователей
Если пользователь совершает действия через бота, то он будет получать на него все уведомления связанные с этими действиями.
Если пользователь заходит в свой аккаунт через бота, то он будет получать на него все уведомления, где бы он не совершал действия (в боте или на сайте) с ними связанные.
Полезности
Часто задаваемые вопросы: https://tlgrm.ru/faq
Важно! У Telegram ограниченное HTML форматирование текста.
Если вы меняете тексты отправляемых уведомлений, учитывайте это. В противном случае вы не будете получать эти уведомления.
Поддерживаются HTML тэги:
<b>Жирный</b>, <strong>Жирный</strong>
<i>Наклонный</i>, <em>Наклонный</em>
<a href="http://money-top.com/">URL</a>
<code>Код</code>
<pre>Форматированный блок</pre>
Last updated