Shop AI

📚 Помощь и инструкции

Здесь вы найдете простые инструкции по работе с системой Shop AI. Все объяснено простым языком без сложных терминов.

🚀 Начало работы

Как войти в систему?

  1. Откройте страницу входа (обычно это главная страница сайта)
  2. Введите пароль: Anna
  3. Нажмите кнопку "Войти"

💡 Если вы забыли пароль, обратитесь к администратору системы.

Что вы увидите после входа?

После входа вы попадете на главную страницу (Dashboard), где увидите:

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

⚙️ Настройки системы

Где находятся настройки?

Настройки находятся в разделе "Настройки" в верхнем меню или по адресу /settings

Что можно настроить?

  • Instagram/Facebook - подключение к вашей странице Instagram
  • OpenAI - настройка искусственного интеллекта для ответов клиентам
  • 1C - синхронизация товаров из программы 1С
  • Бот - настройки автоматических ответов

🔑 Как получить ключи для подключения

📱 Instagram / Facebook Graph API

Эти ключи нужны для работы бота в Instagram Direct Messages (личных сообщениях).

Шаг 1: Создайте приложение Facebook

  1. Перейдите на developers.facebook.com
  2. Нажмите "Мои приложения" → "Создать приложение"
  3. Выберите тип: "Другое" или "Бизнес"
  4. Заполните название приложения и нажмите "Создать"

Шаг 2: Добавьте продукт Instagram

  1. В настройках приложения найдите раздел "Продукты"
  2. Нажмите "+" рядом с "Instagram"
  3. Нажмите "Настроить" на карточке "Messaging"

Шаг 3: Получите токены

  1. Перейдите в раздел "Инструменты" → "Graph API Explorer"
  2. Выберите ваше приложение в выпадающем списке
  3. Выберите страницу Instagram в разделе "Пользователь или страница"
  4. Скопируйте Page Access Token - это ваш IG Page Access Token
  5. Для IG Verify Token придумайте любой секретный код (например: my_secret_123)
  6. Page ID можно найти в настройках вашей страницы Instagram

💡 Подробная инструкция: Официальная документация Instagram API

🤖 OpenAI API (ChatGPT)

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

Как получить ключ:

  1. Перейдите на platform.openai.com
  2. Зарегистрируйтесь или войдите в аккаунт
  3. Перейдите в раздел "API keys" (в меню слева)
  4. Нажмите "Create new secret key"
  5. Придумайте название ключа (например: "Shop AI Bot")
  6. Скопируйте ключ сразу - он показывается только один раз!
  7. Вставьте скопированный ключ в поле OpenAI API Key в настройках

Какую модель выбрать?

Рекомендуется использовать gpt-4o - это самая современная и умная модель. Она лучше понимает контекст и дает более точные ответы.

⚠️ Важно: Использование API платное. Стоимость зависит от количества запросов. Проверьте тарифы на openai.com/pricing

🔄 1C Синхронизация

Эти настройки нужны для автоматической синхронизации товаров из программы 1С в систему.

Что нужно настроить:

  • 1C OData URL - адрес вашего сервера 1С для получения данных
  • 1C User - имя пользователя для доступа к 1С
  • 1C Password - пароль для доступа к 1С

Как найти эти данные:

  1. Обратитесь к программисту, который настраивал вашу 1С
  2. Или найдите в настройках 1С раздел "Веб-сервисы" или "OData"
  3. Обычно адрес выглядит так: http://ваш-сервер:порт/odata/standard.odata

💡 Если у вас нет доступа к 1С, можно оставить эти поля пустыми. Товары можно будет добавлять вручную через раздел "Товары".

✨ Возможности системы

💬 Автоматические ответы клиентам

Система автоматически отвечает на сообщения в Instagram Direct Messages с помощью искусственного интеллекта.

  • Бот понимает вопросы клиентов на русском языке
  • Может рекомендовать товары из вашего каталога
  • Использует информацию из Stories для контекста
  • Можно переключить диалог на живого менеджера в любой момент

📦 Управление товарами

В разделе "Товары" вы можете:

  • Просматривать все товары
  • Видеть остатки на складе
  • Синхронизировать товары из 1С (если настроено)

👥 Управление клиентами

В разделе "Клиенты" вы можете:

  • Видеть всех клиентов, которые писали в Instagram
  • Просматривать историю общения
  • Добавлять заметки о клиентах

💬 Управление диалогами

В разделе "Диалоги" вы можете:

  • Просматривать все переписки с клиентами
  • Видеть, какие диалоги обрабатывает бот, а какие - менеджеры
  • Переключать диалог с бота на менеджера (кнопка "Передать менеджеру")

📸 Stories

Система автоматически:

  • Собирает ваши Stories из Instagram
  • Распознает текст из видео (если есть речь)
  • Сопоставляет Stories с товарами
  • Использует эту информацию для ответов клиентам

❓ Частые вопросы

Что означают индикаторы подключений на главной странице?

  • ✓ Подключено - сервис работает и готов к использованию
  • ✗ Ошибка - есть проблема с подключением, проверьте настройки
  • ○ Не подключено - сервис не настроен, нужно добавить ключи в настройках

Бот не отвечает клиентам. Что делать?

  1. Проверьте статус подключения Instagram на главной странице
  2. Убедитесь, что в настройках указан правильный IG Page Access Token
  3. Проверьте, что бот-воркер запущен (обратитесь к администратору сервера)
  4. Проверьте статус подключения OpenAI - бот не может отвечать без него

Как переключить диалог с бота на менеджера?

  1. Откройте раздел "Диалоги"
  2. Найдите нужный диалог и откройте его
  3. Нажмите кнопку "Передать менеджеру"
  4. После этого бот перестанет отвечать в этом диалоге, и вы сможете отвечать вручную

Товары не синхронизируются из 1С

  1. Проверьте настройки 1C в разделе "Настройки"
  2. Убедитесь, что указан правильный адрес сервера 1С
  3. Проверьте логин и пароль для доступа к 1С
  4. Синхронизация происходит автоматически каждые 10 минут

Сколько стоит использование OpenAI?

Стоимость зависит от количества сообщений. Примерно:

  • 1 сообщение ≈ $0.01-0.03 (в зависимости от модели)
  • 100 сообщений ≈ $1-3
  • 1000 сообщений ≈ $10-30

Точные цены смотрите на openai.com/pricing

📞 Нужна помощь?

Если у вас возникли вопросы или проблемы:

  • Проверьте этот раздел помощи еще раз
  • Обратитесь к техническому специалисту, который настраивал систему
  • Проверьте логи системы (для администраторов сервера)