Телеграм боты Изменено: 2023-11-11

Каждый магазин может создать как одного так и нескольких телеграм ботов, 10 ботов могут быть одинаковыми, только иметь разный логин, зачем ? например потому, что каждый бот имеет ограничение: 30 сообщений в секунду или максимум 2 сообщения в секунду на чат, чтобы обойти это ограничение, можно создать много ботов зеркал.

Чтобы создать бота, нужен телеграм аккаунт и обрашение к главному боту. Как именно смотри в разделе создать бота.

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

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

Вы можете создать несколько ботов, которые будут торговать разным товаром или просто отличаться друг от друга. Для этого не нужно создавать новый магазин, проше создать под-магазин, для быстрого переключения с админ панели (вкладка сеть, ниже плюсик)

Рассылки

После того, как пользователь обратился к боту и нажал кнопку старт (/start) он подписался на то, что бот сохранил его чат в базу и теперь бот может делать рассылки клиенту, если клиент захочет отписаться от рассылок, он просто остановит бота у себя, рассылки перестанут приходить но пользователь останется в нашей базе. пользователь для бота это номер чата, который нельзя поменять, так что если пользователь меняет логин то для бота ничего не значит.

Создать бота

Внимание

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

Главный бот для создания личных ботов @BotFather

Порядок действий, чтобы получить свой токен
  • В отце ботов ввести команду: /newbot
  • отец спросит название: пишем отображаемой имя бота, можно на русском и с пробелами
  • отец спросит уникальный логин: логин должен быть на англ яз без пробелов и спец символов, после букв можно цифры или _, в конце bot. если пишем mytest234234bot тогда логин будет @mytest234234bot, если логин уже занят - нужно будет придумать другой
  • если логин можно использовать отец даст вам токен бота: Use this token to access the HTTP API: 1651631985:AAEbU9_Qbp_zmHDM6RyseHXh-buHaKaxhdU
  • Нажимаем на токен, чтобы скопировать: 1651631985:AAEbU9_Qbp_zmHDM6RyseHXh-buHaKaxhdU
  • Идёт на админку, раздел боты, кнопка создать вводим туда токен: 1651631985:AAEbU9_Qbp_zmHDM6RyseHXh-buHaKaxhdU
  • Ждём, секунд 5 пока бот заработает: обращаемся к нему по логину и проверяем, что он работает

Инфо

После создания бота, можно поменять его имя (не логин), тоже через отца ботов, так же добавить его описание, картинку

  1. /setname - сменить имя
  2. /setdescription - сменить описание
  3. /setabouttext - сменить био
  4. /setuserpic - сменить картинку

Удалить бота

Для удаления бота достаточно просто удалить его с админ панели и он отключится

Чтобы наверняка:

Пишем в отце ботов команду /revoke после чего выбираем бота и токен меняется

Если вы не удалите бота с админки и поменяете токен - система решит, что бота забанили и статус будет красным.

А если я хочу полностью удалить бота:

Смысла особо нету, бот просто станет не рабочим, без картинки и логина а сообщения и история останутся, вы потеряете базу клиентов и возможность делать рассылки по ним

Точно хочу удалить бота чтобы освободить логин:

Пишем в отце ботов команду /deletebot освободится ли логин - не знаю.

Ограничения ботов

Каждый отдельный бот может отсылать максимум 30 сообщений в секунду (всем) или 2 сообщения в секунду конкретному человеку. Если превысить ограничения, тогда появятся задержки.

Если 600 человек будут одновременно писать боту сообщения, то какое-то время бот может не отвечать реальному клиенту, так как он перегружен, это будет длиться до тех пор, пока телеграм не забанит спамеров

С учетом того, что бот отправляет сразу 6 товаров (картинок) это значит что только 5 человек одновременно могут просматривать товары, другие будут получать секундную задержку или чуть более, зависит от количества пользователей

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

Желательно, чтобы часть пользователей пользовалась ботом Х а другая часть ботом У и так далее

Несколько ботов

