Как вам помочь ?
Телеграм и МАКС-магазин и Мой склад
В данной статье рассмотрим инструмент для создания магазина в мессенджерах Телеграм и МАКС, передачу товаров из системы учета "МойСклад" в магазин и передачу заказов из магазина в систему "МойСклад".
Рассмотрим подробнее настройки подключения и особенности работы.
Регистрация в системе МойСклад 2.0
Региструемся на стороне "МойСклад" по кнопке "Регистрация", вводим свои данные (рис.1).

Рисунок 1.
В личном кабинете переходим в пункт меню "Решения" - "Каталог решений" (рис.2).

Рисунок 2.
Находим "Телеграм/МАКС-магазин от Адвантшоп" и переходим к его установке (рис.3).

Рисунок 3.
Далее создаем аккаунт на Адвантшоп (рис.4).

Рисунок 4.
После создания аккаунта будут доступны быстрые настройки синхроназации магазина с Мой склад (рис.5). Можно произвести настройки на данном этапе, либо оставить как есть и нажать "Далее". Дополнительные настройки каталога, заказов, складов и т.д. будут доступны в настройках решения "Телеграм/МАКС-магазин от Адвантшоп".

Рисунок 5.
Перейти в созданный магазин на Адвантшоп, чтобы настроить Телеграм/МАКС-магазин, можно по ссылке "Перейти в настройки" на стороне Мой склад(рис.6).

Рисунок 6.
Рассмотрим отдельно настройки интеграции "МойСклад" и Адвантшоп по передаче товаров и заказов, а также создание магазина в Телеграм/Макс.
Настройки обмена данными
Так как при регистрации приложения "МойСклад" создается аккаунт на Адвантшоп, то автоматически происходит связь магазина и МойСклад. Все настройки, необходимые для обмена данными, производятся в приложении МойСклад.
Каталог
Во вкладке "Каталог" производим настройки касающиеся выгрузки и обновления каталога и товаров (рис.7).

Рисунок 7.
Настройки интуитивно понятны и соответствуют полям в магазине. Обратим внимание на некоторые из них.
Источник артикула: код или артикул — если в настройках указан код, то в качестве артикула в магазин будет выгружаться код указанный в товаре (рис.8) (рис.9).

Рисунок 8.

Рисунок 9.
Если в настройках выбран артикул, то в товар будет выгружаться артикул товара из "МойСклад" (рис.10).

Рисунок 10.
Внимание!
Если у товара добавлена модификация, то поле артикул у нее отсутствует. Если в настройках указано "выгружать артикул", то будет выгружаться внешний код. Поэтому рекомендуем в код прописывать артикул товара и в качестве артикула выгружать Код.
В полях "Размер" и "Цвет" необходимо указать те названия модификаций, которые указаны у товара (это могут быть объем, вес, и т.д.).
Тип цены для продажи - в моем складе может быть несколько типов цен, в настройках указывается та, которую необходимо выгружатьв качестве цены товара.
Загружать остатки по - можно выбрать какие остаки выгружать, с учетом резерва и т.д.
Обновлять - выбирается из списка, что необходимо обновлять из "МойСклад".
Загружать описание - варианты загрузки:
- Не синхронизировать (описание не будет выгружаться из "МойСкла"д, можно добавить описание в магазине и оно не будет заменяться);
- В краткое и полное (описание из "МойСклад" будет загружаться и в краткое и в полное описание товара);
- В краткое (описание загружается в краткое описание);
- В полное (описание загружается в полное описание в товаре).
Синхронизация свойств товара:
- Не синхронизировать (свойства из "МойСклад" не выгружаются);
- Добавлять/Обновлять к продукту из "МойСклад (новые свойства добавляются и обновляются, при этом свойства товара, добавленные в магазине сохраняются);
- Один в один с "МойСклад" (добавляются свойства такие же, как в "МойСклад", при этом свойства, добавленные в магазине будут затираться).
Привязка товара к категориям:
- Не синхронизировать (категории из "МойСклад" не добавляются);
- Добавлять в категорию из "МойСклад" (товары будут добавлятся в категорию, к которой они относятся в "МойСклад");
- Один в один с МойСклад (товары будут добавлятся в категорию, к которой они относятся в "МойСклад")
Вес в МоемСкладе указан в: в килограммах или граммах. Параметр веса важно правильно указывать, так как он необходим для расчета доставки.
Заказы
На вкладке "Заказы" прежде всего нужно указать организацию (рис.11).

