База знань GetMyBot

Повідомлення та кнопки

Як скласти відповідь бота: текст, фото, кнопки під повідомленням і запитання зі збереженням відповіді.

На цій сторінці

Щоб бот надіслав текст, фото й кнопку «Вибрати», додайте дію «Надіслати повідомлення». Відповідь складається з окремих частин, блоків. Наприклад, спочатку фото товару, потім опис із кнопками під ним. Кнопки під повідомленням також називаються inline-кнопками.

У тій самій дії можна поставити запитання й дочекатися відповіді. Наприклад, запитати номер телефону та зберегти його в картці клієнта. Нижче описані блоки, кнопки й налаштування запитань.

Блоки повідомлення

Натисніть Додати блок і виберіть, що надіслати. Блоки можна поєднувати: текстове привітання, фото та файл із програмою заняття.

  • Текст: форматований текст до 4096 символів із підстановками та кнопками.
  • Фото: зображення з підписом.
  • Файл: документ із підписом.
  • Голосове: аудіо (OGG/OPUS, MP3, M4A, до 50 МБ), яке Telegram показує як голосове повідомлення (sendVoice).
  • GIF: анімація або MP4 без звуку, до 50 МБ (sendAnimation).
  • Відеокружечок: квадратне MP4 до 60 секунд (sendVideoNote). Підпису в нього немає. Під час кожного надсилання файл із медіатеки завантажується заново: Telegram не приймає для sendVoice, sendAnimation чи sendVideoNote ідентифікатор file_id, отриманий іншим способом.
  • Карусель: від 2 до 10 карток «фото + підпис + власні кнопки». У Telegram картки гортаються кнопками «‹ ›» в одному повідомленні через editMessageMedia, лише якщо для кожного фото доступний придатний file_id: заданий у картці або отриманий для файлу з медіатеки. Якщо хоча б для одного фото отримати такий ID не вдалося, усі картки надсилаються окремими повідомленнями з фото. Так само вони надсилаються в інших каналах, наприклад VK. Підпис і кнопки кожної картки зберігаються.
  • Затримка: пауза в секундах перед наступним блоком.
  • ШІ: відповідь, створена моделлю за промптом.
  • Реакція: виклик іншої реакції, за потреби з очікуванням її виконання.

Голосові, GIF, відеокружечки й каруселі працюють у реакціях як інші блоки та потрапляють до швидкої розсилки реакції (див. Розсилки).

Блоки можна перетягувати. Режим показу: «За порядком» або «Випадково» для різних варіантів відповіді. Головне меню бота можна залишити без змін, задати нове або приховати.

Параметри блока

Текстові й медіаблоки мають прапорці: закріпити, без звуку, захист від пересилання, спойлер, без попереднього перегляду посилань, автовидалення через N секунд.

Inline-кнопки

У блоці налаштовують кнопки (Текст кнопки + Тип):

  • Текст: надсилає напис як відповідь користувача. У Telegram і VK це клавіатура відповіді: натискання може відповісти на запитання або запустити реакцію за текстом. У WhatsApp, Instagram, Messenger і вебвіджеті використовується кнопка відповіді без постійної клавіатури.
  • Посилання: відкриває URL.
  • Вебзастосунок: відкриває Telegram Mini App. Див. Mini App.
  • Виклик реакції: натискання запускає іншу реакцію.
  • Inline-запит: вставляє «@бот запит» у поле вводу поточного чату або пропонує вибрати інший чат (switch_inline_query/switch_inline_query_current_chat). Працює лише в Telegram після ввімкнення inline-режиму через /setinline в @BotFather. GetMyBot не відповідає на такі запити (answerInlineQuery не реалізовано), тому кнопка лише готує текст запиту, але не виконує пошук.
  • Заготовлений текст: кнопка-посилання на https://t.me/<бот>?text=… відкриває чат із ботом і поміщає текст у поле вводу, нічого не надсилаючи (prefill).
  • Посилання на оплату: відкриває обов’язковий платіжний URL. Сам платіж створюється дією «Створити платіж». Це перехід на зовнішню сторінку оплати, а не вбудований рахунок Telegram.
  • Сповіщення: показує текст після натискання, не запускає реакцію й не передає збережені дані кнопки (Carry). У Telegram це коротке сповіщення або спливне вікно до 200 символів, у VK – коротка плашка до 90 символів без вікна.

Текст або заготовка

ЗавданняТип і налаштуванняРезультат натискання
Вибрати «Так» в анкеті«Текст», напис «Так»; повідомлення має чекати відповідіВідповідь «Так» передається кроку діалогу
Підготувати звернення«Заготовлений текст», напис «Написати», текст «Хочу зробити замовлення»У полі вводу чату з ботом з’являється чернетка; користувач редагує й надсилає її сам

Напис на кнопці й заготовлений текст – різні поля. Заготовка сама не надсилає повідомлення й не запускає реакцію.

У кнопки «Виклик реакції» натискання передається боту окремою подією. У технічному описі це називається callback. Для «Inline-запиту» та «Заготовленого тексту» такої події немає: вони діють у застосунку Telegram, тому не підтримують ні відповідь answerCallbackQuery, ні передачу даних Carry.