Чтобы торговать в разных ботах под разными "шкурами" используй функцию под магазинов

  1. Используй кнопку магазины, чтобы открыть список магазинов или создать новый а так же для переключения между магазинами
  2. У каждого магазина в вашей сети, будет свой список товаров настроек и ботов
  3. Переключайся с магазина А на магазин Б в пару кликов, не нужно создавать новую админку с доменом для этих целей
  4. Удалить магазин пока что нельзя но мы сделаем эту кнопку.
  5. У всех магазинов в сети один и тот же тариф, тоесть если картинок можно максимум 5000, то это касается не каждого магазина а всех. ограничения на всю сеть. а не отдельный магазин.

Внимание

У каждого магазина в сети свой набор пользователей.

Инфо

Чтобы попасть на сайт магазина из сети нажми кнопку логотипа

Тариф

У всей сети единый тариф и ограничения

Товары

Товар это контейнер для вариантов, опта, характеристики, отзывов, так же он содержит количество покупок. категории к которым он относится.

При удалении товара удаляются все сопутствующие элементы, включая корзины и заказы.

Исключая отзывы.

Тип товара

Всё начинается с того, что товар бывает физический или цифровой, например телефон, трусы или кальян - физический товар, а вот ссылка на приватное видео с уроком - цифровой товар.

Если товар цифровой
  • Нету выбора способа доставки или способа оплаты а так же возврата, купил получил - всё.
  • Тип товара или ссылка где может быть что угодно в рамках закона либо просто файл.
Если товар физический
  • Получить можно товар либо по предоплате или при получении, можно гибридным способом, когда предоплата за отправку а остальная сумма при получениив в таком случае требуется дать реквезиты на предоплату вручную и поставить заметку у заказа что предоплату получил и сумму
  • Способо доставки или курьером или отправкой или самовывоз

Внимание

У магазина может быть как и физический так и цифровой товар, но в корзину попадает только один тип товара, тоесть если покупатель хочет купить ссылку и футболку - ему нужно делать два разных заказа

Наличие

Дальша товар или бесконечный или конечный (10 штук или больше)

Если товар цифровой
  • Если товар бесконечный, тогда ссылки или файл продаются всем пользователям.
  • Если товар конечный, тогда ссылку или файл получит только один пользователь.
  • Нельзя получить товар без оплаты, ссылки или файлы видно только на админке либо в истории после оплаты, кто купил тот и видит, смена ника или подбор индификаторов для получения товара - не сработают
  • Историю чужого пользователя можно просмотреть только лишь получив доступ к его учётной записи, поэтому рекомендуется использовать разные пароль на всех сервисах, либо двух факторную аутификацию.
Если товар физический
  • Если товар бесконечный, тогда всё просто
  • Если товар конечный, тогда нужно указать ещё а где именно находится товар, в каком магазине(складе) и в каком количестве
  • Если товар конечный, тогда может быть так, что он ещё и находится одновременно на разных складах с разным количеством, тогда пользователю нужно выбрать где именно он хочет купить товар или система подберёт точку сама

Варианты

У товара есть варианты, у каждого варианта своя цена, но одинаковое имя, описание, картинка, название вариант, под варианта

  • Майка боксёрская, красная, XXL - 1500 рублей
  • Майка боксёрская, синяя, XXL - 1500 рублей
  • Майка боксёрская, красная, L - 1200 рублей

(вариант) имя: Размер значения: L,XXL

(под-вариант) имя: Цвет значения: красная, синяя

ещё есть дополнительная услугу для варианта, например упаковать в красивый пакет для подарка + 150 руб (да или нет)

Если товар конечный
  • Тогда наличие товара указывается для каждого варианта отдельно

Внимание

У каждого варианта свой набор характеристик, наличия, опта. количество покупок прибавляется для базового товара, который является контейнером вариантов.

Опт

Если одна единица товара стоит 100 рублей то 100 едениц товара могут стоять уже 90 рублей за еденицу, а 200 уже 80 руб за еденицу, опт существует как и для варианта товара так и для базового товара без вариантов

Цена на товары в корзине считается в момент добавления товара или в момент его удаления с учётом существования оптового предложения

При удалении опта существующие корзины не пересчитываются, цена меняется только для новых элементов добавляемых в корзины

Характеристика

У всех товаров может быть общая характеристика, например страна производитель - Россия или цвет, красный или синий, удобно для поиска а так же фильтрации товара

При заполнении характеристик, важно использовать уже существующие, например Красный или красный - разные.

