Перейти к основному содержимому

• Магазин - Настройка

1. Структура конфигурации магазина​

Для интеграции товаров или услуг в вашего бота необходимо создать файл конфигурации а затем загрузить фаил с названием shop.json () . Пример структуры:

  • sku: Уникальный идентификатор товара.
  • name: Название товара или услуги.
  • category: Категория товара.
  • attribute: Массив доступных опций (например, разные тарифы).
    • name: Название опции (например, "Тариф: ASSIST").
    • description: Описание товара или услуги.
    • price: Цена.
    • images: Ссылки на изображения товара.
    • links: Ссылки для покупки или подробной информации.
  • currency: Информация о валюте (например, комиссия за оплату в STARS).

Пример конфигурации:​

{
  "sku": "ASSIST",
  "name": "Тариф: ASSIST",
  "category": "AIMANAGER|BOT",
  "attribute": [
    {
      "name": "1 месяц",
      "description": "Описание услуги. Подробнее по ссылке.",
      "price": 4.99,
      "images": ["https://example.com/image.jpg"],
      "links": [
        {
          "text": "Купить",
          "url": "https://example.com/buy"
        },
        {
          "text": "Подробнее о тарифе",
          "url": "https://example.com/ASSIST"
        }
      ]
    }
  ],
  "currency": {
    "STARS": {
      "text": "Купить за",
      "commission": "130%/0.015"
    }
  }
}

2. Включение inline-режима в BotFather​

Чтобы карточки магазина работали в боте, выполните следующие шаги:

  1. Перейдите в BotFather и выберите вашего бота.
  2. Введите команду /setinline.
  3. Укажите ключевое слово для поиска (например, shop или catalog) и включите inline-режим.
  4. Для включения обратной связи используйте команду /setinlinefeedback.

3. Советы по настройке​

  • Изображения: Убедитесь, что все ссылки на изображения и товары актуальны.
  • Оплата: В currency можно указать оплату в звездах ⭐️ (только "STARS") а также другие платежные шлюзы в последствии (например, TON или USDT или настроенные через BotFather).

Теперь ваш бот готов к интеграции с магазином и использованию интерактивных карточек!

3. Ограничения (бета)​

  • ITEMS_PER_PAGE = 5; // Количество элементов на страницу
  • MAX_NAME_LENGTH = 25; // Максимальная длина для поля "name"
  • MAX_DESCRIPTION_LENGTH = 370; // Максимальная длина для поля "description"
  • MAX_SKU_LENGTH = 10; // Максимальная длина для поля "sku"
  • MAX_CATEGORY_LENGTH = 10; // Максимальная длина для поля "category"

3. Возможны проблемы при чтении специальных символов Marckdown в именах и описаниях или обрезании описания карточки из-за ссылок или одиночных спецсимволов (бета)​

Полный пример конфигурации:​

