Telegram

​Как подключить бота Telegram​
​Как работать с кнопками​
​Как настроить работу бота в группе Telegram​
​Какие переменные необходимы для работы в чатах​
​Как делать разметку текста в Телеграм​
​Как работать в inline режиме в Телеграм​
Как подключить бота Telegram
Бот в Telegram создается при помощи другого бота под названием BotFather. Отправляем ему команду /newbot, выбираем имя, которое будет отображаться в списке контактов, логи нашего бота (должен обязательно заканчиваться на bot или _bot).
Если адрес не занят, а имя введено правильно, BotFather пришлет в ответ сообщение с токеном — «ключом» для доступа к созданному боту. Его нужно сохранить и никому не показывать (Рисунок 1)
Рисунок 1
После этого заходим в раздел "Мессенджеры и чаты", выбираем телеграм и вводим имя бота, его логин и полученный токен (Рисунок 2)
Рисунок 2
Жмем кнопку готово. На этом подключение бота завершено.
Отправка файлов настоящее время работает только для gif -, pdf-и zip-файлов
Как работать с кнопками
Кнопки
Salebot.pro
Как совместить два вида кнопок
Создаете блок с reply-кнопкой (кнопками), которые вам необходимо визуализировать. Например: [{"type": "reply", "text": "НАЗВАНИЕ КНОПКИ", "line": 0, "index_in_line": 0}]
Далее создаете следующий блок (таймер в 0 секунд) с inline-кнопками, которые необходимо разместить, не убирая reply-кнопки. Например: [{"type": "inline", "text": "НАЗВАНИЕ КНОПКИ", "line": 0, "index_in_line": 0}]
Результат:
Названия кнопок должны совпадать с блоком «Уcловие» в сообщении, на которое должна вести кнопка.
Обязательно соблюдайте последовательность: сначала reply кнопки, а потом inline. Иначе reply кнопки пропадут со следующим блоком.
Видеоверсия
Как настроить работу бота в группе Telegram
Чтобы бот работал в чате или канале Телеграм, вы должны:
1) Добавить бота в него администратором;
2) Включить в BotFather эту возможность, как указано ниже.
Какие переменные необходимы для работы в чатах
Переменные с информацией об авторе сообщения 
message_from - идентификатор автора сообщения 
message_from_name - имя автора сообщения 
message_from_username - ник автора сообщения в Телеграм
Переменные с информацией о пересылаемом сообщении
reply_message_id - номер сообщения, которое пересылают 
reply_from - кто автор пересылаемого сообщения 
reply_from_name - имя того, чье сообщение пересылается 
reply_from_username - ник того, чье сообщение пересылается 
reply_from_chat_id - номер диалога, из которого сообщение переслали
Добавление и удаление из группы
В этом случае срабатывают колбеки new_chat_member и left_chat_member
chat_member_name - имя пользователя
chat_member_username - ник пользоваля
chat_member_id - номер пользователя
Как делать разметку текста в Телеграм
Для разметки текста в нужном блоке открываете Расширенные настройки и там включаете переключатель "Markdown в Telegram":
Если в этом блоке встречаются символы из перечисленных: '_', '*', '[', ']', '(', ')', '~', '`', '>', '#', '+', '-', '=', '|', '{', '}', '.', '!'  — их нужно экранировать, добавлять перед ними обратный слэш \ 
Иначе сообщение не отправится вообще. При этом не имеет значения, какой участок текста вы размечаете.
 Пример: привет\. Рады *тебя* видеть\!
