Магазин в Messenger (встроенный Mini App)

Превратите свою страницу Facebook в полноценный встроенный магазин. Создайте отполированный многостраничный каталог товаров — с фотографиями, видео, тематически оформленными страницами, AI-ассистентом для каждого товара и лёгким приёмом заказов — который открывается внутри Messenger в тот момент, когда клиент нажимает кнопку “Open Storefront” в Persistent Menu вашей Страницы. Без магазина приложений, без отдельного сайта, без управления оформлением заказов. Одно касание — и клиент уже просматривает ваш каталог.

Доступно бесплатно на любом тарифе, включая пробный. Создаётся в том же визуальном конструкторе с перетаскиванием, что и магазин в Telegram — те же 11 типов блоков, те же 6 тем оформления, тот же AI-чат по каждому товару, те же лёгкие CTA-кнопки заказа — в разделе Integrations → Facebook Page → Configure mini app.

Что можно построить

Те же форматы, что и в Магазине в Telegram — каждый тип блока и каждая тема переносятся:

• Бутиковый магазин — hero-баннер + сетка товаров + чат по каждому товару + форма запроса заказа. Заказы попадают в ваш inbox; член команды отвечает оттуда.
• Меню ресторана — многостраничное (Закуски / Основные блюда / Напитки) + фотогалерея + оформление заказа в режиме корзины с полем адреса доставки.
• Каталог курсов или услуг — карточки товаров с видеоблоком-вступлением, отзывами и CTA «Записаться на звонок», возвращающим в бот.
• Сайт-брошюра — hero + страница «О нас» + галерея + контактная карточка + FAQ. Вообще без товаров. Отполированная мобильная брошюра, живущая внутри вашей Facebook-страницы.
• Лендинг для сбора лидов — одна страница, один hero, одна форма, один CTA. Самая лёгкая возможная воронка в Messenger.

Почему это важно

• Клиенты не покидают Messenger. Не нужно устанавливать приложение, запоминать домен или проходить через корзину, которую можно бросить. Магазин открывается в WebView Messenger и наследует тему оформления и язык пользователя.
• Одно касание из чата вашей Страницы. Единственная запись “Open Storefront” автоматически добавляется в Persistent Menu в момент подключения Страницы — никакой настройки в Meta Business Suite, никакого app review, никакой обвязки webhook.
• AI-чат, встроенный в товар. Чат по каждому товару ограничен документами, которые вы прикрепили к этому товару — ассистент отвечает «какая у этого платья политика возврата?», не утекая фактов из других товаров.
• Передача заказа живому оператору. Лёгкие формы заказа (режим inquiry или cart) попадают в ваш Inbox как структурированный handoff, при этом DM клиента в Messenger остаётся открытым для последующей переписки.
• Бесплатно на любом тарифе. Лимиты пробного тарифа (5 страниц / 25 блоков на страницу / 100 документов товаров) снимаются на любом платном тарифе. Стоимость считается на организацию — добавление второй Facebook-страницы не меняет цену тарифа.

Кратко

• Многостраничный, drag-and-drop. Конечные пользователи нажимают на «гамбургер» (слева вверху), чтобы переключать страницы. Если опубликована одна страница, она грузится на весь экран.
• 11 типов блоков — Hero, Product card, Product grid, Carousel, Gallery, FAQ, Testimonial, CTA back-to-bot, Contact, Video, Rich text. (Cart — это виртуальная страница, автоматически добавляемая, когда вы используете CTA заказа в режиме корзины — отдельного блока «Cart review» нет.)
• 6 тем оформления с поблочным переопределением стилей.
• Жизненный цикл Draft → Publish с откатом к последнему опубликованному снимку в один клик.
• Persistent Menu добавляется автоматически — одна кнопка “Open Storefront”, редактируемая надпись, действие зафиксировано.
• Резервный режим внешнего чата — блоки проецируются в Generic Templates в чате, Quick Replies и карусели изображений для более старых клиентов Messenger.
• Встроенный Help Center — закреплённая поверхность с FAQ, всегда доступна в одно касание. Та же панель, что и в Telegram.
• Никаких платежей, складского учёта или доставки — это отполированный каталог и поверхность для захвата лидов, а не полный e-commerce-стек.

Как клиенты находят магазин

Каждая подключённая Facebook-страница показывает Persistent Menu всем, кто пишет ей. Мы автоматически добавляем одну запись — “Open Storefront” (надпись по умолчанию, редактируется на что угодно от 1 до 32 символов на любом языке) — которая открывает ваш магазин.

Поток запуска — это postback:

