Що таке інлайн-режим у Telegram?
Окрім того, що бот може відповідати на будь-які запити безпосередньо в особистому чаті або групі, за допомогою інлайн-режиму ви можете отримати глобальний доступ до бота в чаті, групі або каналі.
Щоб зв'язатися з ботом, у якого ввімкнено інлайн-режим, просто введіть @*ім'я бота* у полі Повідомлення.
Найяскравішим і найпопулярнішим прикладом роботи бота в інлайн-режимі є @gif, за допомогою якого можна вибрати та надіслати gif-зображення:
Бот @gif працюватиме в будь-якому чаті.
Як увімкнути інлайн-режим?
Щоб бот працював в інлайн-режимі, потрібно ввімкнути цю опцію в налаштуваннях бота в BotFather.
Виберіть потрібного бота та перейдіть до Bot Settings.
Потім оберіть Inline Mode
Тут потрібно ввімкнути інлайн-режим, якщо він ще не ввімкнений.
Як змінити плейсхолдер?
За бажанням ви можете змінити плейсхолдер, який відображається перед введенням пошукового запиту. За замовчуванням це Search…
Щоб змінити його, натисніть кнопку Edit Inline Placeholder:
Вкажіть точний вміст плейсхолдера.
Як налаштувати виведення результатів
Після натискання на опцію зі списку в інлайн-режимі буде надіслано повідомлення, яке вказане в заголовку вибраної опції, і ви можете налаштувати реакцію у воронці на це значення.
Щоб вказати дані для виведення в інлайн-режимі, потрібно задати змінну inline_bot. В інлайн-режимі пошук значень у змінній inline_bot відбувається майже в реальному часі.
Дані у змінній можна вказати трьома способами. Розглянемо від найпростішого до максимальних налаштувань.
Масив із текстовими даними
Наприклад, пошук відбуватиметься по масиву товарів.
Змінна inline_bot вказується в налаштуваннях проєкту. Пошук збігається з будь-яким варіантом масиву, який містить введену фразу.
Коли ви вводите '@ім'я__вашого__бота' та початкові літери команд, відкривається меню зі значеннями, які ви вказали в змінній проєкту.
Після натискання на потрібний пункт боту буде надіслано повідомлення від користувача, на яке ви можете налаштувати реакцію в боті.
Налаштування блоку виглядає так:
Приклад даних:
["Milk", "Bread", "Pasta", "Chocolate", "Eggs", "Butter", "Bun", "Tea", "Vegetables", "Fruit"]
Виведення за відсутності фільтрації
Ви можете встановити порожній ключ і призначити йому масив значень у нижньому регістрі або масив словників. Бот звертатиметься до словника за порожнім ключем і виводитиме кнопки зі значеннями з призначеного масиву.
Інлайн-кнопка з вказаним значенням пошуку
Зверніть увагу!
Інлайн-кнопки в Telegram не є колбеками.
Якщо вам потрібно отримувати колбеки, прочитайте про колбек-кнопки в Telegram.
Кнопка працює лише в Telegram.
Щоб встановити пошукову фразу, додайте параметр inline_query до інлайн-кнопки зі значенням, яке автоматично вставляється в запит.
Рекомендується використовувати цю опцію для інлайн-режиму, оскільки це дозволить уникнути помилок і працювати швидше.
Наприклад, додайте три кнопки, які відповідають прикладу з попереднього розділу.
[{"line":0,"index_in_line":0,"text":"Show the menu","type":"inline","inline_query":"menu"},{"line":0,"index_in_line":1,"text":"Статьи","type":"inline","inline_query":"posts"},{"line":2,"index_in_line":0,"text":"List of products","type":"inline","inline_query":"products"}]
Коли ви натискаєте кнопку, наприклад, Стаття, відобразиться знайдений список кнопок (при додаванні ви вказали "inline_query":"posts" для цієї кнопки):
Варіанти беруться із заданої змінної, як описано вище в розділі "Словник зі списком":
Примітки
- Змінна inline_bot може бути задана не лише в загальних змінних, але і як проста змінна, однак у цьому випадку її значення має бути взяте в одинарні лапки.
Приклад у полі калькулятора:
inline_bot = '["Milk", "Bread", "Pasta", "Chocolate", "Eggs", "Butter", "Puff Pastry", "Tea", "Vegetables", "Fruits", "#{aa}"]'
Ви також можете передати будь-яке значення як змінну для більш гнучкого налаштування.
Наприклад, простий варіант у масиві:
