С чего начать #
Для чего: Кратчайший путь от нуля до работающего бота-магазина. Ниже — весь порядок действий, детали каждого шага — в соответствующих разделах.
Порядок подключения
- Установите решение из маркетплейса МойСклад (кнопка «Установить» в карточке приложения). Наша панель откроется прямо в окне МойСклад.
- Создайте Telegram-бота через @BotFather и получите токен (раздел «Подключение бота»).
- Вставьте токен в панели → бот подключится.
- Перейдите по ссылке владельца (появится после подключения) и нажмите Start — так вы привяжете себя как владельца.
- Настройте каталог, менеджеров, уведомления и остальное — по разделам ниже.
- Дальше в панель можно заходить не только через МойСклад, но и с сайта — по почте и паролю (раздел «Обзор и вход в панель»).
Что нужно иметь под рукой
- Аккаунт МойСклад с товарами и складом.
- Telegram и доступ к @BotFather для создания бота.
- Название и логотип компании, тексты «О нас», адреса — для оформления.
Обзор и вход в панель #
Для чего: Главная страница панели: состояние бота, тариф с числом товаров и данные для входа с сайта.
Что показывает «Обзор»
- Статус аккаунта, подключён ли бот и привязан ли владелец.
- Тариф и сколько товаров в витрине из лимита. Если лимит превышен — видно, сколько товаров не показывается покупателям.
- Активные модули решения и быстрые переходы: каталог, шаблоны рассылок, «О компании», уведомления.
Вход с сайта, без МойСклад
- Обычно панель открывается прямо в окне МойСклад. Но в неё можно зайти и с сайта — по почте и паролю.
- Почта и пароль задаются внутри панели: карточка «Вход с сайта» на «Обзоре». Пароль — минимум 8 символов.
- Если панели под рукой нет, владелец открывает её из бота: кнопка «Войти в веб-панель» присылает одноразовую ссылку, она действует 3 минуты.
- Смена пароля завершает все открытые сеансы — на других устройствах нужно будет войти заново.
Подключение бота #
Для чего: Связывает вашего Telegram-бота с решением: через него клиенты видят каталог, оформляют заказы и получают уведомления.
Как создать бота и получить токен
- Откройте @BotFather в Telegram → команда /newbot.
- Задайте имя бота и username (должен заканчиваться на «bot»).
- BotFather пришлёт токен вида 123456789:ABC… — скопируйте его.
- Вставьте токен в поле «Токен бота» и нажмите «Подключить».
Привязка владельца
- После подключения появится ссылка владельца — перейдите по ней и нажмите Start.
- Владелец получает уведомления и доступ к служебным функциям бота.
Обязательная подписка на канал (необязательно)
- Укажите канал и включите тумблер — клиент должен подписаться на канал, прежде чем пользоваться ботом.
- Важно: бот должен быть администратором этого канала, иначе проверка не сработает.
Дополнительные вопросы при регистрации (необязательно)
- Включите нужные тумблеры — бот спросит у клиента дату рождения и пол сразу после имени.
- Ответы сохраняются и, для физлиц, записываются в карточку контрагента в МойСклад.
Тариф #
Для чего: Тарифы различаются только числом товаров в каталоге — все функции доступны на любом тарифе.
Как устроен тариф
- Тариф выбирается при установке решения в маркетплейсе МойСклад и меняется там же.
- Лимит по числу товаров: Базовый — 1000, Базовый+ — 5000, Премиум — 15000, Бизнес — 30000, Энтерпрайс — без ограничений.
- Если товаров больше лимита — показываются первые N (по группам и алфавиту), остальные скрыты. Владельцу приходит уведомление; чтобы показать все — смените тариф.
- Все функции (каталог, уведомления, рассылки, вакансии и т.д.) доступны на любом тарифе.
Каталог #
Для чего: Витрина ваших товаров прямо в Telegram (мини-приложение). Клиент выбирает товары, оформляет заказ, и заказ автоматически создаётся в МойСклад.
Склады и точки самовывоза
- Выберите склады, с которых показывать остатки — они суммируются, каталог единый для всех клиентов.
- Точки самовывоза — для клиента при самовывозе: название, склад точки и координаты на карте.
- Клиент выбирает точку при оформлении, заказ уходит на её склад; о заказе бот уведомляет сотрудников этой точки.
Сотрудники точек самовывоза
- Сотрудник привязывается к точке в «Каталог → Склады»; одного человека можно привязать к нескольким точкам.
- Заказ на самовывоз из точки уходит её сотрудникам: уведомление в Telegram получают все привязанные.
- Галочка «Есть аккаунт в МойСклад» — ставить ли сотруднику задачу к заказу. Без неё остаётся только уведомление в Telegram: это удобно для продавцов и курьеров, которых нет в МойСкладе.
- Задачу получает каждый сотрудник точки с привязкой к МойСклад — «ответственного» у точки нет, в отличие от менеджеров.
- Пока в заказе выбрана точка, менеджеры не получают ни уведомления, ни задачи — заказ ведёт точка.
- Заказы с доставкой — а также самовывоз, если точки не заведены, — уходят менеджерам: уведомление всем, задача одному по режиму.
- Если к точке не привязан ни один сотрудник, её заказы тоже уходят менеджерам — иначе заказ остался бы незамеченным.
- Задачи создаются только при включённом тумблере «Задача в МойСклад о новом заказе» — он общий и для точек, и для менеджеров.
Организация, тип цен, валюта
- Организация — от чьего юрлица оформляется заказ.
- Тип цен — какие цены из МойСклад показывать клиентам.
- Валюта каталога — в какой валюте видит цены клиент (конвертация по курсу МойСклад).
Товары и остатки
- Видимые группы товаров — какие категории показывать в каталоге. По ним же считается лимит тарифа.
- Показ остатков — показывать ли клиенту число «в наличии».
- Учёт остатков — нельзя заказать больше, чем есть на складе.
- Скрывать товары, которых нет в наличии — отдельный тумблер. Выключите его, если возите под заказ: тогда весь ассортимент остаётся на витрине, но заказать больше остатка всё равно нельзя.
- Осталось мало — показывать «Осталось N шт», когда остаток ниже порога.
- Резерв — резервировать товар в МойСклад при оформлении заказа.
Способы получения и доставка
- Самовывоз и доставка — включите нужные способы; клиент выберет при оформлении.
- Если выключены оба — заказ оформляется без выбора способа («обычный»).
- Плата за доставку — включите тумблер и укажите сумму. При доставке в заказ добавится услуга «Доставка».
- Адрес доставки клиент указывает текстом или отмечает точку на карте (менеджеру уходит ссылка-маршрут). Сохранённые в профиле адреса выбираются одним касанием.
Витрина (дизайн) и синхронизация
- Настройте цвета, вид карточек, баннеры; оформление можно сохранять пресетами.
- Товары, цены, остатки и фото подтягиваются из МойСклад сами. Обновить вручную и посмотреть, как идёт обновление, можно на вкладке «Синхронизация» — подробности в разделе «Синхронизация каталога».
Баннеры и скидки в витрине
- Баннеры — до шести штук вверху каталога: широкой каруселью или плитками в ряд. Баннер можно вести на группу товаров, конкретный товар или ссылку.
- Тумблер «Скидки в каталоге» показывает специальную цену из МойСклад: старая цена зачёркнута, рядом новая и бейдж со скидкой.
- Оформление витрины (цвета, фон, скругления, вид карточек и нижней панели) сохраняется шаблонами — можно держать несколько и переключаться.
Синхронизация каталога #
Для чего: Показывает, насколько витрина совпадает с МойСклад, и позволяет обновить её вручную. Обычно вмешательство не нужно — данные подтягиваются сами.
Как обновляются данные
- Изменения из МойСклад прилетают сами: правки товаров и цен собираются в очередь и разбираются пачками раз в минуту. Строка «Изменений ждёт обновления» показывает, сколько осталось.
- Каждую ночь проходит полная синхронизация — она подхватывает то, что могло потеряться днём.
- Если в МойСкладе идёт массовая загрузка товаров, каталог не дёргается на каждое изменение, а пересобирается целиком, когда загрузка закончится.
Обновить вручную
- Каталог → вкладка «Синхронизация» → кнопка «Обновить вручную». Пригодится, если нужно увидеть изменения немедленно.
- Проход идёт тремя этапами: остатки, товары с ценами, фото. Видно, какой этап идёт сейчас и сколько позиций обработано.
- Большой каталог обновляется несколько минут — панель при этом можно закрыть, проход не прервётся.
Кнопка «Остановить»
- Пока идёт обновление, рядом появляется кнопка «Остановить» — прогон прервётся, а витрина останется ровно такой, какой была. Ничего не потеряется.
- После остановки можно сразу запустить обновление заново.
Отчёт владельцу в Telegram
- Тумблер «Отчёт о ночной синхронизации» — бот присылает владельцу итог прошедшей ночи: товары, цены, остатки и фото.
- Если этап не удался, в отчёте будет причина — так поломка не остаётся незамеченной до первой жалобы покупателя.
Промокоды #
Для чего: Скидки по промокоду для клиентов: процент, фиксированная сумма или бесплатная доставка.
Как создать
- Раздел «Промокоды» → «Создать». Задайте код (например SALE10), тип скидки и её значение.
- Для скидки в процентах можно задать максимальную сумму: «30%, но не более 500 000». Корзина не блокируется — скидка просто не превысит эту сумму, и клиент увидит в корзине, что сработал максимум.
- Тип скидки: процент, фиксированная сумма или бесплатная доставка.
- Область действия: все товары, определённая группа или конкретные товары.
- Ограничения: срок действия, минимальная сумма заказа, общий лимит и лимит на одного клиента.
- Промокод можно временно отключить или отредактировать кнопкой «Изменить».
Как применяет клиент
- В корзине клиент вводит промокод и сразу видит пересчитанную сумму.
- Клиент может сохранить промокод в профиле и выбирать его в корзине одним касанием. Исчерпавшие лимит промокоды из профиля исчезают.
Сочетание со скидками МойСклад
- Если в МойСклад у товара своя специальная цена, при создании промокода выбирается правило: скидка идёт поверх спеццены или товары со спеццена́ми промокод не трогает.
- После сохранения это правило изменить нельзя — только создать промокод заново. Остальные поля редактируются свободно.
Онлайн-оплата (Click/Payme) #
Для чего: Приём онлайн-оплаты в боте через узбекские кассы Click и Payme.
Как подключить
- Каталог → вкладка «Онлайн платежи». Включите Click и/или Payme и заполните ключи из личного кабинета провайдера.
- Укажите счёт МойСклад, на который проводить входящие платежи.
- Скопируйте URL для кабинета провайдера (Prepare/Complete для Click, endpoint для Payme) и пропишите их в кабинете кассы.
- Тумблер «Резервировать оплаченные» — резервировать товар в МойСклад после оплаты.
Как платит клиент
- При оформлении клиент выбирает способ оплаты: наличные, Click или Payme.
- Оплата открывается в отдельном окне. Заказ в МойСклад создаётся только после успешной оплаты.
Что учесть при настройке
- Сначала выберите организацию на вкладке «Склады» — без неё платежи проводить не на что.
- Счёт зачисления указывается отдельно для Click и отдельно для Payme — можно развести поступления по разным счетам.
- Для Payme в кабинете кассы поле счёта (account) должно называться order_id — иначе платёж не свяжется с заказом.
- Есть тестовый режим Payme (песочница test.paycom.uz) — удобно проверить приём оплаты, не трогая живые деньги.
Рассылки #
Для чего: Разовая отправка сообщения всем клиентам бота — акции, новости, напоминания.
Как отправить
- Напишите текст. Можно вставить переменные:
{имя},{дата},{баланс},{баланс.00}— подставятся индивидуально. - При желании прикрепите фото (до 10 МБ) или видео (до 50 МБ) — таковы пределы Telegram. Видео тяжелее 50 МБ можно разослать из бота: там файл не проходит через наш сервер и ограничения по размеру нет.
- Нажмите «Отправить всем». Виден живой прогресс и история доставки.
Кому отправить
- По умолчанию сообщение уходит всем активным клиентам бота.
- Можно ограничить рассылку должниками: «Только клиентам с балансом ниже суммы». Баланс берётся из МойСклад; значение 0 оставит только тех, у кого баланс меньше нуля.
- Кнопка «Проверить получателей» заранее показывает, скольким клиентам уйдёт сообщение.
- Прикреплённый файл используется только для этой рассылки и удаляется сразу после отправки.
О компании #
Для чего: Заполняет раздел «О нас» в боте: описание компании, адреса на карте и фото.
Как заполнить
- Описание — текст о компании (показывается в разделе «О нас»).
- Адреса — название точки, адрес и координаты (клиент откроет на карте).
- Фото — одно изображение компании.
Менеджеры #
Для чего: Сотрудники, которые получают в Telegram уведомления о новых заказах и могут быть контактами для клиентов.
Добавление и привязка
- Добавьте менеджера — появится ссылка, отправьте её сотруднику, он нажмёт Start и привяжется.
- Тумблер «Уведомления» — получать ли уведомления о заказах.
- Тумблер «Контакт» — показывать ли менеджера в разделе «Написать менеджеру».
- Галочка «Есть аккаунт в МойСклад» — привязать менеджера к сотруднику МойСклад.
Задачи в МойСклад
- Владельцем заказов в МойСклад становится тот, кто установил решение.
- Тумблер «Задача в МойСклад о новом заказе» — создавать задачу сотруднику с привязкой. Режим: «Один ответственный» или «По очереди».
Про ссылку привязки
- Ссылка одноразовая и действует 30 минут: сотрудник должен открыть её сразу. Просроченную ссылку выдайте заново — это дешевле, чем вечная ссылка, по которой мог бы привязаться посторонний.
- Так же устроены ссылки для администраторов и HR-менеджеров.
Шаблоны уведомлений #
Для чего: Автоматические сообщения клиентам по событиям в МойСклад: новый заказ, отгрузка, оплата, бонусы и т.д.
Как настроить
- Выберите событие и напишите текст. У заказа три варианта: Доставка, Самовывоз и Обычный — настройте нужные отдельно.
- Вставляйте переменные. Суммы: без копеек
{сумма}и с копейками{сумма.00}; баланс{баланс.00}; для самовывоза —{адрес_склада}.
Печатные формы: ссылкой или файлом
{печ:Форма}— вставляет ссылку на печатную форму (PDF).{файл:Форма}— прикрепляет печатную форму PDF-ФАЙЛОМ прямо в сообщение (удобно для чека).
Важно
- Без настроенного шаблона по событию уведомление НЕ отправляется — это защита от спама.
Какие события доступны
- Документы МойСклад: заказ покупателя, отгрузка, возврат, счета, платежи и ордера, заказ поставщику, приёмка. Отдельно — операции бонусной программы: начисление и списание баллов.
- Можно указать, при изменении каких полей документа отправлять сообщение: статус, сумма, комментарий, состав позиций, дата, номер, отметка «проведён».
- Переменных много: номер и дата документа, контрагент и его телефон, организация, склад, валюта, статус, оплаченная сумма, адрес доставки, баллы и баланс бонусов. Список с описанием — прямо в редакторе шаблона.
Профиль клиента #
Для чего: Настройка кода/штрихкода, который клиент видит в профиле в боте (для касс и лояльности).
Как настроить
- Тип кода — штрихкод или QR-код. Источник значения — из какого поля брать код клиента.
- Клиент увидит свой код в разделе «Профиль» и покажет его на кассе.
Откуда берётся код
- Источник — номер телефона клиента либо номер дисконтной карты из карточки контрагента в МойСклад.
- Код создаётся один раз и сохраняется, поэтому профиль открывается мгновенно. При смене телефона или номера карты код перевыпускается сам.
- Если поменять тип кода или источник, коды всех клиентов сбрасываются и создаются заново при следующем открытии профиля.
Вакансии и HR #
Для чего: Публикация вакансий и приём откликов через бота. Есть простой режим и режим по филиалам с ролью HR-менеджера.
Два режима
- Общий — плоский список вакансий (заголовок, описание, фото).
- По филиалам — клиент выбирает город → филиал найма (с адресом и точкой на карте) → вакансии филиала.
Отклик и HR-менеджеры
- Клиент откликается: резюме (файлом или текстом) и телефон.
- HR-менеджер получает в боте ТОЛЬКО отклики (по одноразовой ссылке). Отклики приходят HR и, по тумблеру, владельцу.
- Под откликом — кнопки «Просмотрен» / «Отклонён»; первый нажавший фиксирует статус. О смене статуса можно уведомлять соискателя.
Отдельный бот для соискателей (HR-бот)
- Можно подключить второго бота — только для вакансий. Соискатели смотрят вакансии и откликаются в нём, не попадая в клиентскую базу магазина.
- Токен берётся у @BotFather так же, как для основного бота, и вставляется в разделе «Вакансии».
Дополнительные вопросы при отклике
- Тумблерами включаются вопросы о поле, дате рождения и адресе проживания — бот задаст их до резюме.
- Ответы видны в панели вместе с откликом, отдельно спрашивать не придётся.
Предложения и доработки #
Для чего: Отправить нам идею или пожелание по улучшению решения — прямо из панели.
Как отправить
- Вкладка «Предложения и доработки» → напишите сообщение и укажите хотя бы один контакт (Telegram, WhatsApp, e-mail или телефон).
Каталог и оформление заказа #
Для чего: Главная функция для клиента — выбрать товары и оформить заказ.
Как пользуется клиент
- Нажимает «Каталог» — открывается мини-приложение. Ищет товар, добавляет в корзину.
- В корзине может ввести промокод; при оформлении выбирает доставку или самовывоз, указывает адрес.
- Выбирает способ оплаты (наличные или онлайн Click/Payme, если включено). Оформляет заказ — он создаётся в МойСклад, клиент видит экран подтверждения.
Баланс и бонусы #
Для чего: Клиент видит свой баланс расчётов и бонусные баллы.
Как пользуется клиент
- Нажимает «Баланс» — видит задолженность или переплату (из МойСклад). При наличии бонусной программы — и баллы.
Акт сверки #
Для чего: Клиент сам получает акт сверки за нужный период — без обращения к вам.
Как пользуется клиент
- Нажимает «Акт сверки», выбирает период (месяц, полгода, год или даты) — получает акт со всеми документами, суммы в основной валюте.
Последний заказ #
Для чего: Быстрый повтор предыдущего заказа.
Как пользуется клиент
- Нажимает «Последний заказ» — видит его и может повторить: те же товары добавятся в корзину.
Написать менеджеру #
Для чего: Связь клиента с вашими менеджерами.
Как пользуется клиент
- Нажимает «Написать менеджеру» — видит менеджеров-контактов и пишет напрямую выбранному.
О нас / адреса #
Для чего: Информация о вашей компании для клиента.
Как пользуется клиент
- Нажимает «О нас» — видит описание, фото и адреса; по адресу открывает точку на карте.
Вакансии #
Для чего: Соискатель смотрит ваши вакансии и откликается прямо в боте.
Как пользуется соискатель
- Нажимает «Вакансии» — видит список; в режиме по филиалам сначала выбирает город и филиал, там же есть адрес и точка на карте.
- Откликается: отправляет резюме файлом или текстом и телефон. Если включены дополнительные вопросы — бот спросит пол, дату рождения и адрес.
- Отклик уходит HR-менеджерам и, по настройке, владельцу. О смене статуса соискателю может прийти уведомление.
Профиль #
Для чего: Личные данные клиента, код для касс и смена языка.
Как пользуется клиент
- Нажимает «Профиль» — видит данные и код/штрихкод; может сменить язык бота (русский / узбекский).
Профиль в каталоге #
Для чего: В мини-приложении у клиента есть свой профиль: адреса доставки, история покупок и сохранённые промокоды.
Что внутри
- Адреса доставки — клиент сохраняет адреса (с точкой на карте) и выбирает их при оформлении.
- История покупок — список отгрузок из МойСклад с составом заказа.
- Мои промокоды — сохранённые промокоды для быстрого выбора в корзине.
Избранное
- Сердечко на карточке товара добавляет его в избранное — клиент вернётся к нему с нижней панели каталога.
- Список привязан к клиенту, а не к устройству: он сохраняется между визитами.