Функции API Telegram

Рассказываем важные нюансы для работы с функциями API Telegram

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

Первоисточник: Telegram bot API

Важно!

Для понимания работы с функциями API настоятельно рекомендуем ознакомиться с правилами указания функций и параметров в калькуляторе.

ОБОЗНАЧЕНИЯ:

! - восклицательным знаком обозначаются обязательные параметры

параметр=None - так указывается значение по умолчанию для обозначенного параметра,

неправильно просто копировать текст функции из документации tg_send_message(platform_id, "Какой то текст", client_message_id=61818138, reply_markup=None, parse_mode=None, disable_web_page_preview=0, protect_content=False)

После знаков равно указаны значения по умолчанию для каждого параметра, следовательно, если Вам не нужен тот или иной параметр, но нужен какой-либо из последующих, то нельзя просто опустить его - следует указать вместо него значение по умолчанию для данного параметра.

Таким образом, правильным будет ввод: tg_send_message(platform_id, "Какой то текст", 61818138, None, None, 0, True)

Где взять platform_id для отправки уведомлений?

  • У вас должен быть подключен телерам-бот к проекту

  • В этого бота нужно прислать любое сообщение с того Telegram-аккаунта, куда должны приходить сообщения

  • В списке клиентов проекта выбираете диалог клиента, которому будете отправлять заявки

  • Копируете значение ID в мессенджере

Пример передачи параметра platform_id

  1. параметр platform_id можно передавать без указания числовых значений:

platform_id передан без указания значений

react = tg_set_reaction(platform_id, 1556, '👌')

Функции с параметром будет отрабатывать без указания значения platform_id.

Важно! Параметр в большинстве функций является обязательным и пропускать его нельзя.

  1. Если Вам необходимо использовать функцию в определенном чате, канале, группе, то понадобится передать platform_id с числовым значением:

В функции tg_send_message(!platform_id, !text) на примере выше параметр platform_id передан с помощью кавычек, в которых вложено числовое значение:

tgmess = tg_send_message('1234566788', 'Привет!')

Как прописывать кнопки в параметре reply_markup

Пример reply-кнопок:

opts = {"keyboard": [[{"text": "Налево"}, {"text": "Направо"}]]}

Пример inline-кнопок:

opts = {"inline_keyboard": [[{"text": "Пакет 1","callback_data":1}, {"text": "Пакет 2","callback_data":2}]]}

Как использовать разметку текста (markdown) в параметре parse_mode?

Параметр parse_mode выделяет весь текст/его часть курсивом или жирным шрифтом. Может иметь значения html, markdown, markdownV2.

  1. Если выбираете html:

для жирного шрифта используете "<b>caption</b>"

для курсива "<i>caption</i>"

  1. Для Markdown:

для жирного шрифта используете "*caption*"

для курсива "_caption_"

Пример отправки курсивного текста: tg_send_message(47615196, "<i>курсив</i>",None,None,"html")

Пример отправки жирного текста: tg_send_message(platform_id, '*test*', None, None, 'markdown')

PreviousПолучить полный вебхук (webhook) от TelegramNextФункции для работы с ботом

Last updated

Was this helpful?