LINE остается одной из самых популярных мессенджер-платформ в Азии. Интеграция с MaviBot открывает доступ к миллионам пользователей и позволяет автоматизировать общение с клиентами через один из ведущих мессенджеров региона.
Это руководство проведет вас через весь процесс настройки — от создания учетной записи LINE до подключения к MaviBot и отправки первых сообщений.
Подключение
Перед подключением LINE к MaviBot выполните следующие шаги настройки:
- Создайте LINE Business ID в LINE Business Center.
- Создайте LINE Official Account с помощью LINE Official Account Manager.
- Включите Messaging API в настройках вашего Official Account.
После включения Messaging API откройте Response settings и убедитесь, что Webhooks включены.
Важно
Webhooks должны быть включены. В противном случае LINE не будет отправлять события в MaviBot.
Channel ID и Channel Secret
Откройте раздел Messaging API в вашем LINE Official Account.
Там вы найдете два значения, необходимых для подключения бота:
- Channel ID
- Channel Secret
Эти учетные данные требуются при подключении LINE к MaviBot.
Подключение LINE к MaviBot
- Откройте раздел Messengers в MaviBot.
- Выберите LINE.
- Вставьте ваш Channel ID и Channel Secret.
- Нажмите Done.
Если учетные данные действительны, интеграция активируется немедленно.
Переменные клиента
Когда пользователь отправляет сообщение, MaviBot автоматически сохраняет следующие переменные клиента.
| Переменная | Описание |
|---|---|
line_source_type |
Тип беседы. Возможные значения: user (личный чат), group (групповой чат), room (устаревший групповой чат). |
line_quote_token |
Токен, используемый для ответа на конкретное сообщение. MaviBot всегда сохраняет токен последнего входящего сообщения. Может использоваться с line_send_message(). |
line_request |
Полная полезная нагрузка вебхука. Доступна только при включенной переменной save_webhook. |
latitude |
Широта, полученная, когда пользователь делится местоположением. |
longitude |
Долгота, полученная, когда пользователь делится местоположением. |
line_address |
Адрес в читаемом формате, полученный вместе с переданным местоположением. |
Эти переменные позволяют создавать гибкие сценарии чат-бота и персонализировать ответы.
Обратные вызовы LINE
MaviBot получает следующие обратные вызовы от LINE.
| Обратный вызов | Описание |
|---|---|
line_follow |
Пользователь добавил бота в друзья или разблокировал его. |
line_sticker |
Пользователь отправил стикер. |
client_unsubscribed |
Пользователь заблокировал бота. |
line_join |
Бот был добавлен в групповой чат. |
line_leave |
Бот покинул групповой чат. |
line_memberJoined |
Новый участник присоединился к групповому чату. |
line_memberLeft |
Участник покинул групповой чат. |
Эти обратные вызовы можно использовать для автоматизации, триггеров, приветственных сообщений, уведомлений и логирования.
Вложения
LINE поддерживает следующие типы вложений:
- Изображения
- Видео
- Аудио и голосовые сообщения
Обратите внимание
LINE допускает максимум 5 объектов в одном сообщении.
Каждый из следующих элементов считается одним объектом:
- одно медиавложение;
- текст сообщения;
- набор кнопок.
Если ваше сообщение содержит текст, медиа и кнопки, убедитесь, что общее количество объектов не превышает пяти.
Кнопки
Клавиатура (быстрые ответы)
Отображается над полем ввода сообщения.
- Максимум: 13 кнопок
Кнопки в тексте
Отображаются под текстом сообщения.
- Максимум: 4 кнопки
- Максимальная длина сообщения: 160 символов
Доступные типы кнопок
- Обычная
- Callback
- Запрос геолокации (только для кнопок быстрых ответов)
Подключение бота к группе
Чтобы разрешить добавление бота в групповые чаты, включите эту опцию в LINE Official Account Manager.
