Создать бота

Главный бот для создания личных ботов @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 пока бот заработает: обращаемся к нему по логину и проверяем, что он работает

Удалить бота

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

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

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

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

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

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

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

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

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

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

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

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

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

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

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

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

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

Рассылки

Очень часто, магазины собирают базу пользователей, например на бота Х подписано 100 человек и на бота У подписано 1000 человек, в какой-то момент, владелец решил провести акцию или привлечь покупателей покупать товар, в этом случае можно отправить сообщения всем 100 подписчикам бота Х и\или всем 1000 подписчикам бота У

Но есть ограничения телеграм ботов - 30 сообщений в секунду, тоесть если рассылка будет именно с этой скоростью тогда при открытии меню бота клиентом, бот не будет отвечать так как он занят рассылкой, поэтому рекомендуется ставить скорость к примеру 1 собщение в секунду

если пользователь А подписан на бота Х и бота У тогда он получит сообщение только от дного бота

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

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

Редактор страниц

Добавление кнопки "Магазин" в ваш тг канал

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

пример канала с кнопкой магазином

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

• В отце ботов @BotFather нажимаем /newapp
• После чего выбираем бота, для которого будете делать ссылку, бот должен быть Web
• После чего вводим имя веб апп, я бы сделал такой же как и имя бота
• После чего вводим краткое описание, такое же как и у бота
• После чего загружаем 640x360 картинку, подогнать под размер можно в онлайне или в фотошопе
• После чего загружаем анимацию или пропускаем командой /empty
• После чего вводим WEB APP URL - взять можно на админке, на странице боты, нажав на иконку сверху, ссылка имеет вид типа https://hidden.bots.botify.store/vip_pechat
• После чего вводим run - это чтобы ссылка для открытия бота была типа https://t.me/bot_login/run
• Всё копируем ссылку по которой можно открыть бота, проверь что всё работает, у меня эта ссылка такая https://t.me/pechat_vip_bot/VIP_PECHAT я вместо run написал VIP_PECHAT так как делал это впервые,но ты лучше пиши ран - запуск

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

• создадим бота для постов https://t.me/ControllerBot @ControllerBot открыли его дальше нужно создать собственного бота для постов в отце бота и дать токен этому боту, чтобы он им управлял
• в контрроллер боте жмём команду /addchannel
• создаём нового бота в отце бота например у меня это @BotifyControllerBot и полученый токен даём контроллер боту
• созданного бота только что добавляем в свой канал где назначаем его админом
• из канала пересылаем любое сообщение контроллер боту
• пишем город свой и подверждаем - всё бот создан, теперь можно делать посты с кнопками у меня этот бот @BotifyControllerBot у тебя - другой

Как только ты настроил бота для постинга, открывай его и создавай пост с кнопкой

• /start - и кнопка создать пост
• выбираешь любую разметку
• Вводишь текст поста, по желанию картинку и нажимаешь добавить URL кнопки
• водишь Магазин - https://t.me/yout_bot_name/run да-да это та самая ран (запуск из первого пункта для открытия бота) вместо your_bot_name подставь логин своего бота для которого ты настраивал веб апп, ссылку вы должны помнить с певрого пункта
• Дальше нажимаешь на клавиатуре Далее и там чуть позже опубликовать

Тип товара

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

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

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

Наличие

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

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

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

Варианты

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

Пример:

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

Расшифровка:

• Базовый товар: Майка боксёрская, название варианта - цвет, название под варианта - размер
• Значения варианта: красная, синяя
• Значения подварианта: L,XXL
• ещё есть дополнительная услугу для варианта, например упаковать в красивый пакет для подарка + 150 руб (да или нет)
• Пользователь сначала видит базовый товар, майку, потом выбирает какой цвет и только потом размер, дальше он соглашается или нет с доп услугой и только потом добавляет товар в коризну

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

Опт

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

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

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

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

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

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

Обьеденить в одну карточку

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

• Вариантами
• Обьеденить в одну карточку

В чём разница?

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

Что выбрать варианты или обьединение ? обьединение не работает в старом кнопочном боте! Определитесь, нужно ли вам показывать отдельно товары с разным цветом или другими характеристиками или все таки, вы хотите показывать один товар и просить выбрать вариации. Обратите внимание, что в случае вариантов товара, доступны вариант и под вариант тоесть 2 вариации + доп услугу. а в случае обьединения товара в одну карточку можно указать до 5 разных характеристик, которые можно выбрать ( цвет, размер, ширина, высота, вес )

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

Массовая загрузка с файла

Примеры файлов и коментарии находятся в разделе товары - действия - импорт с цсв файла

Киви

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

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

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

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

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

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

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

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

ЮМани для физ лиц

Можно принимать платежи на кошелёк и получать уведомления на наш сервер об оплатах

• Зарегистрировать кошелёк
• Пройти верификацию по паспорту онлайн и подтвердить её в личном кабине, когда всё ок у вас будет зелёная галочка и лимиты 600 000 руб
• Настроить веб хук уведомление https://yoomoney.ru/transfer/myservices/http-notification
• https://botify.store/api/v2/yoomoney/notification - адрес уведомления
• Создать кошелёк юмани на админке вашего магазина на нашем сервисе
• выставить заказ на рубль и провести оплату проверив что статус заказа изменился

Монобанк для ФОП

Можно принимать платежи на ФОП и получать уведомления на наш сервер об оплатах

• Зарегистрировать токен https://web.monobank.ua/

Платежи через телеграм

Для подключения платёжной системы идём в @BotFather потом /mybots выбираем бота, где хотим принимать платежи, после чего жмём Payments потом выбираем платёжку, которую хотели бы подключить, после чего жмём выбираем Live(Тест для теста) и получаем ключи, ключ будет написан в бот фазер

Копируем токен который дал вашему боту отец ботов, для других ботов нужен будет другой токен (возможно)

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

проверяем, что всё работает, обратите внимание, что у каждой валюты свой мин и макс порог, т.е для рублей заказ должен быть быть более 80 рублей. и менее 953662 конкретное значение берётся тут https://core.telegram.org/bots/payments/currencies.json

Платежи через крипто бот

Для подключения платёжной системы идём в криптобот потом /start,CryptoPay, выбираем создать приложение, API токен, копируем токен и даём его на админке в кошельки, потом настраиваем вебхук в том же крипто боте, вместо меню АПИ токен жмем вебхуки, включаем и даём ссылку https://botify.store/api/v2/CryptoBot/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 дней если нету оплаты.

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

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

• годовой
• месячный

• только боты
• только сайты
• Боты, Сайты

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

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

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

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

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

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

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

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

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

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