Рассказываем важные нюансы для работы с функциями API Telegram
Функции API существенно расширяют возможности работы бота в Telegram. С помощью использования функций API можно работать с вложениями, с группами и чатами в Telegram, например, автоматизируя блокировку или разблокировку пользователей и многое другое!
Для понимания работы с функциями 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
параметр platform_id можно передавать без указания числовых значений:
platform_id передан без указания значений
react = tg_set_reaction(platform_id, 1556, '👌')
Функции с параметром будет отрабатывать без указания значения platform_id.
Важно! Параметр в большинстве функций является обязательным и пропускать его нельзя.
Если Вам необходимо использовать функцию в определенном чате, канале, группе, то понадобится передать platform_id с числовым значением:
В функции tg_send_message(!platform_id, !text) на примере выше параметр platform_id передан с помощью кавычек, в которых вложено числовое значение:
tg_callback_url_open(callback_query_id, url) – установка реакции на callback-кнопку с переходом в бота с тэгом
tg_chat_permission(platform_id, permission, media_permissions) – установка общих ограничений для обычных пользователей чата или отдельных пользователей
tg_pin_chat_message(platform_id, message_id, disable_notification) – как закрепить сообщение в чате/канале
tg_promote_user(platform_id, user_id, promote_options_list) - настройка прав пользователя / повышение до администратора в супер-группе или канале в Telegram
tg_reopen_forum_topic(platform_id, message_thread_id) – открыть ранее закрытую доп.тему
tg_restrict_chat_member(platform_id, user_id, minutes, permission, media_permissions) – установка персональных ограничений для обычных пользователей чата или для отдельных пользователей