Сервисные сообщения LINE и Messaging API: что выбрать для MINI App
Сервисные сообщения LINE и сообщения Messaging API решают разные задачи. Сервисное сообщение подходит, когда проверенное LINE MINI App подтверждает действие внутри приложения — например, бронирование или отправку заказа. Messaging API нужен для ответов, гибких push-сообщений и рассылок от LINE Official Account. Ни один вариант не является расширенной версией другого.
Главное
- Сервисное сообщение — транзакционное уведомление, связанное с действием пользователя в MINI App; реклама, купоны, продвижение товаров и посторонние анонсы запрещены.
- Messaging API относится к LINE Official Account и поддерживает reply, push, multicast, narrowcast и broadcast.
- Для сервисного сообщения в production нужны проверенное MINI App, одобренный шаблон и привязанный к пользователю service notification token.
- Сервисное сообщение появляется в региональном чате уведомлений MINI App и может прийти пользователю, который не добавил связанный Official Account в друзья.
- Если нужны и транзакционные обновления, и свободный диалог поддержки, разделите маршруты и связывайте их собственным ID бронирования или заказа.
Чем сервисные сообщения LINE отличаются от Messaging API
Официальное руководство по сервисным сообщениям определяет их как подтверждение или результат действия пользователя в LINE MINI App. Официальное руководство Messaging API описывает сообщения бота, подключённого к LINE Official Account. Эта продуктовая граница важнее общего слова «сообщение».
| Критерий | Сервисное сообщение LINE MINI App | Сообщение LINE Messaging API |
|---|---|---|
| Основная цель | Подтвердить действие в MINI App, сообщить результат или напомнить о нём | Ответить пользователю или отправить сообщение от Official Account одному или многим получателям |
| Триггер | Допустимое действие пользователя внутри MINI App | Событие пользователя для reply либо решение приложения для других способов отправки |
| Получатель | Пользователь, привязанный к service notification token | Пользователь, группа, групповой чат, аудитория или друзья Official Account — в зависимости от способа |
| Формат | Предоставленный LINE и прошедший проверку шаблон с разрешёнными переменными и ссылками | Text, image, video, audio, sticker, location, imagemap, template, Flex и другие объекты |
| Условие production | Проверенное MINI App и одобренный шаблон | Канал Messaging API, подключённый к LINE Official Account, и правила выбранного способа отправки |
| Где отображается | Региональный чат уведомлений MINI App | Чат пользователя с LINE Official Account |
| Ограничение объёма | Обычно до пяти сообщений на одно подходящее действие; проверенный сценарий может задать иной предел | Месячная квота и лимиты endpoint для плана Official Account |
| Модель оплаты | LINE описывает функцию сервисных сообщений MINI App как бесплатную | Количество и цена Messaging API зависят от рынка и плана Official Account |
Выбирайте сервисное сообщение для транзакции после действия
Service Message API подходит, если без конкретного действия в MINI App уведомление не должно возникнуть. Официальные примеры: подтверждение бронирования, завершение check-in, завершение отправки и напоминание о бронировании или купленном билете.
Сервер сначала обменивает LIFF access token через POST /message/v3/notifier/token, затем отправляет одобренный шаблон через POST /message/v3/notifier/send?target=service. Service notification token привязан к одному пользователю и потоку действия. Это не постоянный адрес пользователя LINE и не универсальный credential для push.
Проверка MINI App не отменяет ограничения контента. Скидки, бонусы, новые товары, купоны, акции и общие анонсы событий нельзя превращать в сервисные сообщения. Для подготовки используйте чек-лист проверки шаблона, а для уже работающей интеграции — runbook ошибок Service Message API.
Выбирайте Messaging API для диалога и рассылок Official Account
Messaging API подходит, когда отправителем должен быть LINE Official Account. Reply message отвечает на сообщение или действие через reply token. Push message отправляется допустимому пользователю, группе или групповому чату. Multicast, narrowcast и broadcast обслуживают разные модели массовой отправки.
Этот путь предлагает больше типов контента и подходит для bot-диалогов, поддержки и коммуникаций Official Account. При этом действуют правила дружбы, получателя, месячной квоты, цены и rate limit. Поэтому push Messaging API не заменяет способность сервисного сообщения уведомлять пользователя MINI App, который не добавил Official Account в друзья.
Практическое дерево решения
- Пользователь завершил бронирование, заказ, очередь, check-in или похожее действие в MINI App? Если да, продолжайте оценку сервисного сообщения.
- Уведомление только подтверждает, сообщает результат или напоминает об этом действии? Если нет, сервисное сообщение не подходит.
- MINI App проверено для production, а точный шаблон одобрен? Если да, используйте Service Message API и сохраняйте обновлённый token после каждой успешной отправки.
- Сообщение должно прийти от Official Account, ответить в чате или охватить аудиторию? Выберите Messaging API и нужный способ по модели получателя.
- После уведомления возможны свободные вопросы в поддержку? Спроектируйте отдельный входящий маршрут и свяжите разговор с транзакцией в своей системе.
Не отправляйте одно операционное обновление обоими маршрутами по умолчанию. Дубли путают пользователя и усложняют аудит доставки, согласия и ответственности поддержки.
Где подходит UnifyPort
UnifyPort не выдаёт service notification token LINE, не проверяет шаблоны MINI App, не присваивает статус проверки, не создаёт Official Account и не заменяет официальную отправку Messaging API. Для этого используйте API LINE.
UnifyPort решает отдельную задачу: получает обычные сообщения клиентов из подключённого LINE account и доставляет поддерживаемые сообщения как нормализованные события message.received. Если webhook endpoint настроен с signing_secret, delivery содержит X-Device-Timestamp и X-Device-Signature; перед маршрутизацией проверьте HMAC-SHA256 по raw body.
Это полезно, когда сервисное сообщение подтвердило бронирование, а затем клиент начал обычный диалог поддержки. Сохраните ID бронирования в приложении и свяжите с разговором, не используя service notification token как chat identity. Перед запуском изучите авторизацию LINE и матрицу поддержки сообщений.
Ограничения и компромиссы
Для нативного сервисного сообщения MINI App нужен официальный Service Message API. Unofficial interface не может изменить статус проверки, одобрить шаблон, расширить разрешённый контент или увеличить число сообщений.
Messaging API лучше подходит для насыщенных диалогов Official Account и рассылок, но использует модель получателей, квот и оплаты Official Account. Маршрут обычного account через UnifyPort полезен для поддерживаемых клиентских разговоров, но не превращает их в сервисные сообщения MINI App и не предоставляет функции аудитории Official Account.
FAQ
Что такое сервисное сообщение LINE?
Это транзакционное уведомление LINE MINI App, которое подтверждает действие внутри приложения, сообщает его результат или напоминает о нём. Для production нужны проверенное MINI App и одобренный шаблон.
Сервисное сообщение LINE — это push message?
Нет. Сервисное сообщение использует привязанный к пользователю service notification token и проверенный шаблон MINI App. Push Messaging API отправляется от LINE Official Account по его правилам получателей, квот и оплаты.
Нужно ли добавлять Official Account в друзья?
Для сервисного сообщения — нет. LINE указывает, что пользователь MINI App может получить его, даже если не добавил связанный Official Account. Сообщение появится в региональном чате уведомлений MINI App.
Можно ли добавить в сервисное сообщение акцию или купон?
Нет. LINE запрещает рекламу и анонсы, включая скидки, бонусы, новые товары, купоны и промоакции. Для маркетинга выберите допустимый способ Official Account и соблюдайте его правила.
Можно ли использовать оба API в одном продукте?
Да. Сервисные сообщения — для одобренных уведомлений после действий в MINI App, Messaging API — для диалогов и аудиторий Official Account. Храните credentials и состояние раздельно, связывая маршруты собственным business ID.
Следующий шаг
Начните с официального руководства по выбору и реализации сервисных сообщений. Если отдельно нужно получать обычные сообщения клиентов LINE, проверьте текущую границу в матрице поддержки UnifyPort.
Источники
Официальные материалы LINE проверены 7 августа 2026 года: