OY Telegram Mini App — инструкция

Как подключить магазин к своему аккаунту МойСклад, что настроить перед первым заказом и что происходит после него. Настройка целиком внутри МойСклад: внешнего личного кабинета у решения нет.

Что это

Ваш каталог МойСклад становится магазином внутри Telegram. Покупатель открывает магазин кнопкой меню в вашем боте, набирает корзину и оформляет заказ. Заказ приходит в МойСклад Заказом покупателя, покупатель получает статусы в переписке.

Товары, цены и остатки берутся из МойСклад в момент показа. Отдельной базы товаров у магазина нет: ничего выгружать и обновлять не нужно, а старая цена в магазине появиться не может.

Шаг 1. Заведите бота Telegram

Магазин работает в вашем собственном боте — так покупатели пишут вам, а не посреднику.

Откройте в Telegram чат с @BotFather.
Отправьте /newbot и следуйте подсказкам: имя бота и адрес, оканчивающийся на bot (например moy_magazin_bot).
BotFather пришлёт токен — строку вида 1234567890:AA.... Скопируйте её целиком.

Один бот работает с одним магазином. Токен, уже подключённый к другому аккаунту МойСклад, решение не примет: заведите для этого аккаунта отдельного бота.

Шаг 2. Откройте окно решения

Найдите OY Telegram Mini App среди установленных решений в вашем аккаунте МойСклад и откройте его. Настройка живёт только здесь: внешнего личного кабинета у решения нет, логин и пароль МойСклад оно не спрашивает.

При первом открытии встречает мастер из семи экранов: язык, приветствие, название магазина с направлением и логотипом, формат, цвет, склад с типом цены и токен бота. Два последних шага можно пропустить ссылкой «Пропустить шаг» — тогда вы настроите их в панели по Шагам 3 и 5. Весь мастер целиком пропускает кнопка «Сразу к подключению» в шапке.

Последняя кнопка мастера — «Запустить магазин»: после неё решение само сохраняет выбранное и открывает раздел «Магазин», с которого начинается Шаг 3. Если вы заполнили в мастере склад и токен бота, магазин на этом уже работает, а Шаги 3 и 5 останутся местом, где это меняют.

Настраивать решение может только администратор аккаунта МойСклад. Остальные сотрудники увидят сообщение о том, что настройка доступна администратору.

Шаг 3. Подключите МойСклад

Путь: «Магазин» → плитка «Интеграции» → строка «МойСклад». С главной туда же ведут карточка «С чего начать?» и кнопка «Склад и цены в МойСклад».

На экране четыре шага:

Организация — от её имени создаются Заказы покупателя. Поле необязательное: пусто — возьмём первую организацию аккаунта.
Склады — галочками, можно отметить несколько (до пяти). Наличие товара считается суммой остатков по отмеченным складам. Само число покупатель не видит: в карточке стоит «В наличии» или «нет в наличии». Заказать больше, чем есть на складах, магазин всё равно не даст — корзина ответит, сколько можно. Первый отмеченный **по порядку в списке** помечен «основной» — по нему создаётся Заказ покупателя.
Тип цены — по нему берутся цены товаров.
Что показывать в магазине — см. Шаг 4.

Нажмите «Подключить».

Если у позиции нет цены по выбранному типу, покупатель видит её с пометкой «цена не указана» и заказать не может — это подсказка проверить прайс в МойСклад.

Шаг 4. Выберите, что продавать

На том же экране блок «Что показывать в магазине»: товары, услуги, комплекты. Отметьте нужное и нажмите «Подключить».

Услуги по умолчанию выключены — если торгуете услугами, поставьте галочку сами. Услуги показываются без остатка и доступны к заказу всегда. Товары идут вместе с модификациями: в витрине показываются сами модификации, а не карточка-родитель.

Снять все три галочки нельзя: хотя бы один тип позиций должен остаться.

Шаг 5. Вставьте токен бота

Путь: «Магазин» → плитка «Площадки» → строка «Telegram», поле «Токен бота от @BotFather». С главной короче: карточка-подсказка «Подключить бота».

