Функції API значно розширюють можливості бота в Telegram. Використовуючи функції API, ви можете працювати з вкладеннями, групами та чатами в Telegram — наприклад, автоматизувати блокування або розблокування користувачів і багато іншого!
Джерело: Telegram bot API
Важливо!
Щоб зрозуміти, як працювати з функціями 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 можна передавати без явного вказання числових значень.
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"}]]}
Приклад інлайн-кнопок:
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')