Іконка й колір кнопки

Перед текстом кнопки можна показати преміум-емодзі. У полі іконки вкажіть його ID (icon_custom_emoji_id), додатне 64-бітне ціле число. Наприклад, 007 читається як 7. Літери, нуль, від’ємне або надто велике число відкидаються: кнопка збережеться без іконки.

Telegram показує таку іконку лише ботам із потрібними правами: додатковим іменем через Fragment або Telegram Premium у власника за прямого надсилання в особистий чат чи групу. Для решти Telegram ігнорує іконку, не замінюючи її звичайним емодзі.

Стиль задає колір: «Звичайна» без кольору, «Основна» синя, «Успіх» зелена, «Небезпечна» червона. Технічне поле називається style.

«Одноразова» (single_use) дозволяє використати збережені дані кнопки лише раз. Це корисно, наприклад, для підтвердження вибору. Зміну напису й видалення повідомлення налаштовують окремо, у поведінці після натискання.

Прапорці кнопок

Прапорець – додаткове налаштування, яке вмикають або вимикають галочкою. У редакторі є:

  • З нового рядка: переносить кнопку в наступний ряд.
  • Розтягнути на всю ширину: розміщує кнопку в окремому ряду; наступна кнопка також починає новий ряд.

Схема вигляду (квадратні дужки позначають кнопки):

Один ряд:          [Каталог] [Допомога]

З нового рядка:    [Каталог]
                   [Допомога]

На всю ширину:     [         Допомога         ]

Ряди й кольори доступні в Telegram та VK. Розташування за рядами зберігається після повторного відкриття й редагування. Преміум-емодзі Telegram доступні тільки за сумісного підключення. Перемикача «Відкривати всередині Telegram» немає: Bot API не дозволяє керувати цим через такий прапорець.

Обмеження каналів

Виберіть підключення для блока чи окремої кнопки. Для «Всіх каналів» редактор використовує спільні можливості. Непідтримуваний тип не можна зберегти.

  • Telegram: URL, Mini App, реакція, сповіщення/alert, ряди, кольори й custom emoji (за наявності прав у бота).
  • VK: URL, реакція, snackbar, ряди й кольори. VK Mini App та VK Pay доступні лише за вибору сумісного VK-підключення.
  • WhatsApp: одна URL-кнопка CTA без інших кнопок у тому самому повідомленні. Кнопок відповіді може бути до 3 звичайних, від 4 до 10 показуються списком. Напис – до 20 символів. Ряди, кольори, Mini App і сповіщення недоступні.
  • Instagram / Messenger: поточний адаптер передає лише кнопки відповіді (quick replies), напис до 20 символів. URL, Mini App, сповіщення, ряди й кольори не підтримуються.
  • Вебвіджет: URL і кнопки відповіді, без рядів, кольорів та сповіщень.
  • Email: посилання, зокрема посилання на оплату; кнопки відповіді й сповіщення недоступні.

Для кнопок зі списку кількість колонок можна вказати лише в каналах, що підтримують ряди. В інших каналах розміщення вибирає сам канал. Ліміти кількості кнопок і довжини написів перевіряються під час надсилання.

Поведінка після натискання

Для кнопок, що передають натискання боту, можна замінити повідомлення текстом або вмістом іншої реакції, видалити повідомлення, поставити мітку чи зберегти параметр, якщо канал підтримує відповідну дію. Заміна тексту самої кнопки після натискання доступна лише в Telegram: наприклад, «Записатися» на «Вибрано». Підтримка редагування повідомлень у VK не означає підтримку зміни напису кнопки.

Telegram чекає підтвердження натискання від бота через answerCallbackQuery. Зазвичай GetMyBot надсилає його сам і прибирає індикатор завантаження на кнопці. Налаштування «Пропустити answerCallbackQuery» вимикає підтвердження.

У полі «Текст при натисканні» кнопки «Реакція» можна написати коротке підтвердження, наприклад «Заняття вибрано» (Telegram: до 200 символів, VK: до 90; підстановки працюють). Зазвичай Telegram ненадовго показує його поверх чату. Прапорець «Показувати як спливне вікно» працює лише в Telegram і відкриває вікно з підтвердженням (answerCallbackQuery із show_alert). Якщо текст порожній, бот тільки прибере індикатор завантаження. Якщо ввімкнено «Пропустити answerCallbackQuery», ні текст, ні вікно не надсилаються.

Дані в кнопці (Carry)

Carry допомагає кнопці запам’ятати, до чого вона належить. Наприклад, і пальто, і сукня мають кнопку «Купити». Для першої збережіть product_id=101, для другої product_id=102. Після натискання кнопки сукні наступна реакція отримає {{ctx.product_id}} зі значенням 102.

У редакторі це налаштування називається «Дані при натисканні». Ключ задає назву значення, а саме значення може бути числом, текстом чи підстановкою. Бот запам’ятовує його під час надсилання повідомлення, а після натискання поміщає в тимчасові дані реакції (ctx). Значення кожної кнопки зберігаються окремо.