Вставьте токен и нажмите «Сохранить». Решение поднимет бота само: поставит вебхук и кнопку меню «Магазин». В BotFather настраивать больше нечего.

Прочитайте строку под кнопкой — это единственный отчёт о результате:

«Настройки сохранены, магазин работает» — всё поднялось;
«Для запуска магазина не хватает: …» — бот стартует только когда заданы склад, тип цены и токен вместе. Вернитесь к Шагу 3;
«Telegram не принял этот токен» — токен отозван или скопирован не целиком.

После этого на главной карточка статуса меняется на «Магазин работает», а на экране Telegram появляется кнопка «Открыть бота». Само по себе слово «Подключено» рядом с Telegram означает лишь, что токен сохранён.

Поле токена после сохранения всегда пустое — под ним подпись «Значение сохранено». Пустым его можно оставлять: токен не сотрётся.

Шаг 6. Доставка и оплата

Плитки на экране «Магазин», блок «Управление».

Доставка — способы получения с ценой. Пока список пуст, покупатель видит «Самовывоз» и «Доставку» по адресу, обе бесплатные. Платная доставка попадает в Заказ покупателя отдельной строкой-услугой «Доставка (Telegram-магазин)», которую решение заводит в вашей номенклатуре один раз.
Оплата — из коробки есть только «Наличными при получении». Перевод на карту и другие способы заводите сами, вместе с реквизитами: покупатель увидит их после оформления, а покупатель из Telegram получит их ещё и сообщением от бота. Пока способ один, вопрос об оплате покупателю не задаётся.

Шаг 7. Оформите витрину

«Магазин» → плитка «Витрина»: тема (светлая или тёмная), акцентный цвет, название магазина, формат, картинка пустой корзины. Поле языка подписано «Язык мастера и подсказок» — это язык магазина по умолчанию.

Тему и язык покупатель переключает сам — кнопками в витрине, и его выбор важнее вашего. Карточки «Светлая» и «Тёмная» в шапке панели меняют тему самой панели, а не витрины. Цвет текста на акцентных кнопках решение подбирает само: на светлом акценте буквы тёмные, на тёмном — белые, отдельной настройки нет.

В том же окне ниже — карточка «Поддержка магазина». Впишите туда @имя того, кто отвечает покупателям в Telegram: у покупателя в профиле витрины появится кнопка «Написать в поддержку», и она откроет сразу переписку с этим человеком — с готовым первым сообщением в поле ввода, чтобы вы видели, из какого магазина пришёл вопрос. Отправит его покупатель сам. Оставите поле пустым — кнопки не будет вовсе. Если вместо имени скопируется целая ссылка на профиль, ничего страшного: решение само оставит от неё одно имя.

«Магазин» → плитка «Контент»: баннер на главной (обложка с логотипом и названием), кружки-сторис, подборки и информационные блоки. Рядом с полями телефон показывает, как это увидит покупатель, ещё до сохранения.

Порядок на главной

«Контент» → «Настройка главной»: сторис, обложка, подборки, товары и каждый информационный блок стоят одним списком, стрелки двигают их вверх и вниз. Кнопка внизу возвращает порядок по умолчанию. Здесь всё сохраняется сразу, кнопки «Сохранить» нет.

Порядок разделов каталога

«Контент» → «Подборки»: стрелки в строке раздела двигают его выше или ниже, после перестановки нажмите «Сохранить» — в отличие от «Настройки главной».

Два важных ограничения:

Ленты товаров на главной строятся только для первых четырёх разделов в этом порядке. У пятого и дальше на главной ленты нет — порядок решает, кто её получит.
Переключатель в строке раздела убирает его **только из карточек подборок на главной**. В каталоге и в поиске покупатель по-прежнему его видит, а лента товаров остаётся, если раздел в первой четвёрке.

Фото задаётся разделам верхнего уровня; вложенные подразделы в этот список не попадают. Без своего фото карточка берёт первое фото товара из раздела.

Как открыть магазин

