Як налаштувати вбудований пошук

Вбудований пошук — це спосіб швидко отримати інформацію з чат-бота. Ви можете створити меню з товарами чи послугами, яке буде показуватися за командою у пошуку. Також ви можете додати таке меню в сценарій вашого ланцюжка.

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

Активуйте вбудований режим у BotFather

Щоб вбудований пошук працював у чат-боті, потрібно активувати відповідну опцію в його налаштуваннях.

Відкрийте месенджер Telegram, увійдіть до вашого акаунту та знайдіть офіційний бот @BotFather.

Введіть команду /mybots та виберіть потрібний бот, якщо у вас їх декілька. Натисніть Bot Settings > Inline Mode.

Натисніть Turn on.

Створіть вбудований пошук

Ви можете створити вбудований пошук двома способами: у налаштуваннях бота або через джерело динамічних даних.

Через налаштування бота

Перейдіть у свій акаунт SendPulse та відкрийте бот Telegram.

Перейдіть в Налаштування бота (Bot settings) > Вбудовані пошуки (Inline search menu) та натисніть Додати вбудований пошук (Add inline search menu).

Напишіть ключове слово — назву команди, за якою в боті буде показуватись результат пошуку. Має містити тільки латинські букви до 256 символів. Також за цією назвою можна додавати вбудований пошук в ланцюжок.

Натисніть + Додати елемент (+ Add item) та заповніть необхідну інформацію.

Натисніть Додати (Add).

Після цього ви можете додати інші відповіді в меню, яке буде показуватись в чаті після введення команди. Для цього натисніть + Додати елемент (+ Add item) та введіть всю інформацію за аналогією, як робили до цього.

Можна додати до 50 елементів.

Праворуч ви зможете переглянути, як буде виглядати меню елементів для користувача.

Ви можете також використовувати змінні {{$['inline_element_title']}} та {{$['inline_element_description']}} для відображення назви та опису вибраного елемента в першому елементі ланцюжка.

Через джерело динамічних даних

Ви також можете додати вбудований пошук за допомогою джерела динамічних даних. Таким чином ви можете продовжити ланцюжок залежно від вибору користувача та передати ці дані у наступні блоки ланцюжка.

Спочатку додайте блок Запит API, який повертає у відповіді масив даних з результатами пошуку. Такий масив повинен мати наступний вигляд:

[
 {
   "inline_element_title": "Product 1 title",
   "inline_element_description": "Product 1 description",
   "inline_element_image": "https://example.com/jpeg_photo_url.jpg"
  },
  ...
]

Параметри даних пошуку:

Після блоку Запит API додайте елемент Повідомлення, додайте до нього кнопку Виклик вбудованого пошуку (Launch inline search) та виберіть опцію Вказати джерело динамічних даних для меню (Specify the source of dynamic data for the menu).

Щоб передати масив даних, що знаходиться у корені відповіді блоку Запит API, у полі вводу зазначте {{ $ }}. Якщо масив відповідей не знаходиться у корені відповіді запиту API, вкажіть шлях до масиву за допомогою JSONPath.

Ви можете передати до 50 елементів із джерела динамічних даних.

Наприклад, ви можете передати дані про вибраний підписником пункт результатів пошуку у наступний елемент. Для цього додайте шорткоди {{$['inline_element_title']}} та {{$['inline_element_description']}} до потрібного елемента.

Як використовувати вбудований пошук

Ви можете додати вбудований пошук у ланцюжку, який розгорне підписнику меню після натискання кнопки.

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

У ланцюжку

Перейдіть в конструктор ланцюжка чат-бота, в налаштуваннях якого ви додали вбудований пошук. Додайте елемент Повідомлення та виберіть з’єднуючий елемент Виклик вбудованого пошуку (Launch inline search). Введіть назву кнопки та виберіть вбудований пошук за назвою команди.

Після того, як користувач натисне кнопку в повідомленні — йому буде показано меню вбудованого пошуку.

У чатах

Якщо в чат-боті налаштовано вбудований пошук, то в чаті з поточним ботом, — як в групі, де цей бот доданий, так і в чатах з іншими користувачами — підписник може викликати його через @, а потім ввести команду.

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

Якщо підписник в груповому чи приватному чаті, то в чаті буде повідомлення з посиланням.

Коли інший учасник групи чи контакт натисне на посилання — він перейде в діалог з вашим ботом. За натисканням на Start запуститься ланцюжок, який ви додали в налаштуваннях меню для цього елементу.

Оновлено: 03.09.2024