Экранирование текста возможно как вручную, так и в калькуляторе при помощи функции 
txt = tg_escape(s)
На вход подается s - строка с исходным текстом. 
На выходе в txt приходит строка уже с вставленными слешами в нужных местах. 
Пример:
Пример экранирования
Как выглядит текст в Телеграме
Как выглядит текст в других мессенджерах
Далее размечаете нужный текст:
Чтобы сделать текст жирным, с обеих сторон ставите звездочки: *тут текст*
Для курсива — нижнее подчёркивание: _текст_
Подчеркнутый текст — два нижних подчеркивания с обеих сторон: __текст__
Зачеркнутый текст — тильда с обеих сторон текста: ~текст~
Ссылка в тексте: [текст в квадратных скобках](ссылка в круглых скобках) 
[inline URL](http://www.example.com/)
Упоминание пользователя ТГ: [текст в квадратных скобках](ссылка на пользователя в круглых скобках). В ссылке после знака равно можно использовать #{platform_id} 
[inline mention of a user](tg://user?id=123456789)
Текст в виде кода — с обеих сторон текста поставить обратный апостроф: `inline fixed-width code`
Пример:
Результат:
Как работать в inline режиме в Телеграм
Как включить инлайн режим
Для работы бота в инлайн режиме, нужно включить эту опцию в настройках бота в BotFather - https://t.me/BotFather​
Выбираем нужного бота и переходим в настройки Bot Settings
Далее Inline Mode
И нужно включить инлайн режим, если он не включен
Как изменить плейсхолдер
Далее, по желанию, можно изменить плейсхолдер, который отображается до ввода поискового запроса. По умолчанию он Search…
Чтобы изменить нужно нажать кнопку Edit inline placeholder и отправить новый
Как настроить результаты вывода
После нажатия на вариант из списка в инлайн режиме, отправится сообщение, которое указано в заголовке выбранного варианта и на это значение можно настроить реакцию в воронке.
Чтоб указать данные для вывода в инлайн режиме, нужно задать переменную inline_bot. В инлайн режиме поиск по значениям в переменной inline_bot происходит, практически, в реальном времени.
Данные в переменной могут быть заданы тремя вариантами. Рассмотрим от самого простого, до максимальных настроек.
Массив с текстовыми данными
Например поиск будет происходить по массиву продуктов
Поиск происходит по вхождению введенной фразы в вариантах в массиве. Например 1 ввели букву м - выдало три варианта, 2 добавили букву а и результат отфильтрован по новым данным
После нажатие на нужный пункт в бот будет отправлено сообщение от пользователя
Пример данных:
["Молоко", "Хлеб", "Макароны", "Шоколад", "Яйца", "Масло", "Слойка", "Чай", "Овощи", "Фрукты"]
Массив со словарями для вариантов кнопок
Второй вариант более настраиваемый, вместо текстовых значений массив будет содержать словари.
Поиск для этого варианта осуществляется по значению ключа title 
регистр не учитывается
Разберем максимальный набор параметров для одного варианта (словаря). Для примера возьмем следующий:
{"title": "Оплата", "description": "Способы оплаты описание",
"thumb_url": "https://img.icons8.com/dusk/50/000000/card-exchange.png", "message_text": "оплата товара 1"}
title - заголовок кнопки
description - описание
thumb_url - ссылка на картинку
message_text - Этот текст отправится при выборе этого варианта
1. Пример вывода и после нажатия 2. отправился заданный текст
Для одного варианта (словаря) обязательным является только ключ title со значением, которое и отправится при нажатии на этот пункт.
Например: {"title": "Настройка"}
​
Пример данных:
[{"title": "Корзина", "description": "Выбранные товары", "thumb_url": "https://img.icons8.com/dusk/64/000000/shopping-basket.png"},
{"title": "Доставка", "description": "Варианты доставки заказа", "thumb_url": "https://img.icons8.com/dusk/64/000000/delivery--v1.png"},
{"title": "Оплата", "description": "Способы оплаты описание",
"thumb_url": "https://img.icons8.com/dusk/50/000000/card-exchange.png", "message_text": "оплата товара 1"},
{"title": "Настройка"}]
Словарь со списком для вариантов кнопок
Третий вариант подходит, если вы хотите задать определенные меню на нужные фразы и удобен в использовании вместе с инлайн кнопкой, в которой зашита нужная фраза.
Поиск для этого варианта осуществляется по полному совпадению запроса с ключом, за которым закреплено меню
В примере поиск будет происходить по ключам меню, посты и продукты
Структура следующая:
"ключ": [массив кнопок]
{"поисковая фраза1": [{"title": "Корзина", "description": "Выбранные товары"},
{"title": "Оплата", "description": "Способы оплаты",
"thumb_url": "#{переменная с урлом}", "message_text": "Способы оплаты"},
{"title": "Доставка", "description": "Варианты доставки заказа",
"thumb_url": "ссылка на картинку"}],
"поисковая фраза2": [{"title": "Первый", "description": "Описание 1111"},
{"title": "Четвертый", "description": "#{переменная}"}],
"поисковая фраза3": ["Молоко", "Хлеб", "#{переменная}", "Шоколад"]}
Значения это массив со словарями или массив со строками, комбинировать нельзя!
Разберем максимальный набор параметров для одного варианта (словаря). Для примера возьмем следующий:
{"title": "Оплата", "description": "Способы оплаты описание",
"thumb_url": "https://img.icons8.com/dusk/50/000000/card-exchange.png", "message_text": "оплата товара 1"}
title - заголовок кнопки
description - описание
thumb_url - ссылка на картинку
message_text - Этот текст отправится при выборе этого варианта
Минимально один вариант (словарь) должен содержать ключ title со значением, которое отправится при нажатии на этот пункт.
Например: {"title": "Настройка"}
Пример данных:
{"меню": [{"title": "Корзина", "description": "Выбранные товары",
"thumb_url": "https://img.icons8.com/dusk/64/000000/shopping-basket.png"},
{"title": "Оплата", "description": "Способы оплаты",
"thumb_url": "https://img.icons8.com/dusk/50/000000/card-exchange.png", "message_text": "Способы оплаты"},
{"title": "Доставка", "description": "Варианты доставки заказа",
"thumb_url": "https://img.icons8.com/dusk/64/000000/delivery--v1.png"}],
"посты": [{"title": "Первый", "description": "Описание 1111"},
{"title": "Второй", "description": "Описание 2222"},
{"title": "Третий", "description": "Описание 333"},
{"title": "Четвертый", "description": "Описание 44444"}],
"продукты": ["Молоко", "Хлеб", "Макароны", "Шоколад", "Яйца", "Масло", "Слойка", "Чай", "Овощи", "Фрукты"]}
Инлайн кнопка с заданным поисковым значением
Кнопка работает только в телеграм.
Чтоб задать поисковую фразу нужно в инлайн кнопку добавить параметр inline_query.
Со значением которое автоматически подставляется в запрос.
Рекомендуется использовать именно этот вариант для инлайн режима. Позволит избежать ошибок и работает быстрее.
Например добавим три кнопки, которые соответствуют примеру из предыдущей главы
[{"line":0,"index_in_line":0,"text":"Покажи меню","type":"inline","inline_query":"меню"},{"line":0,"index_in_line":1,"text":"Статьи","type":"inline","inline_query":"посты"},{"line":2,"index_in_line":0,"text":"Список продуктов","type":"inline","inline_query":"продукты"}]
При нажатии на кнопку, например Статьи выведется найденный список кнопок (при добавлении указали для этой кнопки "inline_query":"посты"):
Нажмем на кнопку Покажи меню:
Варианты берутся из заданной переменной, как описано выше
Примечания
Переменную inline_bot можно задать не только в общих переменных, но и просто переменной, но в таком случае ее значение нужно заключить в одинарные кавычки.
Пример в поле калькулятор:
inline_bot = '["Молоко", "Хлеб", "Макароны", "Шоколад", "Яйца", "Масло", "Слойка", "Чай", "Овощи", "Фрукты", "#{aa}"]'
 Также можно любое значение передать в виде переменной, для более гибкой настройки. 
Для примера простой вариант в массиве:
​
​