Кнопка меню «Магазин» слева от поля ввода в вашем боте — основной вход для покупателей в Telegram.
Ссылка веб-витрины — включается в «Магазин → Площадки → Веб-витрина», там же кнопка «Открыть витрину» и копирование ссылки. Каталог открывается в обычном браузере.

Веб-витрина работает только у настроенного магазина: без токена бота ссылка отдаёт «Магазин ещё настраивается», даже если переключатель включён.

После заказа в вебе покупателю предлагается кнопка «Получать статусы в Telegram» — она привязывает этот заказ к его чату. Покупателю нужно нажать «Старт» в боте: до этого бот не может написать ему первым.

Что происходит после заказа

В МойСклад появляется Заказ покупателя с контрагентом и позициями. Способ получения, контакт в Telegram и способ оплаты лежат в отдельных полях решения. Если МойСклад не даёт создать эти поля, заказ всё равно оформляется, а значения уходят в комментарий документа.
Меняете статус заказа — покупатель получает уведомление в переписке.
Отмечаете оплату Входящим платежом или Приходным ордером — покупателю уходит подтверждение с суммой; про наличные и безнал текст разный. Неважно, из какого документа вы её завели — лишь бы платёж был привязан к этому заказу.

Заказ, заведённый руками в МойСклад, работает так же, если в нём стоит та самая карточка контрагента, которую завело решение (в ней есть доп. поле «Telegram») или карточка из прошлого заказа. Если сотрудник выбрал другую, ранее заведённую вручную карточку того же человека, покупателя решение не найдёт.

Какие сообщения получает покупатель

«Магазин» → плитка «Оформление заказа», карточка «Что писать покупателю»: галочки «Смена статуса заказа», «Оплата отмечена», «Отгрузка». Снимете галочку — сообщение не уйдёт, а документы в МойСклад останутся как есть.

Там же отмечаются конкретные статусы: списки берутся из вашего МойСклад. Оговорки, о которых стоит знать:

Пока вы ни разу не сохранили этот экран, сообщения идут по всем статусам.
Статус, добавленный в МойСклад позже, по умолчанию не отмечен — сообщение о нём не придёт, пока не отметите.
Документ без статуса уведомляет всегда.
У Отгрузки статус проверяется в момент её создания: если поставить отмеченный статус позже, сообщение не уйдёт.

Уведомления работают на любом тарифе МойСклад. На пробном и платных тарифах они приходят сразу. На бесплатном тарифе МойСклад не отдаёт вебхуки — решение само проверяет заказы и оплаты раз в минуту, сообщение может прийти с задержкой до минуты.

Что покупатель видит в боте

Кнопки под полем ввода: заказы и их статусы, оплаты (наличные и безналичные одним списком), баланс, отчёт о покупках за месяц и язык.

В списках по десять записей, дальше кнопка «Показать ещё» — до ста записей. Под заказом видно, что в нём было: первые три названия, дальше «и ещё N»; количество печатается, когда его больше одного.

В витрине то же — «Профиль» → «Заказы»: карточка на каждый заказ с номером, датой, статусом, составом и суммой. Статус в карточке — последний, о котором пришло уведомление: если выключить «Смену статуса заказа», он обновляться перестанет.

Оплаты, баланс и отчёт появляются, когда у покупателя есть контрагент — он заводится при старте бота или при первом заказе. Отчёт за месяц считает проведённые продажи: если заказы есть, а продаж по ним ещё нет, покупок он не покажет.

Покупатели в справочнике

Как только человек запускает бота, в МойСклад появляется Контрагент с его именем из Telegram и доп. полем «Telegram». Так видно, кто пришёл, ещё до первого заказа, и сотрудник может написать ему из карточки заказа. Не нужно — выключите в разделе «Витрина», тогда контрагент заведётся при первом заказе.

Дописать заказ покупателю

В карточке Заказа покупателя есть виджет решения. Щёлкните по полю товаров — откроется справочник с остатком и ценой каждой позиции, ввод его фильтрует; в одно сообщение помещается до пяти товаров, текст — до 500 знаков.