Платежные системы

Каждая платежная система имеет свой набор требований, но работают +- по одному шаблону, например, как только платежная система (тинькоф или юкасса или киви) получает успешный платеж, она сразу же отсылает уведомление на наш сервер об успехе, наш сервер проверяет, что нотификация не поддельная и помечает заказ, как оплачен, ставит время.

для подключения платежных систем требуется ИП и обращение через сайт провайдера, для киви, раньше, требовалось только фото паспорта и можно было получить приватный и публичный ключ через их сайт, сейчас выпуск ключей остановлен, но старые ключи работают, не путайте киви ключи с АПИ токеном кошелька, это разные вещи.

Платежные системы, все кроме тинькоф, должны знать, на какой адрес нужно отсылать уведомления, поэтому адресс пуш нотификации (HTTP уведомления) нужно указывать на их сайте отдельно, для тинькоф мы делаем это автоматически во время выставления платежа

ЮКасса (яндекс касса)

YoKassa (интеграция по АПИ) https://yookassa.ru/connection/ нужно заполнить данные паспорта ИП налоговых, дать ссылку на сайт или бота где будете продавать, указать цель и дальше вам выдадут ключ АПИ и айдишник магазина, которые нужно передать на админку, чтобы активировать платежную систему, потом нужно будет настроить уведовления на админке юкассы, указав адрес получения уведомлений https://botify.store/api/v2/yookassa/notification

  • Подать документы
  • Получить секретный ключ и индификатор магазина
  • Создать кошелёк юкассы на админке вашего магазина на нашем сервисе
  • Настроить HTTP уведомления на админке юкассы, нам нужно только уведомления об оплате https://botify.store/api/v2/yookassa/notification
  • выставить заказ на рубль и провести оплату проверив что статус заказа изменился

Тинькоф бизнесс (интернет эквайринг)

