Лінія
LINE і далі залишається одним із найпопулярніших месенджерів в Азії, тож додавання його до MaviBot відкриває доступ до величезної бази користувачів. Ось простий покроковий посібник, який проведе вас від налаштування до перших повідомлень.
Підключення
Щоб успішно налаштувати інтеграцію, вам потрібно виконати кілька обов’язкових кроків:
Business ID — створюється в LINE Business Center
LINE Official Account — створюється через LINE Official Account Manager.
Messenger API — вам потрібно увімкнути її в налаштуваннях вашого Official Account.
Після цього перейдіть до розділу налаштувань відповіді та переконайтеся, що Webhooks увімкнено — без цього LINE не зможе надсилати події до MaviBot.
Channel ID і Channel Secret
Перейдіть до розділу Messaging API — саме там розташовані два ключові параметри.
Channel ID
Channel Secret
Вони потрібні для підключення вашого бота до MaviBot.
Підключення LINE до MaviBot
Тепер перейдемо до підключення LINE до MaviBot:
Відкрийте Channels розділ у MaviBot.
Виберіть LINE.
Вставте ваші Channel ID та Channel Secret.
Натисніть Готово.
Якщо дані правильні, бот підключиться миттєво.
Змінні
Коли користувач надсилає повідомлення вашому боту, MaviBot автоматично зберігає ключові дані в змінних:
line_source_type — може бути одним із трьох типів: user (прямий чат), group (груповий чат), room (застарілий тип групового чату).
line_quote_token — токен для відповіді на конкретне повідомлення. MaviBot завжди зберігає токен із останнього вхідного повідомлення. Може використовуватися в
line_send_message().line_request — повний webhook payload, збережений, коли змінну
save_webhookувімкнено.latitude, longitude — координати, збережені, коли користувач надсилає геолокацію.
line_address — читабельна адреса, збережена, коли користувач ділиться місцезнаходженням.
Ці змінні дають змогу будувати гнучкі сценарії та надсилати максимально персоналізовані відповіді.
Які події LINE надсилає до MaviBot
Можливі callback-и:
line_follow — користувач додав бота в друзі / розблокував його
line_sticker — було надіслано стікер
client_unsubscribed — користувач заблокував бота
line_join — бота було додано до групового чату
line_leave — бот вийшов із групового чату
line_memberJoined — новий учасник приєднався до групового чату
line_memberLeft — учасник залишив груповий чат
Кожну подію можна використовувати для автоматизації — привітань, тригерів і логування.
Вкладення LINE
LINE підтримує три типи медіа:
зображення
відео
аудіо/голосові повідомлення
Зверніть увагу!
У LINE діє суворе обмеження: ви можете надсилати не більше 5 об’єктів одночасно.
Кожне вкладення рахується як один об’єкт.
Текст повідомлення також є окремим об’єктом.
Набір кнопок — це ще один окремий об’єкт.
Тож якщо ви надсилаєте медіа + текст + кнопки, пам’ятайте про обмеження у 5 об’єктів .
Кнопки дій
Клавіатура (швидкі відповіді)
Відображаються над полем введення. До 13 кнопок.
Кнопки в тексті
Відображаються під повідомленням. До 4 кнопок, а текст повідомлення може містити до 160 символів.
Зверніть увагу!
Доступні типи кнопок
За замовчуванням
Кнопка callback
Запит геолокації (лише клавіатура)
Підключення до групи
Щоб дозволити додавати вашого бота до групових чатів, потрібно увімкнути цю функцію в LINE Official Account Manager
Останнє оновлення