LINE Buttons Template: что выбрать, если четырёх действий недостаточно

В шаблоне buttons для LINE Messaging API массив actions содержит не более четырёх объектов action. Если на карточке нужно показать больше вариантов, не объединяйте разные намерения в одну неоднозначную кнопку. Для временного меню подойдут quick replies, для каталога товаров или филиалов — carousel template, для нестандартной иерархии — Flex Message, а логически сгруппированный список лучше разбить на два шага.

Коротко о главном

• Официальный Messaging API reference LINE устанавливает максимум в четыре объекта для массива actions шаблона buttons.
• Для изображения, заголовка или области текста можно задать отдельное действие, но оно не превращается в пятую видимую кнопку.
• Quick replies поддерживают до 13 кнопок и подходят для немедленного временного выбора.
• Carousel template удобен, когда каждый вариант — отдельный товар, филиал или временной слот.
• Flex Message даёт больше контроля над компоновкой, но требует больше проектирования, проверки и тестирования на устройствах.

Что означает лимит в четыре action для LINE buttons template

LINE описывает template messages как предопределённые макеты для интерактивного сообщения. В buttons template есть области изображения, заголовка, текста и кнопок. Обязательный массив actions принимает не более четырёх объектов. Кроме того, для изображения, заголовка или текста карточки можно указать отдельное необязательное действие.

Это разные элементы. Кликабельная область карточки естественно подходит для перехода к подробностям, но не создаёт пятую видимую кнопку. Пользователь должен понимать результат нажатия, а подписи четырёх кнопок должны однозначно отличаться друг от друга.

Здесь рассматривается именно buttons template в Messaging API, а не одноимённая custom action button в LINE MINI App. Для реализации liff.shareTargetPicker() и предписанного LINE макета используйте отдельное руководство по custom action button в LINE MINI App.

Buttons, quick reply, carousel или Flex Message

Вариант	Для чего подходит	Основное ограничение	Когда выбирать
Buttons template	Одна карточка с 1–4 основными действиями	В actions максимум 4 объекта	Все действия важны и относятся к одному контексту
Quick reply	Временное меню или следующий вопрос	Кнопки могут исчезнуть при продолжении диалога	Пользователь должен сразу выбрать один из максимум 13 вариантов
Carousel template	Товары, филиалы, встречи и другие повторяющиеся записи	Нужны единообразные columns	Каждой записи нужны собственные изображение, текст и действия
Flex Message	Брендированный или насыщенный информацией макет	Сложнее JSON, rendering и тестирование	Стандартный template не передаёт нужную иерархию
Диалог в два шага	Длинный список с естественными категориями	Добавляется один ход пользователя	Сначала можно выбрать категорию, затем показать релевантные пункты

Официальный обзор message types описывает buttons, confirm, carousel, image carousel и Flex Message как разные типы сообщений. Это разные модели взаимодействия, а не просто карточки разного размера.

Quick reply для немедленного ответа

LINE позволяет добавить к сообщению до 13 quick reply buttons. Они отображаются в нижней части чата и хорошо подходят для выбора языка, окна доставки, типа обращения или региона филиала.

Не используйте quick reply как постоянную навигацию. LINE перечисляет условия, при которых кнопки исчезают, в том числе появление нового сообщения в комнате. Если пользователь должен вернуться к меню позже, нужен более устойчивый макет либо повторная отправка вариантов в правильном состоянии процесса.

Carousel, если каждый вариант — отдельная запись

Когда варианты представляют разные товары, филиалы или записи на приём, carousel обычно понятнее набора действий на одной карточке. Например, если каждому филиалу нужны «Маршрут», «Часы работы» и «Связаться», логичнее выделить филиалы в одинаковые columns, чем занимать четыре action названиями филиалов.

Сохраняйте сопоставимую структуру columns. Смешивание карточки товара, команды поддержки и несвязанной акции усложняет просмотр и сопровождение.

Flex Message, если проблема в иерархии

Если ограничение связано не только с количеством вариантов, но и с визуальной иерархией, рассмотрите Flex Message. Официальная документация Flex Message elements описывает button components с действиями и несколькими стилями.

Flex не означает, что все возможные действия нужно размещать на одном экране. Проверяйте читаемость на телефоне, ясность подписей, доступность и различия отображения. Перед публикацией используйте Flex Message Simulator и валидацию итогового message object.

Два шага, если варианты отражают бизнес-логику

