Функції 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) показаній вище, платформа_id параметр передається з використанням лапок, які обрамляють числове значення:
tgmess = tg_send_message('1234566788', 'Hello!')
Як визначити кнопки в параметрі reply_markup
Приклад кнопок відповіді:
opts = {"keyboard": [[{"text": "Left"}, {"text": "Right"}]]}
Приклад інлайн-кнопок:
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')
Last updated