Создать бота
Внимание
При создании бота, убедитесь, что вы используете его только на нашей платформе. Если бот уже есть, тогда поменяйте токен и добавьте его в нашу админку. Если использовать одного бота в разном программном продукте, будут конфликты и бот может отвечать через раз.
Главный бот для создания личных ботов @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 пока бот заработает:
обращаемся к нему по логину и проверяем, что он работает
Инфо
После создания бота, можно поменять его имя (не логин), тоже через отца ботов, так же добавить его описание, картинку
- /setname - сменить имя
- /setdescription - сменить описание
- /setabouttext - сменить био
- /setuserpic - сменить картинку
Удалить бота
Для удаления бота достаточно просто удалить его с админ панели и он отключится
Чтобы наверняка:
Пишем в отце ботов команду /revoke после чего выбираем бота и токен меняется
Если вы не удалите бота с админки и поменяете токен - система решит, что бота забанили и статус будет красным.
А если я хочу полностью удалить бота:
Смысла особо нету, бот просто станет не рабочим, без картинки и логина а сообщения и история останутся, вы потеряете базу клиентов и возможность делать рассылки по ним
Точно хочу удалить бота чтобы освободить логин:
Пишем в отце ботов команду /deletebot освободится ли логин - не знаю.
Ограничения ботов
Каждый отдельный бот может отсылать максимум 30 сообщений в секунду (всем) или 2 сообщения в секунду конкретному человеку. Если превысить ограничения, тогда появятся задержки.
Если 600 человек будут одновременно писать боту сообщения, то какое-то время бот может не отвечать реальному клиенту, так как он перегружен, это будет длиться до тех пор, пока телеграм не забанит спамеров
С учетом того, что бот отправляет сразу 6 товаров (картинок) это значит что только 5 человек одновременно могут просматривать товары, другие будут получать секундную задержку или чуть более, зависит от количества пользователей
Чтобы обойти эти ограничения можно создать много ботов зеркал, которые будут одинаковые в плане функций и контента но разные в плане логинов
Желательно, чтобы часть пользователей пользовалась ботом Х а другая часть ботом У и так далее
Несколько ботов
Чтобы торговать в разных ботах под разными "шкурами" используй функцию под магазинов
- Используй кнопку магазины, чтобы открыть список магазинов или создать новый а так же для переключения между магазинами
- У каждого магазина в вашей сети, будет свой список товаров настроек и ботов
- Переключайся с магазина А на магазин Б в пару кликов, не нужно создавать новую админку с доменом для этих целей
- Удалить магазин пока что нельзя но мы сделаем эту кнопку.
- У всех магазинов в сети один и тот же тариф, тоесть если картинок можно максимум 5000, то это касается не каждого магазина а всех. ограничения на всю сеть. а не отдельный магазин.
Внимание
У каждого магазина в сети свой набор пользователей.
Инфо
Чтобы попасть на сайт магазина из сети нажми кнопку логотипа
Тариф
У всей сети единый тариф и ограничения
Тип товара
Всё начинается с того, что товар бывает физический или цифровой, например телефон, трусы или кальян - физический товар, а вот ссылка на приватное видео с уроком - цифровой товар.
Если товар цифровой- Нету выбора способа доставки или способа оплаты а так же возврата, купил получил - всё.
- Тип товара или ссылка где может быть что угодно в рамках закона либо просто файл.
Если товар физический- Получить можно товар либо по предоплате или при получении, можно гибридным способом, когда предоплата за отправку а остальная сумма при получениив в таком случае требуется дать реквезиты на предоплату вручную и поставить заметку у заказа что предоплату получил и сумму
- Способо доставки или курьером или отправкой или самовывоз
Внимание
У магазина может быть как и физический так и цифровой товар, но в корзину попадает только один тип товара, тоесть если покупатель хочет купить ссылку и футболку - ему нужно делать два разных заказа
Наличие
Дальша товар или бесконечный или конечный (10 штук или больше)
Если товар цифровой- Если товар бесконечный, тогда ссылки или файл продаются всем пользователям.
- Если товар конечный, тогда ссылку или файл получит только один пользователь.
- Нельзя получить товар без оплаты, ссылки или файлы видно только на админке либо в истории после оплаты, кто купил тот и видит, смена ника или подбор индификаторов для получения товара - не сработают
- Историю чужого пользователя можно просмотреть только лишь получив доступ к его учётной записи, поэтому рекомендуется использовать разные пароль на всех сервисах, либо двух факторную аутификацию.
Если товар физический- Если товар бесконечный, тогда всё просто
- Если товар конечный, тогда нужно указать ещё а где именно находится товар, в каком магазине(складе) и в каком количестве
- Если товар конечный, тогда может быть так, что он ещё и находится одновременно на разных складах с разным количеством, тогда пользователю нужно выбрать где именно он хочет купить товар или система подберёт точку сама
Варианты
У товара есть варианты, у каждого варианта своя цена, но одинаковое имя, описание, картинка, название вариант, под варианта
- Майка боксёрская, красная, XXL - 1500 рублей
- Майка боксёрская, синяя, XXL - 1500 рублей
- Майка боксёрская, красная, L - 1200 рублей
(вариант) имя: Размер значения: L,XXL
(под-вариант) имя: Цвет значения: красная, синяя
ещё есть дополнительная услугу для варианта, например упаковать в красивый пакет для подарка + 150 руб (да или нет)
Если товар конечный- Тогда наличие товара указывается для каждого варианта отдельно
Внимание
У каждого варианта свой набор характеристик, наличия, опта. количество покупок прибавляется для базового товара, который является контейнером вариантов.
Опт
Если одна единица товара стоит 100 рублей то 100 едениц товара могут стоять уже 90 рублей за еденицу, а 200 уже 80 руб за еденицу, опт существует как и для варианта товара так и для базового товара без вариантов
Цена на товары в корзине считается в момент добавления товара или в момент его удаления с учётом существования оптового предложения
При удалении опта существующие корзины не пересчитываются, цена меняется только для новых элементов добавляемых в корзины
Характеристика
У всех товаров может быть общая характеристика, например страна производитель - Россия или цвет, красный или синий, удобно для поиска а так же фильтрации товара
При заполнении характеристик, важно использовать уже существующие, например Красный или красный - разные.
ЮКасса (яндекс касса)
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 штук
Тип заказа
или цифровой или физический, ссылки или файлы цифрового заказа видны после оплаты и остаются в истории 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) // ничего нельзя
*/
Магазины
Сущность магазин - принадлежит сети, у каждого магазина отдельная база данных, свой домен и т.д, но все магазины пренадлежат одной сети, у которой есть тариф, который общий для всех магазинов.
Тарифы
Тариф принадлежит сети, не важно, сколько у сети магазинов: один или несколько, весь исходящий трафик, количество хранимых изображений считаются для всех магазинов сети, т.е для сети.
Магазин можно удалить, удаление призойдёт через 3 дня, в течении 3х дней можно отменить удаление.
Магазин удаляется через 60 дней если нету оплаты.
Если магазин нарушает Законодательство, он может быть забанен а уже потом удалён или удалён сразу.
Внимание
Исходящий трафик, это когда пользователь загружает картинку, сервер отдаёт эту картинку пользователю и считает сколько мегабайт, он передал. в среднем изображение имеет размер 100кб
Внимание
Для некоторых ресурсов существует кеширование, тоесть если пользователь просматривает картинку или страничку несколько раз, то оно загружается только один раз, а все последующие загрузки выполняются из памяти браузера.
Внимание
Мы считаем отдельно исходящий трафик для картинок и для страничек
Внимание
Обьем изображений хранимых магазином считается отдельно, и не имеет никакого отношения к исходящему трафику.
Внимание
Когда магазин потребляет больше трафика (обычного), чем доступно, скорость отправки данных замедляется, чтобы не израсходовать квоту.
Внимание
Когда магазин потребляет больше трафика (изображения), чем доступно, вместо оригинального изображения отправляется шаблонное.
Существует несколько тарифов
- только боты
- только сайты
- Боты, Сайты
- бесплатный (10 дней)
- процент от продаж (с ограничениями)
- VIP (без ограничений или индивидуально)
- Начинающий
- Средний
- Бизнес
Вы всегда можете перейти с тарифа на тариф при этом оплатив новый тариф. Исключение: тарифы с оплатой процент от продаж
Для перехода на тариф ВИП, нужно обратиться конкрено в тех поддержку и мы изучим ваши обьемы и предоставим отдельные вычислительные мощности и, если требуется, ограничения
Если текущий тариф процент от продаж, то перейти на бизнес можно лишь в том случае, если сумма платежа за период не превышает сумму тарифа бизнес, в противном случае сначало требуется погасить долг
Внимание
В тарифах процент от продаж или ВИП, учитываются только успешные заказы с оплатой онлайн, по умолчанию оплата при получении отключена, но мы можем включить и её при условии, что магазин совершает адекватный обьём продаж за оба варианта оплат.
Во всех случаях, кроме ВИП тарифа, имеются ограничение на отдачу трафика и картинок в месяц и день, в конце каждого дня по вашей часовой зоне, счётчики обнуляются. месячный счётчик обнуляется каждые 30 дней.
Внимание
Если вас не устраивает ограничения на трафик, хранимые картинки - это можно изменить в индивидуальном порядке, цена за гб трафика сверх нормы - 1,70 руб. цена за каждый хранимый гб картинок в месяц - 2,30 руб.
За 3 дня до окончания тарифного плана, вам выставляется счёт на оплату
Счёт на оплату так же выставляется при смене тарифа
При оплате счёта сбрасываются ограничения, меняется дата начала тарифа и конца тарифа
Если у вас ещё не закончился тариф а вы перешли на новый, тогда к окончанию старого тарифа добавляется 30 дней, плюс, оставшийся трафик добавляется к трафику нового тарифа. Вы ничего не теряете.
В случае, когда тариф процент от продаж, дата добавляется к дате создания платежа оплаты т.к оборот считался именно в тот момент.
Внимание
Ограничения по трафику есть везде: почта, телеграм, другие сервисы, просто много кто об этом не пишет или не знает.