Функції для надсилання та редагування повідомлень

Розглянемо простий приклад з набором обов'язкових параметрів:

platform_id вказує ідентифікатор конкретного клієнта.

Подивіться той самий приклад, але з використанням змінних:

У цьому прикладі змінна soob міститиме відповідь сервера після надсилання повідомлення.

Якщо ви збережете message_id з отриманої відповіді, це дозволить вам пізніше працювати з цим повідомленням (редагувати, видаляти, пересилати, коментувати).

Часто виникають труднощі при використанні всіх параметрів. Розглянемо наступний приклад:

• Спочатку оголосіть усі параметри, що використовуються у функції. Пам'ятайте, параметри можна передавати не лише як значення, але й як змінні, що часто зручніше та зрозуміліше. Змінні, такі як platform_id та client_message_id, можна отримати з картки профілю клієнта.
  platform_id — ID клієнта Telegram, якому потрібно надіслати повідомлення *\ >Ми відповімо в тому ж чаті, де пише клієнт

  text - текст повідомлення. \ >Використовуємо форматування тексту - наприклад, виділення жирним.

  client_message_id - ID повідомлення, яке потрібно процитувати\ >У чатах ця змінна отримує своє значення автоматично.
  reply_markup — налаштування кнопок **. \ >Призначимо її змінній opts.
  parse_mode — Форматування тексту жирним і курсивом в описі ***. Може мати значення html, markdown, markdownV2. Символи, що використовуються для форматування тексту повідомлення, описані тут. \ >Використаємо markdown.
  disable_web_page_preview - Показувати попередній перегляд посилання. Щоб вимкнути, передайте 1; інакше передайте 0 або залиште порожнім "".\ >Ми можемо передати будь-яке значення, оскільки текст повідомлення не містить посилання.
  protect_content — Прапорець захисту вмісту. Передайте будь-яке значення, крім 0, False або '', щоб увімкнути.\ >Нам не потрібен захист вмісту, тому передамо порожній рядок ''.
  disable_notification — Прапорець звукового сповіщення (за замовчуванням: 0). Передайте 1, щоб вимкнути сповіщення, 0 — щоб увімкнути.\ >Сповіщення — це спливаюче вікно з текстом повідомлення. Увімкнемо його.

• Далі збираємо функцію. Не забудьте призначити функцію змінній — це дозволить відстежувати статус надсилання повідомлення.

Ось що ми отримали:

Після того, як клієнт надішле нам ключове слово test, ми відповідаємо, цитуючи його повідомлення.

У ok ми бачимо статус надсилання; далі йде інформація про саме повідомлення — його ID, дані відправника та вміст.

Приклад з параметром entities

Ви можете зберігати оригінальний рядок у змінній, як показано нижче:

text = "qwert asdfg zxcvb poiuy lkjhg 12345"

Параметр слід записувати як словник з даними та вказати бажане форматування, зазначивши шрифти:

entities = [{"offset":0,"length":5,"type":"bold"},{"offset":6,"length":4,"type":"text_link","url":"`` https://mavibot.ai"},{"offset":11,"length":9,"type":"strikethrough"},{"offset":21,"length":6,"type":"spoiler"},{"offset":29,"length":12,"type":"code"}]

Передайте параметр останнім у функції, яку ви використовуєте. Параметр можна передавати як функції tg_send_message, так і tg_send_message_1:

x = tg_send_message(platform_id, text, None, None, None, False, False, False, None, entities)

Приклад передачі параметра:
entities = [{"offset":0,"length":5,"type":"bold"},{"offset":6,"length":4,"type":"text_link","url":"https://mavibot.ai"},{"offset":11,"length":9,"type":"strikethrough"},{"offset":21,"length":6,"type":"spoiler"},{"offset":29,"length":12,"type":"code"}]

У прикладі показано лише словник, тоді як текст самого повідомлення призначається окремій змінній.

Приклад коду для копіювання:

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

Приклад у калькуляторі:

Детальний приклад роботи з функціями Telegram API для редагування повідомлень ви можете знайти нижче.

Приклад 1

/*Зручно попередньо визначити текст у змінній*/
text='Пишу-пишу-пишу текст'
/*Функція надсилання повідомлення*/
soob=tg_send_message(platform_id, text)
/*Зберегти ID надісланого повідомлення*/
soob_id=soob['result']['message_id']

Приклад 2

id_group=-1001847103100
text='Тестування надсилання повідомлення через метод API. Наприклад, *жирний текст*'
opts = {"inline_keyboard": [[{"text": "👍","callback_data":1}, {"text": "👎","callback_data":2}]]}
disable_web_page_preview=1
protect_content=''
disable_notification=1
parse_mode='markdown'
soob=tg_send_message(id_group, text,client_message_id, opts, parse_mode, disable_web_page_preview, protect_content, disable_notification) 

Отже, надішлемо собі повідомлення з вбудованою клавіатурою:

Далі відредагуємо текст повідомлення:

І відредагуємо кнопки:

Спробуємо відредагувати повідомлення із зображенням. Для цього надішліть повідомлення із зображенням і збережіть ID надісланого повідомлення. Детальні інструкції про те, як отримати URL зображення, читайте тут:

Тепер відредагуємо зображення та його опис:

/*Зручно попередньо визначити параметри у змінній.*/
text='Який пакет ви хотіли б обрати?'
opts = {"inline_keyboard": [[{"text": "Пакет 1","callback_data":1}, {"text": "Пакет 2","callback_data":2}]]}
/*Функція надсилання повідомлення*/
soob=tg_send_message(platform_id, text, None, opts)
/*Зберегти ID надісланого повідомлення*/
soob_id=soob['result']['message_id']

/*Редагувати повідомлення*/
text='Який пакет вас цікавить?'
tg_edit_message_text(platform_id, soob_id, text, opts)  

/*Редагувати вбудовану клавіатуру*/
opts = {"inline_keyboard": [[{"text": "Стандартний","callback_data":1}, {"text": "Преміум","callback_data":2}]]}
tg_edit_message_reply_markup(platform_id, soob_id, opts)


/*Надіслати зображення з описом*/
soob=tg_send_photo(platform_id, "AgACAgIAAxkBAAIPpWO4T7jhOgYHq6uR8rjnq9rIvBs-AAJlwDEb5fHASaGdhzgWjyn7AQADAgADeAADLQQ", "Це зображення")
/*Зберегти ID надісланого повідомлення*/
soob_id=soob['result']['message_id']

/*Редагувати зображення*/
media='{"type": "photo", "media": "AgACAgIAAxkBAAIPrmO4UiH7Tazqn-3IbFVzPKNsVEZmAAJ1wDEb5fHASWcNXKah-egvAQADAgADeQADLQQ"}'
tg_edit_message_media(platform_id, soob_id, media)
/*Редагувати опис зображення*/
tg_edit_message_caption(platform_id, soob_id, 'Це Я!')

Надішлемо повідомлення та збережемо його ID.

І скопіюємо раніше надіслане повідомлення.

/*Зручно попередньо визначити параметри у змінній.*/
text='Який пакет ви хотіли б обрати?'
opts = {"inline_keyboard": [[{"text": "Пакет 1","callback_data":1}, {"text": "Пакет 2","callback_data":2}]]}
/*Функція надсилання повідомлення*/
soob=tg_send_message(platform_id, text, None, opts)
/*Зберегти ID надісланого повідомлення*/
soob_id=soob['result']['message_id']


/*Скопіювати надіслане повідомлення*/
tg_copy_message('5081438490', '1840834360', soob_id, None, opts, None, None, 1)