Рисунок 11.
Синхронизация
На вкладке "Синхронизация" производим настройки по синхронизации заказов и покупателей (рис.12).

Рисунок 12.
1. Обновлять контрагентов из магазина - для того, чтобы изменения по покупателям передались в "МойСклад" например у покупателя изменился адрес, то необходимо в настройках активировать данный пункт;
2. Обновление каталога - задается интервал запуска (часы/мин.) автоматического обновления каталога товаров;
3. Обновление остатков - задается интервал автоматического обновления остатков (час/мин);
4. Ручной запуск обновления - по нажатию кнопок "Обновить каталог" и "Обновить остатки" товары и остатки можно выгрузить при необходимости в любом момент.
Типы цен
Здесь можно регулировать наличие типов цен, если из Мой склад пришла нулевая цена (рис. 13). Подробнее о настройке типов цен можете ознакомиться в инструкции.

Рисунок 13.
Склады
На вкладке "Склады" необходимо выбрать склад по остаткам, где будет происходить учет, так как складов бывает несколько (рис. 14).

Рисунок 14.
Далее рассмотрим подключение Телеграм-магазина.
Чтобы настроить Телеграм/МАКС-магазин, на странице настроек решения нажмите на кнопку "Перейти в настройки" (рис.6). После чего вы попадаете в административную часть магазина на Адвантшоп.
Далее перейдите в раздел "Модули" и во вкладке "Магазин модулей" установите модули "ТГ-магазин" и "Авторизация через Telegram" (рис.15 и 16).

Рисунок 15.

Рисунок 16.
Специфических настроек в модуле "ТГ-магазин" нет, основные настройки производятся в модуле "Авторизация через Telegram". Перейдите в настройки модуля "Авторизация через Telegram". Здесь необходимо указать ключ вашего бота в поле "Telegram токен бота" и активировать его (рис.17). Правила создания бота подробнее описаны в инструкции Авторизация через модуль Телеграм.

Рисунок 17.
После активации ключа в модуле станут доступны дополнительные разделы для настройки: Приложения, Каналы, Автоответ, Шаблоны ответов. Ниже рассмотрим подробнее данные настройки.
Во вкладке "Приложения" нажмите на кнопку "Добавить", в открывшемся окне нужно заполнить ряд полей и скопировать ссылку магазина для вашего ТГ-магазина (рис. 18).

Рисунок 18.
Ниже рассмотрим подробнее (рис. 19).

Рисунок 19.
1) Название - техническое название ссылки для таблицы в настройках модуля.
2) Ссылка на Mini App в Telegram - Указываем здесь ссылку мини приложения из Телеграм. Создать ссылку можно перейдя в @BotFather.
В телеграме наобходимо открыть @BotFather, нажав на кнопку его прилоежния "Open", в нем открыть бота привязанного к модулю "Авторизации через Телеграм", и открыть раздел "Mini Apps". Теперь в нем нажмите на "Create Direct Link" (рис. 20).

Рисунок 20.
В открывшемся меню, в поле "Direct Link" укажите ссылку на вашего бота, загрузите изображение, дайте ссылке название и описание. В поле "Choose a link for your app" укажите ссылку для вашего приложения (рис. 21).

Рисунок 21.
Теперь эту ссылку мы указываем в поле "Ссылка на Mini App в Telegram" (рис. 4).
Рассмотрим настройки дальше (рис. 22).

Рисунок 22.
3) Текст кнопки - текст кнопки в Телеграм, который увидит клиент. Например: "Магазин".
4) Страница для перенаправления - ссылка на ваш магазин. Покупатель попадет на эту страницу нажав на кнопку ТГ-магазина, рекоменудется ее заполнять.
5) Текст сообщения в боте - описание, сообщение в боте.
Другие настройки, также включают (рис. 23).

