Telegram
Подключаем бота к Телеграм
Максимальная длина текстового сообщения 4096 символов, для сообщения с картинкой (1080*1080px) не более 1024 символов
Требования к файлам:
Api Telegram требователен к загружаемым файлам:
- Боты могут скачивать файлы до 20 МБ и отправлять файлы до 50 МБ
- Для работы с ранее загруженными файлами можно использовать file_id. В этом случае к файлу не применяются лимиты.
- Файлы могут быть отправлены с использованием url-адреса. В этом случае бот загружает файл и отправляет его. Лимиты: для фото 5Мб,остальные файлы 20Мб
- Для постинга установлены иные лимиты: для фото - 10Мб, остальные файлы - 50Мб
Требования к картинкам, фото:
Telegram предпочитает квадратные картинки, оптимально 900х900 пикселей весом не более 5Мб
Бот в Telegram создается при помощи другого бота под названием BotFather. Отправляем ему команду /newbot, выбираем имя, которое будет отображаться в списке контактов, логи нашего бота (должен обязательно заканчиваться на bot или _bot).
Если адрес не занят, а имя введено правильно, BotFather пришлет в ответ сообщение с токеном — «ключом» для доступа к созданному боту. Его нужно сохранить и никому не показывать:
Рисунок 1
После этого заходим в раздел "Мессенджеры и чаты", выбираем телеграм и вводим имя бота, его логин и полученный токен:
Жмем кнопку готово. На этом подключение бота завершено.
Отправка файлов настоящее время работает только для gif -, pdf-и zip-файлов
Создаете блок с 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)" и заполняете поля (поле дополнительный текст необязательно):
При нажатии на получившуюся кнопку будет предложено выбрать кому из списка контактов переслать информацию.
После выбора получателя будет вставлена ссылка из строки “Поделиться ссылкой”, а также текст из строки “Дополнительный текст”.
Таким образом, можно передавать ссылки, в том числе на сообщения из каналов в телеграмм.
Внимание!!! На некоторых устройствах под управлением iOs может работать некорректно.
Для работы этой кнопки требуется привязка бота к домену. Делается это через @BotFather.
Выберите бота в диалоге с @BotFather, далее Bot Settings
Далее переходим в пункт Domain -> Set Domain
Вам будет предложено установить домен для бота.
Как это сделать правильно? Отвечаем:
Для того, чтобы установить правильно домен возьмите ссылку, по которой нужно авторизоваться. Например, если вы используете минилендинг, то ссылка будет иметь такой вид: https://salebot.site/md/1914fd9ddcf63bf413d8fc6a67cddf2f
- 1.В этом примере для получения домена удаляем в начале https://: https://salebot.site/md/1914fd9ddcf63bf413d8fc6a67cddf2f
- 2.Далее удаляем все, начиная с первого символа / (в нашем случае это /md/1914fd9ddcf63bf413d8fc6a67cddf2f) salebot.site/md/1914fd9ddcf63bf413d8fc6a67cddf2f
- 3.Остается salebot.site - это и указываем для бота в качестве домена. Если используете эту кнопку не на минилендинге, а на своем сайте, то нужно настроить проверку подлинности данных. Для этого ознакомьтесь с документацией по ссылке: https://core.telegram.org/widgets/login
После того, как все приготовления готовы, можно создать кнопку:
В поле Текст впишите текст для надписи на кнопке
в поле Ссылка - url-адрес страницы, на которой будет реализована авторизация.
Остальные поля будут нужны, если для авторизации будет использоваться отдельный бот (требуется получить разрешение на отправку сообщений для этого бота):
в частности, потребуется указание имени бота. Если нужна возможность отправлять сообщения от указанного бота, то обязательно поставьте галочку для “Запросить разрешение у пользователя на отправку сообщений от бота”.
Для большинства довольно сложно освоить API ботов Telegram и потом использовать их при создании клавиатуры, но специально для новичков есть способ. Вы можете просто использовать генерируемый в расширенных настройках кнопок код в своих нуждах. Для этого перейдите в настройки кнопок в правой части экрана в конструкторе воронок.
Далее нажмите добавить кнопку и добавьте все нужные вам кнопки, разместив их так, как вам необходимо.
После этого скопируйте все из расширенных настроек кнопок (предварительно можете проверить работу кнопок прямо из этого блока) в переменную, не забыв поместить все скопированное между одинарных кавычек и передайте переменную в функцию в параметре reply_markup.
buttons='[{"line":0,"index_in_line":0,"text":"111","type":"inline","callback":"qwerty1"},{"line":0,"i ndex_in_line":1,"text":"222","type":"inline","callback":"qwerty2"},{"line":1,"index_in_line":0,"tex t":"333","type":"inline","callback":"qwerty3"}]' tg_send_message(platform_id, "123", "", buttons)
В результате получите кнопки в том виде, в каком задавали их в расширенных настройках кнопок.
Чтобы бот работал в чате или канале Телеграм, вы должны:
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 - номер пользователя
new_chat_member - добавлен новый пользователь
left_chat_member - пользователь покинул канал
kicked_chat_member - пользователь удален администратором
chat_join_request - получена заявка на добавление в канал
edited_channel_post - пост на канале был отредактирован (edited_channel_post + дата и время редактирования)
Пример того, как выглядят колбеки Telegram-канала в карточке клиента
При получении любого из вышеназванных колбеков обновляются значения переменных: chat_member_name - имя пользователя
chat_member_username - ник пользователя
chat_member_id - номер пользователя
Для принятия заявки и добавления пользователя в канал/чат используется функция:
tg_approve_chat_join_request(platform_id, user_id)
Для того, чтобы отклонить заявку в канал/чат используется:
tg_decline_chat_join_request(platform_id, user_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`
Пример:
Результат:
Чтобы защитить контент от распространения можно включить защищенный режим для сообщений. Для этого в "Редактирование сообщения"-"Расширенные настройки" нужно найти бегунок "Защитить контент":
Защищенные сообщения нельзя переслать, на телефоне нельзя сделать скриншот.
Для работы бота в инлайн режиме, нужно включить эту опцию в настройках бота в 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}"]'- Также можно любое значение передать в виде переменной, для более гибкой настройки.
Для примера простой вариант в массиве:
Для создания обычного опроса используется функция
tg_send_poll(platform_id, question, options, is_anonymous, allows_multiple_answers, reply_markup, disable_notification, protect_content, token, reply_to_message_id)
Обязательные параметры:
platform_id - id в Телеграм, куда нужно прислать сообщение
question - вопрос options - массив вариантов ответов
Необязательные параметры:
is_anonymous - 1 - анонимный опрос, '' - не анонимный
allows_multiple_answers - 1 - возможны несколько ответов, '' - один ответ
reply_markup - клавиатура или '' - без клавиатуры
disable_notification - 1 - отправить с уведомлением, '' - без уведомления
protect_content - 1 защитить от копирования и скриншотов, '' - без защиты
token - токен бота, если не передан используется текущий
reply_to_message_id - ид цитируемого сообщения
Пример:
options = [белый, красный, синий, зеленый]
tg_send_poll(platform_id, 'Ваш любимый цвет?', options, 1, '', '', 1, '')
1. Функция возвращает ответ от телеграма, в котором есть message_id, его лучше сохранять, так как с его помощью можно будет завершить опрос функцией tg_stop_poll (описание ниже) и получить результат.
2. Если опрос добавлен пользователем в канал, то в диалог придет колбек:
poll_added - неизменная часть
Вопрос - вопрос опроса
Если в чат, то дополнительно будут цифры это ид пользователя в телеграм, который добавил опрос.
Если в чат, то дополнительно будут цифры это id пользователя в телеграм, который добавил опрос.
При создании опроса ботом колбек не приходит.
3. В канале можно создавать только анонимные опросы
4. Если опрос был отправлен в диалог пользователя с ботом, то при ответе пользователя в чате сейлбот отобразится колбек с выбранным ответом (ответами). Нумерация ответов начинается с 0 (на скриншоте ниже был выбран 4 ответ)
poll_answer 5325838371359031647
[3]
poll_answer - неизменяемая часть
5325838371359031647 - идентификатор опроса
[3] - ответ
5. Если не анонимный опрос был создан в группе (не важно функцией или пользователем), в которой состоит бот, то на каждый голос будет отправлен вебхук, при получении которого будет отправлен в диалог с клиентом колбек из пункта 4. Если клиент не контактировал с ботом, то отправить ему что-либо в ответ не получится, пока клиент не активирует бота.
Внимание, рекомендуется отправлять в группу только анонимные опросы!
6. После создания опроса в переменную сохраните его идентификатор, чтоб понимать на какой опрос пришел колбек.
tg_send_quiz_poll(platform_id, question, options, explanation, correct_option_id, is_anonymous, reply_markup, parse_mode, protect_content, disable_notification, token, reply_to_message_id)
Обязательные параметры:
platform_id - id в Телеграм, куда нужно прислать сообщение
question - вопрос options - массив вариантов ответов
explanation - текст, который отображается, когда пользователь выбирает неправильный ответ или нажимает на значок лампы в опросе в стиле викторины, 0–200 символов с не более, чем двумя переводами строки после разбора сущностей.
correct_option_id - номер правильного ответа, нумерация с 1
Необязательные параметры:
is_anonymous - 1 - анонимный опрос, '' - неанонимный
reply_markup - клавиатура или '' - без клавиатуры
parse_mode - markdown или html для explanation или '' - без форматирования
protect_content - 1 защитить от копирования и скриншотов, '' - без защиты
disable_notification - 1 - отправить с уведомлением, '' - без уведомления
token - токен бота, если не передан используется текущий
reply_to_message_id - ид цитируемого сообщения
Пример:
options = ["белый", "красный", "синий", "зеленый"] r = tg_send_quiz_poll(platform_id, 'Какого цвета крокодил?', options, 'Вот такое вот объяснение.', 4, '', '', '', '', 1)
1. Функция возвращает ответ от телеграма, в котором есть message_id, его лучше сохранять, так как с его помощью можно будет завершить викторину функцией tg_stop_poll (описание ниже) и получить результат.
2. Если опрос добавлен пользователем в канал, то в диалог придет колбек:
poll_added - неизменная часть
Вопрос - вопрос опроса
Если в чат, то дополнительно будут цифры это ид пользователя в телеграм, который добавил опрос.
При создании опроса ботом колбек не приходит.
3. В канале можно создавать только анонимные викторины
4. Если викторина была отправлена в диалог пользователя с ботом или в чат, то при ответе пользователя в чате Salebot отобразится колбек с выбранным ответом.
Нумерация ответов начинается с 0.
poll_answer 5325838371359031648
[3]
poll_answer - неизменяемая часть
5325838371359031648 - идентификатор викторины
[3] - ответ
5. Если неанонимный опрос был создан в группе (не важно функцией или пользователем), в которой состоит бот, то на каждый голос будет отправлен вебхук, при получении которого в диалог с клиентом будет отправлен колбек из пункта 4. Если клиент не контактировал с ботом, то отправить ему что-либо в ответ не получится, пока клиент не активирует бота.
Внимание рекомендуется отправлять в группу только анонимные викторины!
6. После создания викторины сохраните в переменную его идентификатор, чтобы понимать на какой опрос пришел колбек.
Когда опрос или викторина завершаются этой функцией в ответ приходит словарь с результатом опроса.
Чтобы завершить опрос или викторину, нужно вызвать функцию tg_stop_poll
result = tg_stop_poll(platform_id, message_id)
platform_id - id в Телеграм, где находится викторина (ид пользователя, канала, группы) message_id - id сообщения с опросом или викториной
После выполнения функции в result запишется словарь, который можно распарсить используя функцию get():
{'update_id': 787499908, 'poll': {'id': '5258177312003719338', 'question': 'Тут вопрос?', 'options': [{'text': 'Ответ 1', 'voter_count': 1}, {'text': 'Ответ 2', 'voter_count': 1}, {'text': 'Ответ 3', 'voter_count': 0}], 'total_voter_count': 2, 'is_closed': True, 'is_anonymous': True, 'type': 'regular', 'allows_multiple_answers': False}}
Для получения полного вебхука от Телеграм достаточно присвоить любое значение переменной save_webhook (переменная может быть как константой проекта, так и переменной сделки).
При этом ответ Телеграм будет записываться в переменную tg_request, которую вы найдете в карточке клиента среди переменных сделки:
Реализуем простую схему на получение файла:
- 1.Присвойте переменной save_webhook любое значение удобным для вас способом, показанным выше - либо константа проекта, либо переменная сделки
- 2.Создайте блок с условием для запуска, в примере - хочуид
3. Из первого блока создайте следующий, в котором выведем результат
Теперь перейдем к практическим действиям:
- перейдите в подключенный бот Telegram
- напишите свое ключевое слово
- отправьте файл, ссылку которого вы желаете получить:
Нас интересует последний file_id в полученном ответе Telegram
Не забывайте, что полученная ссылка действует только в рамках того бота, в который вы отправляли файл
Для автоматического удаления всех системных сообщений достаточно присвоить любое значение переменной del_tg_system_messages (переменная может быть как константой проекта, так и переменной сделки) и дать боту разрешение на удаление сообщений.
Удаляются следующие виды системных уведомлений:
- Изменено название группы
- Изменена фотография группы
- Удалена фотография группы
- Закреплено сообщение
- Пользователь вступил в группу
- Пользователь вышел из группы
Если вы хотите удалять лишь избранные типы системных уведомлений, то вместо переменной del_tg_system_messages создайте переменную del_tg_chosen_messages и поместите в нее массив с типами уведомлений, которые нужно удалить, через запятую. Варианты системных уведомлений:
'new_chat_member' – пользователь вступил в группу,
'left_chat_member' – пользователь покинул группу,
'pinned_message' – закреплено сообщение,
'delete_chat_photo' – удалена фотография группы,
'new_chat_photo' – изменена фотография группы,
'new_chat_title' – изменено название группы
Например, для удаления всех видов, кроме вступления в группу вы добавляете в массив все виды, кроме того, что нужно оставить.
Важно!!! Удаление системных уведомлений не затронет коллбэки. Удалено будет только системное уведомление из диалога в Telegram
Last modified 1mo ago