1. Конечный пользователь нажимает “Open Storefront” в Persistent Menu.
2. Бот получает postback BROWSE_SHOWCASE, чеканит одноразовый токен запуска и отправляет обратно Button Template с одной CTA-кнопкой “Open Storefront”.
3. Конечный пользователь нажимает на кнопку → Messenger открывает WebView → магазин загружается.

Это одно дополнительное касание по сравнению с подходом «нажать на меню → мгновенный WebView». Мы используем модель postback, потому что модель прямого WebView молча отказывает у заметной когорты более старых клиентов Messenger (ошибка SDK Meta 2071011). С postback через Button Template работает каждый клиент, что мы тестировали — а токен запуска одноразовый, привязан по HMAC и живёт в DM получателя, поэтому нет риска злоупотребления через расшаренные ссылки.

Предварительные требования

• Подключённая интеграция Meta (Facebook). Магазин работает поверх неё — отдельной интеграции для подключения нет.
• (Опционально) Изображения товаров, тексты товаров, FAQ-записи и документы из базы знаний для подключения к AI-чату по товарам.

Быстрый старт (5 минут)

Самый короткий путь от «я подключил Страницу» до «мой первый клиент уже просматривает каталог»:

1. Зайдите в Integrations → вашу Facebook Page → Configure mini app. Конструктор открывается в состоянии Draft.
2. Нажмите ”+ Add page” в левой колонке. Назовите страницу (например, «Главная»).
3. Добавьте Hero-блок — заголовок, подзаголовок, фоновое изображение 16:9 (перетащите фото, кадратор откроется автоматически).
4. Добавьте Product card — название, цена, изображение 1:1, краткое описание. Включите AI chat и прикрепите документ (PDF со спецификацией, ваша политика доставки — что угодно из вашей KB).
5. Добавьте Order CTA на этот товар — выберите режим inquiry, выберите поля формы (name всегда обязателен).
6. Нажмите Publish. Мы автоматически публикуем Persistent Menu — меню вашей Страницы теперь показывает “Open Storefront” каждому посетителю.
7. Напишите DM собственной Странице с другого аккаунта Facebook. Нажмите на меню → “Open Storefront” → “Open Storefront” (Button Template). Нажмите на товар. Нажмите “Ask a question”. Нажмите “Order this”. Отправьте. Вы увидите handoff в вашем Inbox в течение нескольких секунд.

Это минимальный жизнеспособный Магазин в Messenger. Добавляйте больше страниц, товаров, тем, видео и Help Center по мере роста.

Конструктор

Конструктор — это тот же редактор, что и для Магазина в Telegram — см. Магазин в Telegram: Конструктор для полного обзора (компоновка из трёх панелей, жизненный цикл draft/publish, кадратор изображений, тарифные лимиты). Единственная поверхность, специфичная для канала, — вкладка Distribute.

Вкладка Distribute (Messenger)

Самая правая вкладка конструктора — Distribute. На Messenger она показывает:

Резервный режим внешнего чата для старых клиентов

Для конечных пользователей на клиентах Messenger, которые вообще не могут открыть WebView, магазин всё равно работает — он проецируется в саму ленту чата. Адаптер Send API в outer_chat_adapter.py маппит каждый из 11 типов блоков на нативный примитив Messenger:

• Hero / Product card / CTA back-to-bot → карточка Generic Template
• Product grid / Carousel → карусель Generic Template (несколько свайпающихся карточек)
• Gallery → последовательность сообщений с изображениями
• FAQ / Rich text → текстовые сообщения с опциональными Quick Replies
• Testimonial / Contact → карточка Generic Template с кнопками действий
• Video → видеовложение + подпись

Никакого сломанного UI, никаких тупиков. Тот же список товаров, те же Order CTA — просто отрисованные как шаблоны в чате.

Поток восстановления для конечных пользователей

Если конечный пользователь оказался в WebView, который не может загрузить авторизацию (очень редко — только на нескольких очень старых клиентах), шелл магазина показывает закреплённый сверху баннер со ссылкой обратно на вашу Страницу по адресу m.me/{page_id}?ref=BROWSE_SHOWCASE. Одно касание возвращает его в ленту Messenger; повторное нажатие на “Open Storefront” выдаёт ему новый токен запуска, и он снова внутри.

Это автоматический процесс — настройка администратора не требуется.

Заказы и handoff’ы

Order CTA работают так же, как и в Магазине в Telegram — режим inquiry или режим cart, те же настраиваемые поля формы, то же мгновенное DM “получили ваш заказ”, та же панель запроса заказа в Inbox.