{
  "catalog": [
    {
      "sku": "ASSIST",
      "name": "Тариф: ASSIST",
      "category": "- ТАРИФЫ -",
      "attribute": [
        {
          "name": "1 месяц",
          "description": "Для личного использования и экспериментов. Идеально подходит для тех, кто хочет использовать возможности исскуственного интелекта\n\n```Включает:\n💡 Генерация текста и мультимедиа\n🛠️ Промпт инжиниринг\n🔄 Доступ к базовым функциям и обновлениям\n🌐 Запросы с использованием источников\n...```\n\nПосле оплаты свяжитесь с [поддержкой](https://t.me/AiManagerSupportBot)‼️",
          "price": 4.99,
          "images": ["https://aimanager.space/img/AIMANAGER-PAY-ASSIST1.jpg"],
          "links": [
            {
              "text": "Купить за TON/USDT/BTC",
              "url": "https://t.me/send?start=IVOXgJ8taGHN"
            },
            {
              "text": "О тарифах...",
              "url": "https://docs.aimanager.space/docs/tariffs"
            }
          ]
        },
        {
          "name": "6 месяцев",
          "description": "Для личного использования и экспериментов. Идеально подходит для тех, кто хочет использовать возможности исскуственного интелекта\n\n```Включает:\n💡 Генерация текста и мультимедиа\n🛠️ Промпт инжиниринг\n🔄 Доступ к базовым функциям и обновлениям\n🌐 Запросы с использованием источников\n...```\n\nПосле оплаты свяжитесь с [поддержкой](https://t.me/AiManagerSupportBot)‼️",
          "price": 23.94,
          "images": ["https://aimanager.space/img/AIMANAGER-PAY-ASSIST6.jpg"],
          "links": [
            {
              "text": "Купить за TON/USDT/BTC",
              "url": "https://t.me/send?start=IVrGYGKTJ69V"
            },
            {
              "text": "О тарифах...",
              "url": "https://docs.aimanager.space/docs/tariffs"
            }
          ]
        },
        {
          "name": "12 месяцев",
          "description": "Для личного использования и экспериментов. Идеально подходит для тех, кто хочет использовать возможности исскуственного интелекта\n\n```Включает:\n💡 Генерация текста и мультимедиа\n🛠️ Промпт инжиниринг\n🔄 Доступ к базовым функциям и обновлениям\n🌐 Запросы с использованием источников\n...```\n\nПосле оплаты свяжитесь с [поддержкой](https://t.me/AiManagerSupportBot)‼️",
          "price": 30,
          "images": ["https://aimanager.space/img/AIMANAGER-PAY-ASSIST12.jpg"],
          "links": [
            {
              "text": "Купить за TON/USDT/BTC",
              "url": "https://t.me/send?start=IVYoSxerRVmc"
            },
            {
              "text": "О тарифах...",
              "url": "https://docs.aimanager.space/docs/tariffs"
            }
          ]
        }
      ],
      "currency": {
        "STARS": {
          "text": "Купить за",
          "commission": "130%/0.015"
        }
      }
    },
    {
      "sku": "BASIC",
      "name": "Тариф: BASIC",
      "category": "- ТАРИФЫ -",
      "attribute": [
        {
          "name": "1 месяц",
          "description": "Предлагает всё необходимое для автоматизированного менеджмента и создания персонализированных решений\n\n```Включает:\n🗂️ Публичный и локальный доступ\n🤖 Возможности рассылки\n🛍️ Магазин и интерактивные карточки\n💎 Возможность включения платного доступа за звезды к вашему боту\n...```\n\nПосле оплаты свяжитесь с [поддержкой](https://t.me/AiManagerSupportBot)‼️",
          "price": 16.99,
          "images": ["https://aimanager.space/img/AIMANAGER-PAY-BASIC1.jpg"],
          "links": [
            {
              "text": "Купить за TON/USDT/BTC",
              "url": "https://t.me/send?start=IV5WWRrYLxYo"
            },
            {
              "text": "О тарифах...",
              "url": "https://docs.aimanager.space/docs/tariffs"
            }
          ]
        },
        {
          "name": "6 месяцев",
          "description": "Предлагает всё необходимое для автоматизированного менеджмента и создания персонализированных решений\n\n```Включает:\n🗂️ Публичный и локальный доступ\n🤖 Возможности рассылки\n🛍️ Магазин и интерактивные карточки\n💎 Возможность включения платного доступа за звезды к вашему боту\n...```\n\nПосле оплаты свяжитесь с [поддержкой](https://t.me/AiManagerSupportBot)‼️",
          "price": 81.54,
          "images": ["https://aimanager.space/img/AIMANAGER-PAY-BASIC6.jpg"],
          "links": [
            {
              "text": "Купить за TON/USDT/BTC",
              "url": "https://t.me/send?start=IVBTcKrqfyqx"
            },
            {
              "text": "О тарифах...",
              "url": "https://docs.aimanager.space/docs/tariffs"
            }
          ]
        },
        {
          "name": "12 месяцев",
          "description": "Предлагает всё необходимое для автоматизированного менеджмента и создания персонализированных решений\n\n```Включает:\n🗂️ Публичный и локальный доступ\n🤖 Возможности рассылки\n🛍️ Магазин и интерактивные карточки\n💎 Возможность включения платного доступа за звезды к вашему боту\n...```\n\nПосле оплаты свяжитесь с [поддержкой](https://t.me/AiManagerSupportBot)‼️",
          "price": 102,
          "images": ["https://aimanager.space/img/AIMANAGER-PAY-BASIC12.jpg"],
          "links": [
            {
              "text": "Купить за TON/USDT/BTC",
              "url": "https://t.me/send?start=IVCiAzIAHUe3"
            },
            {
              "text": "О тарифах...",
              "url": "https://docs.aimanager.space/docs/tariffs"
            }
          ]
        }
      ],
      "currency": {
        "STARS": {
          "text": "Купить за",
          "commission": "130%/0.015"
        }
      }
    },
    {
      "sku": "PRO",
      "name": "Тариф: PRO",
      "category": "- ТАРИФЫ -",
      "attribute": [
        {
          "name": "1 месяц",
          "description": "Расширение возможностей тарифа BASIC, работа с крипто кошельками, доступами, оплатами и вознаграждениями.\n\n```Включает:\n📊 Все функции плана Basic\n💼 Интеграция с крипто кошельками\n💳 Управление оплатами и вознаграждениями\n🛠️ Продвинутая тех.поддержка!\n...```\n\nПосле оплаты свяжитесь с [поддержкой](https://t.me/AiManagerSupportBot)‼️",
          "price": 49.99,
          "images": ["https://aimanager.space/img/AIMANAGER-PAY-PRO1.jpg"],
          "links": [
            {
              "text": "Купить за TON/USDT/BTC",
              "url": "https://t.me/send?start=IVNgISUyasxh"
            },
            {
              "text": "О тарифах...",
              "url": "https://docs.aimanager.space/docs/tariffs"
            }
          ]
        },
        {
          "name": "6 месяцев",
          "description": "Расширение возможностей тарифа BASIC, работа с крипто кошельками, доступами, оплатами и вознаграждениями.\n\n```Включает:\n📊 Все функции плана Basic\n💼 Интеграция с крипто кошельками\n💳 Управление оплатами и вознаграждениями\n🛠️ Продвинутая тех.поддержка!\n...```\n\nПосле оплаты свяжитесь с [поддержкой](https://t.me/AiManagerSupportBot)‼️",
          "price": 239.94,
          "images": ["https://aimanager.space/img/AIMANAGER-PAY-PRO6.jpg"],
          "links": [
            {
              "text": "Купить за TON/USDT/BTC",
              "url": "https://t.me/send?start=IVMUOujpsA1v"
            },
            {
              "text": "О тарифах...",
              "url": "https://docs.aimanager.space/docs/tariffs"
            }
          ]
        },
        {
          "name": "12 месяцев",
          "description": "Расширение возможностей тарифа BASIC, работа с крипто кошельками, доступами, оплатами и вознаграждениями.\n\n```Включает:\n📊 Все функции плана Basic\n💼 Интеграция с крипто кошельками\n💳 Управление оплатами и вознаграждениями\n🛠️ Продвинутая тех.поддержка!\n...```\n\nПосле оплаты свяжитесь с [поддержкой](https://t.me/AiManagerSupportBot)‼️",
          "price": 300,
          "images": ["https://aimanager.space/img/AIMANAGER-PAY-PRO12.jpg"],
          "links": [
            {
              "text": "Купить за TON/USDT/BTC",
              "url": "https://t.me/send?start=IVbN1ZtHwcPy"
            },
            {
              "text": "О тарифах...",
              "url": "https://docs.aimanager.space/docs/tariffs"
            }
          ]
        }
      ],
      "currency": {
        "STARS": {
          "text": "Купить за",
          "commission": "130%/0.015"
        }
      }
    },
    {
      "sku": "SERVICE",
      "name": "Персональная настройка:",
      "category": "- УСЛУГИ -",
      "attribute": [
        {
          "name": "6ч. + 1ч. консультаций",
          "description": "Используйте весь наш опыт в создании интелектуальных ботов для менеджмента проектов! \n\nСогласуйте Техническое Задание перед приобретением, для этой свяжитесь с [поддержкой](https://t.me/AiManagerSupportBot)‼️",
          "price": 100,
          "images": ["https://aimanager.space/img/AIMANAGER-PAY-DEV1.png"],
          "links": [
            {
              "text": "Купить за TON/USDT/BTC",
              "url": "https://t.me/send?start=IVNgISUyasxh"
            },
            {
              "text": "О тарифах...",
              "url": "https://docs.aimanager.space/docs/tariffs"
            }
          ]
        },
        {
          "name": "9ч. + 1 ч. консультаций",
          "description": "Используйте весь наш опыт в создании интелектуальных ботов для менеджмента проектов! \n\nСогласуйте Техническое Задание перед приобретением, для этой свяжитесь с [поддержкой](https://t.me/AiManagerSupportBot)‼️",
          "price": 150,
          "images": ["https://aimanager.space/img/AIMANAGER-PAY-DEV2.png"],
          "links": [
            {
              "text": "Купить за TON/USDT/BTC",
              "url": "https://t.me/send?start=IVMUOujpsA1v"
            },
            {
              "text": "О тарифах...",
              "url": "https://docs.aimanager.space/docs/tariffs"
            }
          ]
        },
        {
          "name": "12ч. + 1,5ч. консультации",
          "description": "Используйте весь наш опыт в создании интелектуальных ботов для менеджмента проектов! \n\nСогласуйте Техническое Задание перед приобретением, для этой свяжитесь с [поддержкой](https://t.me/AiManagerSupportBot)‼️",
          "price": 200,
          "images": ["https://aimanager.space/img/AIMANAGER-PAY-DEV3.png"],
          "links": [
            {
              "text": "Купить за TON/USDT/BTC",
              "url": "https://t.me/send?start=IVbN1ZtHwcPy"
            },
            {
              "text": "О тарифах...",
              "url": "https://docs.aimanager.space/docs/tariffs"
            }
          ]
        }
      ],
      "currency": {
        "STARS": {
          "text": "Купить за",
          "commission": "130%/0.015"
        }
      }
    },
    {
      "sku": "DONATE",
      "name": "ПОДАРИТЬ 🎁",
      "category": "- ДОНАТ -",
      "attribute": [
        {
          "name": "1$",
          "description": "ЭТО НЕ ОБЯЗАТЕЛЬНО!... и всего лишь пример того, как можно использовать наши новые карточки, но мы будем рады поддержке, если вы решите это сделать‼️",
          "price": 1,
          "images": ["https://aimanager.space/img/AIMANAGER-DONATE-1.png"],
          "links": [
            {
              "text": "Поддержать 1$",
              "url": "https://t.me/send?start=IVM6XXtkQKS6"
            }
          ]
        },
        {
          "name": "5$",
          "description": "ЭТО НЕ ОБЯЗАТЕЛЬНО!... и всего лишь пример того, как можно использовать наши новые карточки, но мы будем рады поддержке, если вы решите это сделать‼️",
          "price": 5,
          "images": ["https://aimanager.space/img/AIMANAGER-DONATE-5.png"],
          "links": [
            {
              "text": "Поддержать 5$",
              "url": "https://t.me/send?start=IVFbFrlGNUIh"
            }
          ]
        },
        {
          "name": "10$",
          "description": "ЭТО НЕ ОБЯЗАТЕЛЬНО!... и всего лишь пример того, как можно использовать наши новые карточки, но мы будем рады поддержке, если вы решите это сделать‼️",
          "price": 10,
          "images": ["https://aimanager.space/img/AIMANAGER-DONATE-10.png"],
          "links": [
            {
              "text": "Поддержать 10$",
              "url": "https://t.me/send?start=IVBGWgF9PDcr"
            }
          ]
        }
      ],
      "currency": {
        "STARS": {
          "text": "Поддержать",
          "commission": "100%/0.015"
        }
      }
    },
    {
      "sku": "quickstart",
      "name": "Быстрый старт",
      "category": "Информация",
      "attribute": [
        {
          "name": "",
          "description": "",
          "images": ["https://aimanager.space/img/AIMANAGE-start.jpg"],
          "links": [
            {
              "text": "Перейти",
              "url": "https://docs.aimanager.space/docs/category/%D0%B1%D1%8B%D1%81%D1%82%D1%80%D1%8B%D0%B9-%D1%81%D1%82%D0%B0%D1%80%D1%82-"
            },
            {
              "text": "Полная документация...",
              "url": "https://docs.aimanager.space/"
            }
          ]
        }
      ]
    },
    {
      "sku": "DOCS",
      "name": "Документация",
      "category": "Информация",
      "attribute": [
        {
          "name": "",
          "description": "",
          "images": ["https://aimanager.space/img/AIMANAGE-docs.jpg"],
          "links": [
            {
              "text": "Перейти",
              "url": "https://docs.aimanager.space/"
            }
          ]
        }
      ]
    },
    {
      "sku": "AFFILIATE",
      "name": "Партнерская программа",
      "category": "Информация",
      "attribute": [
        {
          "name": "",
          "description": "Мы приготовили щедрые вознаграждения для всех наших друзей и партнеров, вы сможете получить до 75% от стоимости приобретенного приглашенным пользователем тарифа (см.таблицу), а также получать вознаграждения с его последующих покупок и вознаграждений согласно трехуровневой реферальной системы!",
          "images": ["https://aimanager.space/img/AIMANAG-affiliate.jpg"],
          "links": [
            {
              "text": "Читать подробнее...",
              "url": "https://docs.aimanager.space/docs/affiliate-program"
            },
            {
              "text": "> Проверить рефералов <",
              "url": "https://t.me/youaimanager_bot"
            }
          ]
        }
      ]
    },
    {
      "sku": "SHARE",
      "name": "Как отправить реф.ссылку‼",
      "category": "Информация",
      "attribute": [
        {
          "name": "",
          "description": "Наша реферальная система прошита сквозь все элементы, включая интерактив и ссылки. Поэтому смело используйте их. А, чтобы отправить интерактивную карточку в чат другому пользователю или группу, вам следует набрать в сообщении чата: [@youaimanager_bot]() отступить и выбрать карточку!",
          "images": [
            "https://aimanager.space/img/AIMANAGE-howtoshare.jpg",
            "https://aimanager.space/img/AIMANAGE-howtoshare.jpg",
            "https://aimanager.space/img/AIMANAGE-howtoshare.jpg"
          ],
          "links": [
            {
              "text": "О партнерской программе...",
              "url": "https://docs.aimanager.space/docs/affiliate-program"
            },
            {
              "text": "> Проверить рефералов <",
              "url": "https://t.me/youaimanager_bot"
            }
          ]
        }
      ]
    },
    {
      "sku": "contacts",
      "name": "КОНТАКТЫ ✉️",
      "category": "Контакты",
      "attribute": [
        {
          "name": "",
          "description": "",
          "images": ["https://aimanager.space/img/AIMANAGER-contacts.jpg"],
          "links": [
            {
              "text": "Телеграм канал",
              "url": "https://t.me/YouAiMANAGER"
            },
            {
              "text": "По всем вопросам!",
              "url": "https://t.me/AiManagerSupportBot"
            },
            {
              "text": "Документация",
              "url": "https://docs.aimanager.space/"
            }
          ]
        }
      ]
    }
  ]
}