Линия
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
Возможные колбэки:
line_follow — пользователь добавил бота в друзья / разблокировал его
line_sticker — был отправлен стикер
client_unsubscribed — пользователь заблокировал бота
line_join — бот был добавлен в групповой чат
line_leave — бот покинул групповой чат
line_memberJoined — в групповой чат добавился новый участник
line_memberLeft — участник покинул групповой чат
Каждое событие можно использовать для автоматизации — приветствий, триггеров и логирования.
Вложения LINE
LINE поддерживает три типа медиа:
изображения
видео
аудио/голосовые сообщения
Обратите внимание!
В LINE действует строгое ограничение: вы можете отправить не более 5 объектов за раз.
Каждое вложение считается одним объектом.
Текст сообщения тоже является отдельным объектом.
Набор кнопок — это ещё один отдельный объект.
Так что если вы отправляете медиа + текст + кнопки, учитывайте ограничение в 5 объектов .
Кнопки действий
Клавиатура (быстрые ответы)
Появляются над полем ввода. До 13 кнопок.
Кнопки в тексте
Отображаются под сообщением. До 4 кнопок, а текст сообщения может содержать до 160 символов.
Обратите внимание!
Доступные типы кнопок
По умолчанию
Кнопка-колбэк
Запрос геолокации (только клавиатура)
Подключение к группе
Чтобы ваш бот можно было добавлять в групповые чаты, нужно включить эту функцию в LINE Official Account Manager
Последнее обновление