Часто лучшим решением становится не более крупная карточка, а вопрос верхнего уровня:

1. «С чем вам помочь?» — Заказы, Возвраты, Выбор товара, Учётная запись.
2. Показать только действия, относящиеся к выбранной категории.

Каждый выбор становится короче, а backend получает явное состояние маршрутизации. Такой подход также упрощает распределение по языку, региону или ответственному отделу.

Проверка перед запуском

1. Расставьте приоритеты по намерению пользователя. Самые частые и важные действия должны оставаться видимыми.
2. Разделите навигацию и ответ. Постоянные направления не следует смешивать с ответами на текущий вопрос.
3. Группируйте длинные списки. При естественных категориях используйте диалог в два шага.
4. Давайте различимые подписи. Одновременные «Ещё», «Другое» и «Подробнее» создают ненужную неоднозначность.
5. Обработайте каждое действие на сервере. Postback или message action должны вести в допустимое состояние.
6. Проверьте на мобильных клиентах. Учитывайте обрезку текста и изображений, области нажатия и путь возврата.

Если вы ещё выбираете между service messages в MINI App и reply/push messages в Messaging API, сначала сравните поверхности в статье LINE Service Messages и Messaging API. Тип канала сообщения выбирается раньше макета.

Где подходит UnifyPort — и где не подходит

Все перечисленные варианты — официальные элементы представления LINE Messaging API. UnifyPort не воспроизводит buttons template, quick reply, carousel template или Flex Message. Если процессу необходимы нативные компоненты интерфейса LINE, используйте официальный Messaging API.

UnifyPort решает другую задачу: принимает разговоры LINE через неофициальный интерфейс и направляет нормализованные входящие события в существующий backend. В матрице поддержки сообщений по провайдерам указаны стандартные исходящие типы payload, сопоставленные для LINE. Документация стандартных webhook events определяет единый envelope message.received для поддерживаемых платформ.

Границу можно провести так:

• Нужны официальные интерактивные карточки в потоке LINE Official Account — используйте Messaging API и подходящий официальный message type.
• Нужно направлять сообщения обычной учётной записи LINE в существующую очередь поддержки — оцените входящий путь UnifyPort.
• Нужны оба варианта — проектируйте их как разные поверхности с явно назначенными владельцами и идентичностями.

Подробнее о входящем пути и его ограничениях рассказано в статье как получать сообщения LINE без регистрации Official Account.

Ограничения и компромиссы

Если достаточно четырёх действий, стандартный buttons template остаётся самым простым вариантом. Quick replies дают больше выбора, но являются временными. Carousel удобен для просмотра записей, однако требует единообразного содержания. Flex Message увеличивает контроль над макетом и объём тестирования. Диалог в два шага добавляет одно действие пользователя, но обычно делает решение яснее.

Поведение официального клиента и правила валидации объектов могут меняться. Если реализация зависит от точных лимитов или отображения, повторно проверьте актуальную документацию LINE перед выпуском.

Частые вопросы

Сколько actions допускает LINE Messaging API buttons template?

Массив actions принимает максимум четыре объекта action. Необязательное действие на изображении, заголовке или тексте — отдельная кликабельная область, а не дополнительная видимая кнопка.

Можно ли показать больше четырёх кнопок LINE с quick reply?

Да. LINE документирует до 13 quick reply buttons для одного сообщения. Используйте их для немедленного ответа, а не постоянной навигации: при продолжении чата они могут исчезнуть.

Что выбрать для большего числа действий: carousel или Flex Message?

Carousel подходит для повторяющихся записей с одинаковой структурой. Flex Message — для собственной визуальной иерархии. Если список делится на категории, двухэтапный диалог может быть понятнее обоих вариантов.

Может ли UnifyPort отправлять LINE buttons template?

Нет. Документированная стандартная отправка LINE в UnifyPort не включает официальные buttons template, carousel, quick reply или Flex Message. UnifyPort применим, когда основная задача — приём и маршрутизация сообщений LINE через стандартный webhook.

Следующий шаг

Сначала изучите матрицу поддержки сообщений UnifyPort, затем определите архитектуру входящих и исходящих сообщений. Нативные buttons, quick reply, carousel и Flex следует реализовывать по официальной документации LINE Messaging API.

Источники

Официальные первичные источники, проверены 18 августа 2026 года:

• LINE Messaging API reference
• LINE message types
• Use quick replies
• Flex Message elements