Рисунок 23.
1) Показывать при команде /start - отображает кнопку mini app при команде /start, если включена опция.
2) Дополнительно, можно задать название для этой кнопки в опции "Текст кнопки при команде /start".
3) Ссылка для открытия веб-приложения - ссылка генерируется самим модулем и необходима для корректной привязки магазина. Копируем эту ссылку и идем в наше мини-приложение, внутри BotFather.
В телеграме наобходимо открыть @BotFather, нажав на кнопку его прилоежния "Open", и в нем открыть бота привязанного к модулю "Авторизации через Телеграм". После этого перейти в раздел "Mini-apps" внутри бота (рис. 24).

Рисунок 24.
Внутри "Mini Apps" добавьте "Ссылка для Телеграм приложения" в настройки "Menu Button" и "Main App" (рис. 25).

Рисунок 25.
Теперь ваши клиенты смогут получить доступ к вашему каталогу и заказать товары прямо из Телеграм используя mini app (рис. 26).

Рисунок 26.
Теперь рассмотрим, как разместить ссылку на mini-app в самом Телеграм канале магазина, а не только внутри бота.
Размещение ТГ-магазина в канале магазина
Размещение кнопки мини-приложения внутри самого канала производиться посредством отправки сообщения из модуля Телеграм и его закреплением в шапке канала. Рассмотрим подробнее, как это сделать.
Внимание!
Перед началом добавления канала, добавьте бота в ваш канал как "Администратора".
После того, как бот будет добавлен в канал, перейдите в настройках модуля "Авторизации через Телеграм" в раздел "Каналы". Нажмите на кнопку "Добавить" укажите название канала и его ID (рис. 27).

Рисунок 27.
После этого в таблице появится канал и по нажатию на кнопку "Сообщения" будет открыто окно для его оформления (рис. 28).

Рисунок 28.
Здесь вы можете прикрепить к сообщению, которое будет отправлено в ваш канал:
- Изображение;
- Указать сам текст сообщения;
- Выбрать кнопку - данная опция добавит кнопку под сообщение, нажатие по которой откроет ТГ-магазина.
После размещения такого сообщения, вы можете закрепить его в шапке канала, чтобы у пользователей всегда был доступ в магазин (рис. 29).

Рисунок 29.
Готово, мы рассмотрели все настройки мини-приложения ТГ-магазина и его настройки для магазина на платформе Адвантшоп.
Подключение Макс
Главное преимущество – удержание клиента внутри единой системы. Покупателю при общении с Вами через МАКС больше не нужно покидать привычный интерфейс, чтобы совершить покупку.
Внимание!
МАКС-магазин работает только через МАКС-бота, работа МАКС-магазина в каналах МАКС не поддерживается.
Важно
В рамках МАКС-бота возможно отобразить в меню только один МАКС-магазин.
Установка модуля
Для начала работы с модулем с МАКС-магазином перейдите в раздел "Модули" и установите модуль "Модуль "МАКС-магазин" (рис. 30).

Рисунок 30.
Заметка
Для работы с мини-приложениями МАКС в интернет-магазине/ресторане уже должен быть настроен и подключен модуль "Авторизация через МАКС".
Важно
Подключение к платформе МАКС для партнёров и её сервисов доступно только для юридических лиц и ИП, которые являются резидентами РФ.
Самозанятые, физические лица и нерезиденты не смогут пройти верификацию на платформе МАКС и, соответственно, не смогут воспользоваться модулем авторизации МАКС на нашей платформе.
После установки модуля "МАКС-магазин", если модуль авторизации в МАКС не установлен и не активирован, то в модуле отобразится следующая информация (рис. 31):

Рисунок 31.
Нужно установить и настроить модуль авторизации в МАКС.
Если модуль авторизации в МАКС установлен, то в модуле "МАКС-Магазин" отобразится следующая информация (рис. 32).