Выберите товары, напишите текст — покупатель получит сообщение в боте магазина: выбранные позиции строками и кнопка «Продолжить заказ» с номером. По ней у него откроется корзина, собранная из позиций этого заказа, и он дооформит его сам. Правится тот же документ, второй заказ не появляется.

Сверху виджет показывает, кому пишет: имя контрагента, телефон и Telegram. Если покупателя в боте ещё нет, вместо формы будет ссылка на бота — отправьте её клиенту.

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

Клиенты магазина

«Маркетинг» → плитка «Клиентов в боте» — все, кто запускал вашего бота: имя, телефон, сколько заказов сделал, на какую сумму, средний чек и долг из МойСклад. По умолчанию сверху недавние; сортировку можно сменить на долг, средний чек или число заказов, а искать — по имени, телефону и id чата. Покупатели веб-витрины, не привязавшие бота, сюда не попадают.

Отметьте нужных галочками и нажмите «Написать выбранным» — откроется форма рассылки с этими получателями: текст и отправку вы задаёте сами.

Дату рождения покупателя укажите в карточке контрагента в МойСклад, в поле «День рождения» — решение заводит его само. В списке клиентов и в виджете заказа появится напоминание: за неделю и ближе — «через сколько дней», раньше — дата.

Задачу в МойСклад решение при этом не ставит — напоминание живёт только в панели и в виджете заказа.

Продвижение

Промокоды: процент, сумма или бесплатная доставка; со сроком, лимитом, минимальной суммой заказа, ограничением «один раз на покупателя» и областью действия по разделам. Покупатель вводит код в корзине.
Рассылки: по сегментам (все, делали заказ, ещё не заказывали, бросили корзину), с картинкой, с кнопкой на товар, раздел, сторис, корзину или внешнюю ссылку, сразу или по расписанию. Есть «Тест себе».

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

Нужно ли выгружать товары? Нет. Магазин читает их из МойСклад при каждом показе.

Что будет, если я поменяю цену в МойСклад? Покупатель увидит новую цену сразу. В каталоге с фильтрами или сортировкой старая цена может продержаться до пяти минут, а в уже собранной корзине — до оформления: заказ всё равно уйдёт по новой цене.

Товар без фото. Магазин покажет фирменную заглушку. Фото добавляются в карточке товара в МойСклад — у модификаций свои фото, фото товара-родителя они не берут.

Я сменил фото товара, а в магазине старое. Обновится само: магазин следит за датой изменения позиции.

Покупатель не получает статусы. Проверьте галочки в «Оформлении заказа»: там выбирается, о каких статусах и оплатах писать. На бесплатном тарифе МойСклад сообщение приходит с задержкой до минуты.

Могу я поменять бота? Да, вставьте новый токен в настройках. Переписки в старом боте не переносятся: покупателям придётся нажать «Старт» в новом боте, иначе сообщения им не дойдут.

Что будет с данными, если удалить решение? МойСклад аннулирует токен доступа, бот останавливается, вебхуки снимаются. Всё остальное решение хранит 30 дней: токен бота, настройки и оформление витрины, покупателей, журнал заказов, рассылки и промокоды. Установите решение снова в этот срок — магазин заработает сразу, вводить токен бота заново не нужно. Через 30 дней токен бота, контакт поддержки и данные покупателей удаляются; оформление витрины остаётся. Заказы и контрагенты в МойСклад не трогаются никогда — они ваши.

Можно ли управлять магазином с телефона? Отчасти. В «Магазин → Панель в Telegram» открывается ссылка привязки, она действует 15 минут; после неё в боте появляется кнопка «Панель магазина». С телефона видны клиенты и статистика — только просмотр, списка заказов там нет. Настройки меняются в окне решения внутри МойСклад; там же одной кнопкой отзывается доступ у всех, кому вы его давали.

Поддержка

Вопрос по решению — напишите в Telegram: @OY_OFFICIAL. Отвечаем на русском и узбекском.

Решение устанавливается из Каталога решений МойСклад. Настройка целиком внутри МойСклад — внешнего личного кабинета нет. Вопросы по решению — в Telegram: @OY_OFFICIAL.