Единственное отличие, специфичное для Messenger: handoff’ы заказов попадают в inbox с metadata.type == "messenger_mini_app_order" (в Telegram используется mini_app_order). Inbox рендерит ту же панель для обоих.

Окно сообщений 24 часа применяется к follow-up сообщениям: Meta разрешает отправлять сообщение пользователю только в течение 24 часов с момента его последнего входящего. Postback запуска магазина сбрасывает окно, поэтому DM “получили ваш заказ” и любые follow-up от команды доходят нормально — но если клиент молчит более 24 часов, придётся дождаться, пока он снова напишет вашей Странице, прежде чем вы сможете ответить.

См. Магазин в Telegram: Запросы заказов и корзина для полного описания потока заказа (поля формы, антиспам-лимиты, окно дедупликации) — всё общее с Messenger.

Модель аутентификации (для любопытных)

Об этом не нужно думать — платформа делает всё сама. Но если вам любопытно:

• Публичные чтения (/style, /showcase, /help-entries) полностью публичные, ключуются по ?i={integration_id}. Без cookie, без signed_request, без rate-limit на них — каждый клиент при холодном старте рендерит магазин мгновенно.
• Действия записи (/ask, /track, /product-chat/stream, /order-inquiry) требуют сессию. Основной путь: httpOnly cookie messenger_mini_app_session, отчеканенный из одноразового токена запуска (с разделением через CHIPS, чтобы in-app браузер Messenger не блокировал его как cookie третьей стороны). Резервный путь: HMAC signed_request от Meta для редких клиентов, где SDK ещё работает.

Это всё. Ни один клиент не видит запрос на вход.

Чего магазин НЕ делает

Тот же объём, что и у Магазина в Telegram:

• Никаких платежей. Order CTA — это передача запроса, а не Checkout API или Stripe.
• Никакого складского учёта. Бейджи наличия на product cards — это свободно заполняемые метки, которые вы редактируете вручную («Sold out», «Pre-order», «Last 3»).
• Никаких расчётов доставки и валидации адреса. Адрес доставки собирается как свободный текст.
• Никаких клиентских учётных записей. Клиенты идентифицируются по Messenger PSID; нет потоков логина или регистрации.
• Никаких комментариев Страницы и постов Страницы. Эта интеграция работает только с ветками Messenger и запусками магазина.
• Никакого магазина для DM Instagram (пока). Та же интеграция Meta охватывает только Messenger; DM Instagram остаётся только текстовым диалогом.
• Окно сообщений 24 часа применяется. См. выше.

Устранение неполадок

”Open Storefront” не появляется в меню моей Страницы

1. Откройте конструктор → вкладка Distribute → нажмите Publish to Messenger.
2. Если вы видите янтарный баннер “Connect your Page”, сначала завершите этот шаг — автоматической инициализации нужны разрешения на управление Страницей.
3. Если баннер остаётся после повторной публикации, отключите и заново подключите интеграцию. Автоматическая инициализация после подключения запускается заново.

Клиент говорит, что кнопка ничего не открывает

Почти всегда это устаревший клиент Messenger. Шелл показывает ему баннер «вернуться в чат» в одно касание; он снова открывает Страницу, нажимает “Open Storefront” снова, и следующий токен запуска получает свежую redemption.

Магазин открывается, но я не могу отправить заказ

Проверьте, что:

1. Вы внутри Messenger (а не в обычной веб-оболочке Facebook).
2. Последнее входящее сообщение клиента вашей Странице было менее 24 часов назад (или он только что нажал кнопку запуска, что сбрасывает окно).
3. Ваш Inbox отображается — заказ мог прийти, но быть отфильтрованным поиском или фильтром статуса.

Автоматическая инициализация не сработала, а кнопка Publish to Messenger неактивна

Не хватает разрешений на управление Страницей. Зайдите в Integrations → ваша интеграция Meta → меню из трёх точек → Reconnect. OAuth-поток снова запросит у вас недостающий scope.

Важные замечания

• Один магазин на Страницу: у каждой Facebook-страницы свой черновик и опубликованный магазин — независимо от других Страниц в той же организации.
• Цена считается на организацию, а не на Страницу: добавление второй Facebook-страницы НЕ меняет цену вашего тарифа.
• Общий конструктор с Telegram: если вы используете оба канала, один и тот же конструктор строит оба — просто откройте ссылку “Configure mini app” каждой интеграции. Темы, блоки и записи Help Center не переносятся между каналами, но шаблоны переносятся.
• Адаптер внешнего чата автоматический: его не надо настраивать. Каждый опубликованный вами блок проецируется в Generic Templates / Quick Replies / карусели изображений для резервного пути.