Строк дії (ttl_seconds, TTL) задається в секундах: 3600 означає годину. 0 вибирає строк за замовчуванням, 30 днів. Після закінчення строку дані недоступні. «Одноразова» (single_use) видаляє дані вже після першого натискання. Збережена ціна не оновлюється сама після зміни каталогу: перед оплатою перевіряйте її за ID товару.

Покрокове налаштування й відмінність від постійних параметрів: Динамічні кнопки й параметри.

Динамічні кнопки

Якщо товари чи заняття вже є у списку, не додавайте кнопки вручну. Блок «Динамічні кнопки зі списку» створює по кнопці для кожного елемента. Укажіть, де список лежить у ctx, як назвати один елемент (псевдонім), скільки кнопок розмістити в ряд і який вигляд має шаблон. Наприклад, {{item.name}} підставить назву чергового товару. Докладніше: Динамічні кнопки й параметри.

Преміум-емодзі в тексті

У текстовому блоці кнопка форматування «Преміум-емодзі» вставляє <tg-emoji emoji-id="…">🙂</tg-emoji>: у користувачів Telegram Premium замість запасного емодзі в тегу з’явиться кастомний, у решти – запасний емодзі. Працює і в HTML-, і в Markdown-форматі блока. ID емодзі – число до 32 цифр; дізнатися його можна через getCustomEmojiStickers або переслати повідомлення з потрібним емодзі боту на кшталт @idstickerbot.

Посилання на бота й заготовлений текст

Посилання t.me/<бот>?start=<параметр> запускає команду /start <параметр> у Telegram. Відкрити чат із параметром, але без /start, через таке посилання не можна. Виберіть потрібний варіант:

  • Тихий /start: у реакції на тригер «Команда /start» із потрібним значенням Мітка в посиланні запуску дію «Надіслати повідомлення» можна залишити без блоків. Помітної відповіді на сам /start не буде, а мітка вже доступна в контексті події, щоб використати її в умовах та інших діях цієї реакції.
  • Заготовлений текст: посилання https://t.me/<бот>?text=<текст> (кнопка «Заготовлений текст» або звичайна кнопка-посилання) відкриває чат і кладе текст у поле вводу, нічого не надсилаючи. /start при цьому не спрацьовує; повідомлення надсилає сам користувач.
  • Автоматичне повідомлення «від імені користувача» після переходу через Bot API неможливе: бот не може надіслати повідомлення від імені людини. Найближчий варіант – deep-link ?start= і реакція, яка сама відповість потрібним текстом від бота.

Очікувана відповідь (кроки діалогу)

Текстовий блок може чекати відповіді користувача. Повідомлення тоді стає кроком діалогу й призупиняє сценарій до відповіді. Кілька послідовних кроків утворюють анкету чи майстер прямо в чаті.

Тип очікуваного вмісту

Бот може чекати певний вид відповіді: текст, вибір із варіантів (кнопки-варіанти), фото, відео, відеозамітку, аудіо, документ, голосове, геолокацію, контакт, календар або кубик. Якщо користувач надішле інший тип, крок вважатиме відповідь невідповідною.

Перевірка тексту

Для текстової відповіді можна ввімкнути перевірку: телефон, e-mail, посилання, дату, час або відповідність формулі. Наприклад, якщо очікується телефон, довільний текст не буде прийнято й бот покаже повідомлення про помилку. Перевірка формулою використовує розширену формулу, що повертає порожній текст у разі успіху та текст помилки в разі відмови.

Збереження відповіді

Відповідь користувача можна зберегти в параметр. Після цього вона доступна в підстановках як {{param.ключ}} та в умовах. Так кроки діалогу наповнюють невеликий профіль клієнта.

Помилки, нагадування та таймаут

  • Повідомлення при помилці перевірки: що показати, якщо відповідь не пройшла перевірку.
  • Нагадування: що надіслати, якщо користувач мовчить.
  • Скасування очікування за таймаутом: через скільки перестати чекати; після таймауту можна запустити реакцію, наприклад м’яко завершити анкету. Цю реакцію показано у зв’язках як «Таймаут очікування», а реакцію на саму відповідь – як «Очікувана відповідь».

Вихід із кроку командою

/cancel або російське слово «отмена» знімають очікування й відповідають «Отменено.» (або запускають реакцію скасування, якщо її задано). Інші команди за замовчуванням вважаються відповіддю та проходять перевірку, як звичайний текст. Якщо ввімкнути «Команди бота (наприклад, /start) переривають очікування» (escape_on_command), будь-яка команда, наприклад /start посеред анкети, мовчки скасує очікування й виконається як звичайно.

Підстановки

Кнопка «Підстановки» вставляє змінні: дані відправника ({{first_name}}, {{username}}, {{user_id}}), події ({{text}}, {{chat_id}}, {{datetime}}) і параметри ({{param.ключ}}). Повний перелік та формули: Підстановки та формули.

Кнопка меню бота

Дія Menu button вибирає звичайне меню бота, команди або кнопку Mini App із текстом та URL. Область дії: поточний чат або загальне налаштування бота. Наприклад, можна задати персональну Mini App лише поточному клієнтові. Доступність залежить від можливостей каналу.

Що далі