Рисунок 32.
Нажмите на кнопку "Перейти в модуль MAX".
После нажатия Вас перебросит в настройки модуля "Авторизация через МАКС".
Мини-приложения МАКС
В модуле "Авторизация через МАКС" перейдите на вкладку "Мини-приложения".
На открывшейся странице отображается "Ссылка для подключения мини-приложения в MAX".
Скопируйте ссылку для подключения мини-приложения с помощью кнопки рядом с полем (рис.33).
Внимание!
Ссылка должна быть с протоколом HTTPS. В случае отсутствия SSL-сертификата – необходимо подключить его.
Если у вас тариф с интернет-магазином, пожалуйста, следуйте инструкции "Подключение SSL-сертификата".
Для тарифов, включающих только магазин в МАКС и Телеграм, обратитесь в нашу поддержку.

Рисунок 33.
Теперь откройте раздел в МАКС для партнеров. Для этого перейдите по ссылке https://business.max.ru/self, авторизуйтесь и найдите карточку "Чат-бот и мини-приложение". Нажмите "Настроить", чтобы продолжить (рис. 34).

Рисунок 34.
В блоке "Мини-приложение" вставьте скопированную ссылку в поле "Введите ссылку", выберите кнопку открытия и нажмите "Сохранить" (рис. 35).

Рисунок 35.
Сразу после добавления ссылки для подключения мини-приложения в МАКС автоматически создается мини-приложение с типом "Главная страница".
Создание мини-приложений в модуле
Рассмотрим, как создавать мини-приложения.
Заметка
После добавления ссылки для подключения мини-приложения в МАКС на стороне МАКС у Вас уже создалось мини-приложение с типом "Главная страница".
Для созданий новых приложений в модуле "Авторизация через МАКС на вкладке "Мини-приложения" нажмите на "+ Новое приложение" (рис. 36).

Рисунок 36.
Откроется окно с полями для создания (рис. 37):

Рисунок 37.
Название приложение – название, которое выводится в административной панели и используется при отправке сообщений покупателям.
Страница перенаправления – здесь нужно указать часть ссылки из своего магазина, которую Вы хотите продвигать в виде приложения. Это может быть, например, каталог - catalog, товар - products/chasy. категория - categories/kategoriya-1 и т.д.
Т.е. при клике на приложение будет открываться ссылка, которую Вы здесь укажете.
Активность приложения – от этой настройки зависит, будет ли приложение доступно для покупателя. На что еще влияет эта настройка рассмотрим ниже.
Вы можете создать неограниченное количество приложений, все они будут отображаться в виде плитки на этой же странице по новизне, т.е. последнее созданное приложение будет отображаться первым (рис. 38):

Рисунок 38.
При клике на картинку QR-кода открывается окно с QR-кодом и ссылкой на приложение, их Вы можете использовать для размещения где-либо в своих целях (рис.39).

Рисунок 39.
Перейдем к настройкам мини-прилоржений.
Настройки мини-приложений
В модуле "Авторизация через МАКС" на вкладке "Настройки" в блоке настройки мини-приложений имеются 2 настройки (рис.40).

Рисунок 40.
Приложение по умолчанию – по умолчанию для отображения в МАКС боте выбрана "Главная страница", но Вы можете выбрать из списка любое активное приложение (рис. 41).

Рисунок 41.
Заметка
Главная страница всегда активна, поэтому если Вы выберете другое приложение по умолчанию и оно когда-то в будущем будет деактивировано, то приложение по умолчанию автоматически изменится на "Главная страница".
Приложение по умолчанию открывается в боте МАКС при клике на соответствующие кнопки (рис. 42):

Рисунок 42.
Открывшееся приложение выглядит так (рис. 43):

Рисунок 43.
Если приложение не найдено – здесь есть 2 варианта: либо открыть приложение по умолчанию, либо показать ошибку (рис. 44).

Рисунок 44.
Заметка
МАКС-магазин поддерживается на платформах Android, iOS, Mac и Windows, но в настоящее время нежоступен в веб-версии МАКС.
Готово. Мы рассмотрели, как настроить МАКС-магазин на платформе Адвантшоп.