Функции API Telegram
Функции API значительно расширяют возможности бота в Telegram. Используя функции API, вы можете работать с вложениями, группами и чатами в Telegram — например, автоматизировать блокировку или разблокировку пользователей и многое другое!
Источник: API бота Telegram
Важно!
Чтобы понять, как работать с функциями API, мы настоятельно рекомендуем ознакомиться с правилами указания функций и параметров в калькуляторе.
ОБОЗНАЧЕНИЯ:
! — восклицательный знак указывает на обязательные параметры
parameter=None — это показывает значение по умолчанию для указанного параметра.
Достаточно неправильно просто скопировать текст функции из документации, например так: tg_send_message(platform_id, "Some text", client_message_id=61818138, reply_markup=None, parse_mode=None, disable_web_page_preview=0, protect_content=False)
Значения после знаков равенства представляют значения по умолчанию для каждого параметра. Поэтому, если вам не нужен какой-то параметр, но нужен следующий за ним, нельзя просто пропустить ненужный — вместо этого нужно явно передать его значение по умолчанию.
Таким образом, правильным использованием будет: tg_send_message(platform_id, "Some text", 61818138, None, None, 0, True)
Где мне взять platform_id для отправки уведомлений?
Вам нужно, чтобы к вашему проекту был подключён бот Telegram.
Отправьте любое сообщение этому боту из аккаунта Telegram, на который вы хотите получать уведомления.
В списке клиентов проекта выберите диалог с клиентом, которому хотите отправлять запросы.
Скопируйте значение ID из поля мессенджера.
Пример передачи platform_id параметра:
Параметр platform_id можно передавать без явного указания числовых значений.
react = tg_set_reaction(platform_id, 1556, '👌')
Функции с этим параметром будут работать даже без явного указания значения platform_id. Важно: в большинстве функций этот параметр обязателен и не должен опускаться.
2. Если вам нужно использовать функцию в конкретном чате, канале или группе, вы должны передать platform_id в виде числового значения.
В функции tg_send_message(!platform_id, !text) показанной выше, platform_id параметр передаётся в кавычках, заключающих числовое значение:
tgmess = tg_send_message('1234566788', 'Hello!')
Как задавать кнопки в параметре reply_markup
Пример кнопок ответа:
opts = {"keyboard": [[{"text": "Left"}, {"text": "Right"}]]}
Пример inline-кнопок:
opts = {"inline_keyboard": [[{"text": "Package 1","callback_data":1}, {"text": "Package 2","callback_data":2}]]}
Как использовать форматирование текста (Markdown) в параметре parse_mode?
Текст parse_mode параметр форматирует весь текст или его части в курсив или жирный. Он может принимать значения: html, markdown или markdownV2.
Если вы выберете html:
числовых жирный текст, используйте "<b>caption</b>"
числовых курсивный текст, используйте "<i>caption</i>"
Для Markdown:
числовых жирный текст, используйте "*caption*"
числовых курсивный текст, используйте "_caption_"
Пример отправки курсивного текста:
tg_send_message(47615196, "<i>italic</i>",None,None,"html")
Пример отправки жирного текста:
tg_send_message(platform_id, '*test*', None, None, 'markdown')
Последнее обновление