Tinkoff (интернет эквайринг (касса) https://www.tinkoff.ru/kassa/ для приема платежей на своём сайте )

  • Подать документы
  • Получить терминал и пароль https://business.tinkoff.ru вкладка интернет эквайринг -> магазины -> терминалы (см. скриншот ниже)
  • Создать кошелёк тинькоф на админке вашего магазина на нашем сервисе
  • выставить заказ на рубль и провести оплату проверив что статус заказа изменился

Киви

Для работы API потребуются публичный и секретный ключи. Ключи создаются в личном кабинете после регистрации и подключения на kassa.qiwi.com или p2p.qiwi.com.

  • Подать документы p2p.qiwi.com (уже не актуально, нужны только старые ключи)
  • Получить публичный и приватный ключ
  • Создать кошелёк киви на админке вашего магазина на нашем сервисе
  • Добавить адресс HTTP уведомления на админке https://botify.store/api/v2/qiwi/notification
  • выставить заказ на рубль и провести оплату проверив что статус заказа изменился

Корзины

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

Для сайта, тоже создаются корзины, но корзина удаляется в тот момент, когда удаляется сессия.

Товар резервируется в момент, когда товар добавляется в корзину, при резервации отнимается наличие товара на определённом складе, а при очистке корзины (кроме случаем создания заказа), резервация возвращается.

Возможно установить максимально число товаров в корзине

При резервации товара, система пытается подобрать товар с одного и того же склада, если это возможно

Тип корзины

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

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

если товар конечный, то мы резервируем конкретное кол-во наличия с опрёделенного магазина(склада)

Магазины

У каждого магазина свой набор корзин, сделать заказ с корзины магазина Х на магазине У невозможно.

Варианты товара

Для каждого варианта товара в корзине создаётся отдельная сущность, например футболка боксёрская, красная 2 штуки, футболка боксёрская, синяя 10 штук

Заказы

Существует несколько типов заказов
  • Цифровой оплата онлайн
  • Самовывоз оплата при получении
  • Самовывоз предоплата
  • Доставка предоплата
  • Доставка оплата при получении
  • Курьер оплата при получении
  • Курьер предоплата

у каждого типа заказов свой набор статусов, статус меняется либо автоматически (при оплате) или клиентом (отмена) или администратором (заказ упакован)

всегда сохраняется история изменений статуса где есть время, статус и кто поменял его

у заказа есть метки, чтобы по меткам было удобно искать, например метка "предоплачен" может быть у сотни заказов, и их можно будет легко найти на админке

на оплату заказа онлайн даётся 60 минут, каждые 10 минут пользователю приходит напоминание, если оплаты нету заказ отменяется, резервация наличия снимается.

пользователь может отменить заказ, если он его ещё не оплатил в течении 60 минут, или отменить заказ, если менеджер не успел сменить статус с "новый"

У нас нету возможности добавить свои статусы, но есть возможность поменять имя статусов, а если вам нужен свой статус - используйте метки

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

Для каждого заказа, есть комментарии, которые видит только администрация, там можно писать что угодно, например я принял предоплату 1000 руб и дата когда а так же номер квитанции сбербанка

Если вы удаляете товар, который уже есть в заказе, тогда этот товар пропадёт с заказа, но цена заказа останется прежней.

При удалении точки(склад или магазин) у заказа не будет показываться где именно находится товар(откуда его купили)

Тип заказа

или цифровой или физический, ссылки или файлы цифрового заказа видны после оплаты и остаются в истории 30 дней, потом удаляются

Способ доставки

Или Почтой или самовывоз или курьером у каждого способа свой набор требуемых данных, которые пользователь вводит

Статусы заказа

							 //ЦИФРОВОЙ (3)
    /**
     * Ожидаю оплату            (1) // можно подтвердить платеж или отменить
     * Отменен                  (2) // ничего нельзя сделать
     * Ошибка оплаты            (3) // ничего нельзя сделать
     * Исполнен                 (4) // ничего нельзя сделать
     */

    //САМОВЫВОЗ  ПРИ ПОЛУЧЕНИИ (1)
    /**
     * Новый                    (1) // можно отменить заказ или согласовываю
     * Отменен (вернуть запас)  (2) // ничего нельзя сделать
     * Согласовываю (вызвон)    (3) // можно отменить заказ или подтвердить
     * Подготовка              (4) // можео отменить  заказ или оповестить о готовности
     * Готов (оповещение)       (5) // можно отменить  заказ или исполнить
     * Исполнен                 (6) // можно сделать возврат
     * Вернули (вернуть запас)  (7) // ничего нельзя сделать
     */

    //САМОВЫВОЗ  ПРЕДОПЛАТА (4)
    /**
     * Ожидаю оплату            (1) // можно отменить заказ или согласовываю
     * Отменен                  (2) // ничего нельзя сделать
     * Ошибка оплаты            (3) // ничего нельзя сделать
     * Согласовываю (вызвон)    (4) // можно отменить заказ или подтвердить
     * Подготовка              (5) // можео отменить заказ или оповестить о готовности
     * Готов (оповещение)       (6) // можно отменить заказ или исполнить
     * Исполнен                 (7) // можно сделать возврат
     * Вернули (вернуть запас)  (8) // ничего нельзя сделать
     */

    //ОТПРАВКА ПОЧТОЙ ПРЕДОПЛАТА (5)
    /**
     * Ожидаю оплату            (1) // можно отменить заказ или согласовываю
     * Отменен                  (2) // ничего нельзя сделать
     * Ошибка оплаты            (3) // ничего нельзя сделать
     * Согласовываю             (4) // можно отменить заказ или подтвердить
     * Подготовка              (5) // можео отменить заказ или оповестить о готовности
     * Собран                   (0)
     * Отправлен                (6) // можно В процессе возврата или доставлен
     * Доставлен                (7) // можно исполнить или в процессе возврата
     * В процессе возврата      (8) // можно вернули
     * Вернули                  (9) // ничего нельзя
     * Исполнен                 (10) // ничего нельзя
     */

    //ОТПРАВКА ПОЧТОЙ ПРИ ПОЛУЧЕНИИ (2)
    /**
     * Новый                    (1) // можно отменить заказ или согласовываю
     * Отменен                  (2) // ничего нельзя сделать
     * Согласовываю             (4) // можно отменить заказ или подтвердить
     * Подготовка              (5) // можео отменить заказ или оповестить о готовности
     * Собран                   (0)
     * Отправлен                (6) // можно В процессе возврата или доставлен
     * Доставлен                (7) // можно исполнить или в процессе возврата
     * В процессе возврата      (8) // можно вернули
     * Вернули                  (9) // ничего нельзя
     * Исполнен                 (10) // ничего нельзя
     */
						

Сеть

Если у вас несколько бизнесов, например продажа одежды и доставка еды, то, вероятно, вам нужно 2 отдельных магазина, вот только владелец у них один. А значит, админ панель, жетально, тоже должна быть одной, чтобы легко переключиться с одного магазина на другой, посмотреть общую статистику или сделать оплату за аренду. У каждого магазина может быть свой менеджер. Который имеет доступ к конкретному магазину.

Магазины

Сущность магазин - принадлежит сети, у каждого магазина отдельная база данных, свой домен и т.д, но все магазины пренадлежат одной сети, у которой есть тариф, который общий для всех магазинов.

Тарифы

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

Магазин можно удалить, удаление призойдёт через 3 дня, в течении 3х дней можно отменить удаление.

Магазин удаляется через 60 дней если нету оплаты.

Если магазин нарушает Законодательство, он может быть забанен а уже потом удалён или удалён сразу.

Внимание

Исходящий трафик, это когда пользователь загружает картинку, сервер отдаёт эту картинку пользователю и считает сколько мегабайт, он передал. в среднем изображение имеет размер 100кб

Внимание

Для некоторых ресурсов существует кеширование, тоесть если пользователь просматривает картинку или страничку несколько раз, то оно загружается только один раз, а все последующие загрузки выполняются из памяти браузера.

Внимание

Мы считаем отдельно исходящий трафик для картинок и для страничек

Внимание

Обьем изображений хранимых магазином считается отдельно, и не имеет никакого отношения к исходящему трафику.

Внимание

Когда магазин потребляет больше трафика (обычного), чем доступно, скорость отправки данных замедляется, чтобы не израсходовать квоту.

Внимание

Когда магазин потребляет больше трафика (изображения), чем доступно, вместо оригинального изображения отправляется шаблонное.

Существует несколько тарифов

  • годовой
  • месячный
  • только боты
  • только сайты
  • Боты, Сайты
  • бесплатный (10 дней)
  • процент от продаж (с ограничениями)
  • VIP (без ограничений или индивидуально)
  • Начинающий
  • Средний
  • Бизнес

Вы всегда можете перейти с тарифа на тариф при этом оплатив новый тариф. Исключение: тарифы с оплатой процент от продаж

Для перехода на тариф ВИП, нужно обратиться конкрено в тех поддержку и мы изучим ваши обьемы и предоставим отдельные вычислительные мощности и, если требуется, ограничения

Если текущий тариф процент от продаж, то перейти на бизнес можно лишь в том случае, если сумма платежа за период не превышает сумму тарифа бизнес, в противном случае сначало требуется погасить долг

Внимание

В тарифах процент от продаж или ВИП, учитываются только успешные заказы с оплатой онлайн, по умолчанию оплата при получении отключена, но мы можем включить и её при условии, что магазин совершает адекватный обьём продаж за оба варианта оплат.

Во всех случаях, кроме ВИП тарифа, имеются ограничение на отдачу трафика и картинок в месяц и день, в конце каждого дня по вашей часовой зоне, счётчики обнуляются. месячный счётчик обнуляется каждые 30 дней.

Внимание

Если вас не устраивает ограничения на трафик, хранимые картинки - это можно изменить в индивидуальном порядке, цена за гб трафика сверх нормы - 1,70 руб. цена за каждый хранимый гб картинок в месяц - 2,30 руб.

За 3 дня до окончания тарифного плана, вам выставляется счёт на оплату

Счёт на оплату так же выставляется при смене тарифа

При оплате счёта сбрасываются ограничения, меняется дата начала тарифа и конца тарифа

Если у вас ещё не закончился тариф а вы перешли на новый, тогда к окончанию старого тарифа добавляется 30 дней, плюс, оставшийся трафик добавляется к трафику нового тарифа. Вы ничего не теряете.

В случае, когда тариф процент от продаж, дата добавляется к дате создания платежа оплаты т.к оборот считался именно в тот момент.

Внимание

Ограничения по трафику есть везде: почта, телеграм, другие сервисы, просто много кто об этом не пишет или не знает.