Документация SpellBook

SpellBook — это мощная платформа для создания, настройки и монетизации ИИ-ассистентов на базе ChatGPT-5. Создавайте умных помощников без технических знаний и интегрируйте их в Telegram, на ваш сайт или используйте в веб-интерфейсе.

Главная особенность: Режим совещания

Уникальная функция, не имеющая аналогов на рынке! До 3 экспертов-ассистентов одновременно анализируют ваш вопрос с разных точек зрения, а система автоматически создает итоговый саммарайз со всеми рекомендациями в реальном времени.

Ключевые возможности платформы

ChatGPT-5 модель

Используем новейшую модель GPT-5, оптимизированную для качества ответов

Режим совещания

До 3 экспертов работают над задачей с разных точек зрения

Без кода

Визуальный конструктор без программирования

Динамические кнопки

Автоматическая генерация контекстных действий

База знаний

До 20 файлов по 5 МБ для обучения

Telegram за 1 клик

Мгновенное превращение в бота

Для кого подходит SpellBook?

Бизнес

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

Образование

Персональные помощники для обучения, репетиторы, учебные боты

Креативщики

Ассистенты для контента, идеи, написание текстов

E-commerce

Консультанты по товарам, обработка заказов, поддержка 24/7

Регистрация и первые шаги

Начните работу с платформой всего за несколько минут.

Шаг 1: Создание аккаунта

Откройте страницу регистрации
Перейдите на spell-book.net/register.php и заполните форму регистрации.
Укажите email
Введите действующий email адрес. На него придет одноразовый код для входа.
Введите код подтверждения
Проверьте почту и введите полученный одноразовый код. Если письма нет, проверьте папку "Спам".
Скриншот формы регистрации

Форма регистрации на платформе SpellBook

Бесплатный тариф

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

Получайте промокоды и бонусы!
Подпишитесь на наш Telegram-канал, чтобы получать промокоды и быть в курсе новых функций!

Панель управления

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

Основные элементы панели

Статистика

Количество ассистентов и общее число посещений

Кнопка "Создать"

Быстрое создание нового ассистента

Базы знаний

Управление документами для ассистентов

Обучение

Гайды и видео по использованию

Панель управления с ассистентами

Панель управления SpellBook с карточками ассистентов

Карточка ассистента

Каждый ассистент отображается в виде карточки с основной информацией:

  • Аватар и название — визуальная идентификация
  • Описание — краткая информация о возможностях
  • Счетчик посещений — количество обращений пользователей
  • Статусы — закреплен, встроен на сайт, опубликован в маркетплейсе
  • Действия — чат, встраивание, рассылка, удаление

Действия с ассистентом

Иконка Действие Описание
Открыть чат Начать диалог с ассистентом
Получить код встраивания Код для добавления на сайт
Рассылка (только Telegram) Массовая отправка сообщений
Опубликовать в маркетплейсе Сделать доступным другим
Закрепить Поднять в начало списка
Удалить Безвозвратное удаление

Создание ассистента

Процесс создания ассистента интуитивно понятен и не требует технических знаний.

Пошаговая инструкция

1. Нажмите "Создать ассистента"
В панели управления нажмите синюю кнопку "Создать" в правом верхнем углу.
2. Заполните основную информацию
Название: короткое и понятное (например: "Консультант по SEO")
Компания/Имя: от чьего лица отвечает ассистент
Описание: краткое описание возможностей (до 500 символов)
3. Загрузите аватар
Добавьте изображение (рекомендуемый размер: 512x512px, форматы: JPG, PNG, WebP, до 2 МБ)
4. Напишите системный промпт
Это самая важная часть! Опишите роль, стиль общения и компетенции ассистента. Подробнее об этом в следующем разделе.
5. Настройте дополнительные параметры
Быстрые кнопки, динамические кнопки, база знаний, Telegram-интеграция
6. Сохраните ассистента
Нажмите черную кнопку "Создать ассистента" внизу формы. Готово! Теперь можно тестировать.
Форма создания ассистента

Интерфейс создания нового ассистента

Совет для начинающих: Начните с простого ассистента, например "Помощник по грамматике", чтобы понять принцип работы. Потом переходите к более сложным сценариям.

Системный промпт

Системный промпт — это инструкция для ИИ, определяющая его поведение, знания и стиль общения. Это самая важная часть настройки ассистента.

Структура хорошего промпта

1. Роль и идентичность

Начните с определения, кто ваш ассистент.

Вы — опытный юрист с 15-летним стажем. Специализируетесь на трудовом праве, договорах и корпоративном праве. Вы всегда профессиональны, внимательны к деталям и предоставляете точную информацию.

2. Знания и компетенции

Опишите, в чем ассистент является экспертом.

Вы эксперт в digital-маркетинге со специализацией на: - SMM (социальные сети) - Контент-маркетинг - SEO и контекстная реклама - Email-маркетинг - Аналитика и метрики Вы знаете последние тренды и инструменты: Google Analytics, Яндекс.Метрика, Facebook Ads Manager, Google Ads.

3. Стиль общения

Определите тон и манеру общения.

Официальный стиль: "Общайтесь официально, но доброжелательно. Используйте 'Вы'. Избегайте жаргона и сленга." Дружелюбный стиль: "Общайтесь дружелюбно и непринужденно. Можете использовать 'ты'. Используйте эмодзи для выражения эмоций." Наставнический стиль: "Будьте терпеливы и поддерживающи. Объясняйте сложные концепции простым языком. Задавайте наводящие вопросы."

4. Ограничения и правила

Укажите, что ассистент НЕ должен делать.

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

5. Формат ответов

Опишите, как структурировать ответы.

Структурируйте ответы следующим образом: 1. Краткий ответ на вопрос (1-2 предложения) 2. Подробное объяснение с примерами 3. Дополнительные рекомендации или советы 4. Вопросы для уточнения (если нужно) Используйте списки, таблицы и выделение важного **жирным текстом**.

Примеры готовых промптов

Пример 1: Техподдержка SaaS-сервиса

Вы — специалист технической поддержки сервиса управления проектами "TaskFlow". Ваши обязанности: - Помогать пользователям решать технические проблемы - Объяснять функционал платформы - Предоставлять пошаговые инструкции - Собирать обратную связь Стиль общения: дружелюбный, терпеливый, профессиональный. Используйте простые объяснения без технического жаргона. Структура ответов: 1. Поприветствуйте и уточните проблему 2. Предложите пошаговое решение 3. Убедитесь, что проблема решена 4. Спросите, нужна ли еще помощь При сложных проблемах: "Я передам ваш запрос специалистам. Ответим в течение 24 часов на email."

Пример 2: Персональный фитнес-тренер

Вы — персональный фитнес-тренер с сертификацией и 10-летним опытом. Ваша специализация: - Составление программ тренировок - Рекомендации по питанию для разных целей - Мотивация и поддержка - Профилактика травм Стиль общения: мотивирующий, энергичный, но без агрессивного пуша. Используйте эмодзи 💪 🔥 ⚡ для позитивной энергии. Важно: - Всегда спрашивайте о противопоказаниях и хронических заболеваниях - НЕ давайте медицинских советов при травмах или болезнях - Рекомендуйте консультацию врача при подозрении на проблемы со здоровьем - Подчеркивайте важность постепенного прогресса Формат ответов: 1. Оцените текущий уровень пользователя 2. Дайте конкретные рекомендации 3. Объясните, ПОЧЕМУ это важно 4. Мотивируйте на действие
Важно: Чем подробнее промпт, тем точнее будет работать ассистент. Не бойтесь писать много — система обрабатывает до 8000 символов в системном промпте.

Быстрые кнопки

Быстрые кнопки — это предзаданные варианты ответов, которые видит пользователь под полем ввода. Они упрощают взаимодействие и направляют диалог.

Как работают быстрые кнопки?

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

Быстрые кнопки в интерфейсе чата

Быстрые кнопки в веб-интерфейсе чата

Примеры использования

FAQ-бот

Часто задаваемые вопросы
Как оформить заказ?
Условия доставки
Связаться с оператором

Интернет-магазин

🛍 Каталог товаров
📦 Отследить заказ
💰 Акции и скидки
📞 Контакты

Обучающий бот

📚 Начать урок
❓ Задать вопрос
📝 Проверить знания
🏆 Мой прогресс

Рекомендации по созданию

  • Краткость: не более 40 символов на кнопку
  • Ясность: пользователь должен понимать, что произойдет при нажатии
  • Эмодзи: используйте для визуального разделения
  • Количество: оптимально 4-6 кнопок
  • Актуальность: кнопки должны соответствовать целям ассистента

Совет для Telegram

В Telegram быстрые кнопки отображаются как Inline-клавиатура под сообщениями. Это очень удобно для мобильных пользователей!

Динамические кнопки

Динамические кнопки — это инновационная функция SpellBook, которая автоматически генерирует контекстные кнопки-действия на основе содержания диалога.

Как это работает?

После каждого ответа ассистента система анализирует контекст и автоматически создает 3-6 релевантных кнопок-действий. Они адаптируются под тему разговора и помогают пользователю продолжить диалог.

Ключевое преимущество: Вам не нужно вручную создавать сотни вариантов кнопок для разных сценариев. ИИ делает это автоматически!

Примеры динамических кнопок

Сценарий 1: Консультация по продуктам

Вопрос пользователя: "Какие у вас есть тарифы?"

Ответ ассистента: Описание тарифов...

Динамические кнопки:

Сравнить тарифы Рассчитать стоимость Какой тариф подойдет мне? У меня есть вопрос Оформить заказ

Сценарий 2: Техническая поддержка

Вопрос: "У меня проблема с интеграцией Telegram"

Ответ: Пошаговая инструкция...

Динамические кнопки:

Проблема решена, спасибо! Попробовать еще раз Нужна помощь менеджера Показать полную документацию Другая проблема

Сценарий 3: Образовательный контент

Вопрос: "Объясни, что такое маркетинговая воронка"

Ответ: Подробное объяснение...

Динамические кнопки:

Привести пример Как построить воронку? Типичные ошибки Полезные ресурсы Следующая тема

Динамические кнопки в действии (веб-интерфейс)

Динамические кнопки в Telegram

Динамические кнопки в Telegram-боте

Включение и отключение

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

Важно понимать: Динамические кнопки генерируются на основе контекста диалога. Чем лучше ваш системный промпт описывает роль и цели ассистента, тем более точными будут предложенные действия.

База знаний

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

Как это работает?

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

Технология: Используется семантический поиск на основе AI-эмбеддингов от OpenAI. Система понимает смысл текста, а не просто ищет ключевые слова.

Технические характеристики

Параметр Значение Примечание
Поддерживаемые форматы PDF DOCX TXT CSV XLSX Основные форматы документов
Максимальный размер файла 5 МБ На один файл
Количество файлов До 20 файлов В одной базе знаний
Время обработки 1-5 минут Зависит от размера

Создание базы знаний

Шаг 1: Перейдите в раздел "Базы знаний"
В главном меню нажмите "Базы знаний" или создайте базу прямо в форме создания ассистента.
Шаг 2: Создайте новую базу
Нажмите "Создать базу знаний" и укажите название (например: "Прайс-лист 2025", "FAQ по продуктам").
Шаг 3: Загрузите файлы
Выберите файлы на компьютере и загрузите. Можно загружать по одному или несколько сразу.
Шаг 4: Дождитесь обработки
Система автоматически извлечет текст, создаст эмбеддинги и проиндексирует содержимое. Статус обработки отображается для каждого файла.
Шаг 5: Подключите к ассистенту
В настройках ассистента выберите созданную базу знаний из выпадающего списка.
Создание базы знаний

Интерфейс создания новой базы знаний

Список файлов базы знаний

Статусы обработки файлов в базе знаний

Рекомендации по оформлению документов

  • Структурируйте информацию: используйте заголовки, подзаголовки и списки
  • Избегайте сканов: система не распознает текст с изображений (нужен предварительный OCR)
  • Форматируйте таблицы: простые таблицы обрабатываются лучше сложных
  • Разбивайте большие файлы: несколько маленьких файлов лучше одного огромного
  • Называйте файлы понятно: "Прайс_июнь_2025.pdf" лучше, чем "document1.pdf"
Ограничения:
  • Система не извлекает текст из изображений (нужен OCR заранее)
  • Защищенные паролем PDF не поддерживаются
  • Сложные таблицы могут быть обработаны частично

Примеры использования

E-commerce

Загрузите каталог товаров, прайс-листы, характеристики. Ассистент будет отвечать на вопросы о товарах, ценах и наличии.

Обучение

Загрузите учебные материалы, лекции, методички. Создайте персонального репетитора по предмету.

Медицина

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

Корпоративная база

Загрузите внутренние регламенты, политики, FAQ для сотрудников. Автоматизируйте HR-поддержку.

Telegram интеграция

Превратите вашего ассистента в полноценного Telegram-бота всего за несколько минут без программирования!

Создание Telegram-бота

1. Создайте бота через @BotFather
Откройте Telegram, найдите @BotFather и отправьте команду /newbot. Следуйте инструкциям: укажите имя и username бота. BotFather выдаст вам токен вида 123456789:ABCdefGHIjklMNOpqrsTUVwxyz
2. Скопируйте токен
Сохраните токен — он понадобится для подключения бота к SpellBook.
3. Включите Telegram в настройках ассистента
В форме создания/редактирования ассистента найдите раздел "Telegram интеграция", включите переключатель и вставьте токен в поле.
4. Сохраните изменения
Система автоматически подключит бота к ассистенту и настроит вебхуки. Готово!
Настройка Telegram в форме ассистента

Раздел Telegram-интеграции в настройках ассистента

Диалог с BotFather

Получение токена бота от @BotFather

Возможности Telegram-бота

Полноценный диалог

Бот работает так же, как веб-версия: понимает контекст, использует базу знаний

Динамические кнопки

Автоматические кнопки-действия отображаются как Inline-клавиатура

Работа в группах

Добавьте бота в группу для анализа диалогов и автоответов

Массовые рассылки

Отправляйте сообщения всем пользователям бота через панель управления

База знаний

Бот использует вашу базу знаний для точных ответов

Анализ диалогов

Автоматические суммаризации диалогов через команду /recall

Массовые рассылки

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

Как сделать рассылку?
1. Найдите карточку ассистента с Telegram в панели управления
2. Нажмите кнопку "Сделать рассылку"
3. Напишите текст сообщения (поддерживается Markdown)
4. Используйте теги {name} и {username} для персонализации
5. Нажмите "Отправить рассылку"

Пример рассылки с персонализацией

Привет, {name}! 👋 Мы запустили **новую акцию** только для наших пользователей! 🎁 Скидка 20% на все услуги до конца месяца 📦 Бесплатная доставка при заказе от 1000₽ Используй промокод: **SPRING2025** [Перейти в каталог](https://your-site.com)

Тег {name} заменится на имя пользователя, {username} — на username

Ограничения Telegram: Бот может отправлять рассылку только пользователям, которые первыми написали боту. Если пользователь заблокировал бота, он не получит сообщение.

Команда /recall (анализ диалогов)

Специальная команда для поиска и суммаризации диалогов. Особенно полезна в групповых чатах.

Примеры использования команды /recall

  • /recall встреча — поиск по ключевому слову "встреча"
  • /recall 01.05.2025 — поиск по конкретной дате
  • /recall проект — все обсуждения проекта

Бот найдет релевантные сообщения и создаст краткую суммаризацию обсуждений.

Автоматический анализ

Бот автоматически создает суммаризации диалогов:

  • Каждые 3 часа для активных чатов
  • Еженедельные сводки по воскресеньям
  • Месячные отчеты 1-го числа
  • Тематические суммаризации при обнаружении важных тем

Работа в групповых чатах

Добавьте бота в групповой чат, и он сможет:

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

Встраивание на сайт

Добавьте вашего ИИ-ассистента на любой сайт с помощью простого скрипта — никаких сложных интеграций!

Как это работает?

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

Виджет чата на сайте

Виджет SpellBook на сайте

Получение кода встраивания

1. Откройте панель управления
Найдите карточку нужного ассистента.
2. Нажмите "Получить код встраивания"
Кнопка с иконкой в карточке ассистента.
3. Скопируйте код
В появившемся окне нажмите "Копировать". Код автоматически скопируется в буфер обмена.
4. Вставьте код на сайт
Добавьте скопированный код перед закрывающим тегом </body> на всех страницах, где нужен чат.

Пример кода встраивания

<script> (function() { var script = document.createElement('script'); script.src = 'https://spell-book.net/widget.js'; script.async = true; script.setAttribute('data-assistant-id', 'YOUR_ASSISTANT_ID'); document.body.appendChild(script); })(); </script>
Модальное окно с кодом встраивания

Модальное окно с кодом для встраивания на сайт

Возможности виджета

Полноценный чат

История сообщений, быстрые кнопки, динамические действия

Адаптивность

Автоматически подстраивается под мобильные устройства

Кастомизация

Настройка цветов, позиции, размера (скоро)

Быстрая загрузка

Минимальный размер скрипта, не замедляет сайт

Варианты отображения

Виджет может отображаться в нескольких режимах:

  • Плавающая кнопка (по умолчанию): иконка чата в правом нижнем углу, открывается при клике
  • Встроенный чат: чат встроен прямо в страницу как элемент дизайна
  • Всплывающее окно: автоматически открывается через N секунд после загрузки страницы

Для кого подходит встраивание?

Интернет-магазины

Консультант по товарам, помощь с выбором, прием заказов 24/7

Корпоративные сайты

Автоматизация поддержки, FAQ, запись на консультации

Образовательные платформы

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

Медицинские клиники

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

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

Отслеживание эффективности

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

Важная информация

Каждое сообщение пользователя на вашем сайте или в Telegram учитывается в рамках вашей подписки. На бесплатном тарифе доступно только 5 сообщений, поэтому для активного использования рекомендуется тариф Pro или Партнер.

Обработка файлов

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

Поддерживаемые форматы

Тип файла Форматы Примеры использования
Документы PDF, DOCX, TXT Анализ договоров, резюме, отчетов
Таблицы XLSX, CSV Анализ данных, финансовые отчеты

Как это работает?

1. Пользователь прикрепляет файл
В чате есть кнопка для загрузки файлов. Пользователь выбирает нужный файл.
2. Система обрабатывает файл
Файл загружается на сервер, извлекается текстовое содержимое, создается контекст для ИИ.
3. Ассистент анализирует
ИИ получает содержимое файла и может отвечать на вопросы, делать выводы, давать рекомендации.
Интерфейс загрузки файла

Загрузка файла в чат для анализа

Примеры использования

Анализ документов

"Проанализируй этот договор и выдели ключевые условия"

Работа с таблицами

"Посчитай сумму в колонке B и найди максимальное значение"

Извлечение информации

"Найди все упоминания о сроках в этом документе"

Анализ данных

"Построй сводку по этим финансовым данным"

Ограничения: Максимальный размер файла — 5 МБ. Для постоянного хранения и более эффективного использования рекомендуется загружать документы в базу знаний.

Режим совещания

Уникальная функция SpellBook, не имеющая аналогов! До 3 ассистентов-экспертов одновременно анализируют ваш вопрос с разных точек зрения.

Как это работает?

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

Процесс работы

1. Выберите участников совещания
В интерфейсе чата выберите 2-3 ассистентов, которые будут участвовать в обсуждении. Например: маркетолог, финансист, технический директор.
2. Задайте вопрос
Опишите задачу или вопрос. Чем подробнее, тем лучше будет анализ.
3. Первый эксперт анализирует
Первый ассистент получает вопрос и дает свой развернутый ответ с профессиональной точки зрения.
4. Следующие эксперты дополняют
Каждый следующий ассистент видит анализ предыдущих, дополняет, уточняет, предлагает альтернативные решения.
5. Итоговый саммарайз
Система анализирует все ответы и создает структурированный итоговый документ с ключевыми выводами и рекомендациями.
Интерфейс режима совещания

Интерфейс выбора экспертов для режима совещания

Процесс совещания в реальном времени

Примеры использования

Сценарий 1: Запуск нового продукта

Участники: Маркетолог, Финансовый аналитик, Product Manager

Вопрос: "Стоит ли нам запускать новую линейку органической косметики?"

  • Маркетолог: анализирует рынок, тренды, целевую аудиторию
  • Финансист: оценивает затраты, прибыльность, риски
  • Product Manager: рассматривает техническую реализацию, конкурентов
  • Итог: структурированный план с учетом всех аспектов

Сценарий 2: Решение бизнес-проблемы

Участники: HR-эксперт, Юрист, Бизнес-консультант

Вопрос: "Как правильно реорганизовать отдел продаж?"

  • HR: оценка команды, мотивация, обучение
  • Юрист: трудовое законодательство, договоры
  • Консультант: бизнес-процессы, KPI, оптимизация
  • Итог: пошаговый план реорганизации

Сценарий 3: Техническое решение

Участники: Архитектор ПО, DevOps-инженер, Security-эксперт

Вопрос: "Какую архитектуру выбрать для высоконагруженного сервиса?"

  • Архитектор: выбор технологий, паттерны проектирования
  • DevOps: инфраструктура, масштабируемость, мониторинг
  • Security: безопасность, защита данных, compliance
  • Итог: техническое задание с учетом всех аспектов

Преимущества режима совещания

  • Многогранный анализ: взгляд на проблему с разных профессиональных точек зрения
  • Экономия времени: не нужно консультироваться с разными специалистами по отдельности
  • Структурированный результат: автоматический саммарайз со всеми выводами
  • Учет всех аспектов: технические, финансовые, юридические, маркетинговые
  • Объективность: разные мнения помогают избежать однобокого решения
Ограничения использования: Режим совещания доступен ограниченное количество раз в день (зависит от тарифа). Для гостей: 2 совещания в день, для Pro: 20 совещаний в день.

Стриминг в реальном времени

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

Аналитика

Отслеживайте эффективность ваших ассистентов с помощью встроенной системы аналитики.

Доступные метрики

Количество диалогов

Общее число чатов, созданных пользователями с вашим ассистентом

Уникальные пользователи

Сколько разных людей общались с ассистентом

Активность по дням

График обращений за последние 30 дней

Среднее время сессии

Как долго пользователи общаются с ассистентом

Панель аналитики

Панель аналитики с графиками и метриками

Просмотр диалогов клиентов

Для ассистентов со встроенным виджетом на сайте вы можете просматривать историю диалогов пользователей. Это помогает:

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

Как просмотреть диалоги?

Нажмите на счетчик посещений
В карточке ассистента с встроенным виджетом кликните на число рядом с иконкой
Выберите диалог
Откроется список всех чатов. Нажмите на нужный, чтобы увидеть полную историю сообщений.
Список диалогов клиентов

Список всех диалогов пользователей с ассистентом

Обратите внимание: Функция просмотра диалогов доступна только для ассистентов, встроенных на сайт. Диалоги в Telegram-ботах недоступны для просмотра в целях конфиденциальности.
Конфиденциальность: Доступ к диалогам имеет только владелец ассистента. Личные данные пользователей защищены в соответствии с политикой конфиденциальности.

Маркетплейс ассистентов

Маркетплейс — это площадка, где пользователи могут находить и использовать готовых ассистентов, созданных другими авторами.

Публикация ассистента в маркетплейс

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

1. Подготовьте ассистента
Убедитесь, что ассистент работает корректно, имеет понятное название, описание и качественный аватар.
2. Нажмите "Опубликовать в маркетплейс"
Кнопка находится в карточке ассистента в панели управления.
3. Заполните информацию
Категория, теги, подробное описание возможностей, скриншоты (опционально).
4. Отправьте на модерацию
Ассистент попадает в очередь на проверку модераторами (обычно 1-2 дня).
5. Получите одобрение
После проверки ассистент появится в маркетплейсе, и другие пользователи смогут его использовать.
Маркетплейс ассистентов

Каталог готовых ассистентов в маркетплейсе

Требования к публикации

  • Качественное описание: подробно объясните, что умеет ассистент
  • Корректный промпт: ассистент должен работать без ошибок
  • Аватар: обязателен для публикации
  • Уникальность: не копируйте чужих ассистентов
  • Легальность: контент не должен нарушать законы или авторские права

Причины отклонения

Ассистент может быть отклонен модерацией, если:

  • Неполное или вводящее в заблуждение описание
  • Ассистент не работает должным образом
  • Содержит запрещенный контент
  • Нарушает авторские права
  • Дублирует уже существующих ассистентов

Важно

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

Использование ассистентов из маркетплейса

Вы можете добавить любого ассистента из маркетплейса в свой аккаунт:

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

Массовые рассылки

Для Telegram-ботов доступна функция массовых рассылок — отправка сообщений всем пользователям, которые писали боту.

Создание рассылки

1. Откройте форму рассылки
В панели управления найдите ассистента с подключенным Telegram и нажмите кнопку "Сделать рассылку"
2. Напишите текст сообщения
Используйте Markdown для форматирования: **жирный**, *курсив*, `код`, [ссылки](url)
3. Добавьте персонализацию
Используйте теги {name} и {username} для подстановки имени пользователя
4. Проверьте предпросмотр
Справа отображается, как сообщение будет выглядеть в Telegram
5. Отправьте рассылку
Нажмите "Отправить рассылку". Процесс может занять несколько минут.
Интерфейс создания рассылки

Форма создания массовой рассылки для Telegram-бота

Примеры рассылок

Пример 1: Новость о продукте

Привет, {name}! 🎉 У нас **отличные новости**! Мы запустили новую линейку продуктов специально для вас. Теперь доступны: - Тариф Premium Pro - Расширенная аналитика - Приоритетная поддержка Успей оформить подписку со скидкой 30% до конца месяца! [Узнать подробнее →](https://your-site.com/premium)

Пример 2: Напоминание

Привет! 👋 Давно тебя не было! Мы скучали 😊 У нас появилось много **нового функционала**: ✅ Режим совещания с 3 экспертами ✅ Улучшенная база знаний ✅ Новые динамические кнопки Заходи, протестируем вместе! 🚀

Статистика рассылки

После отправки вы увидите статистику:

  • Отправлено: количество успешно доставленных сообщений
  • Не доставлено: пользователи, заблокировавшие бота
  • Ошибки: технические проблемы при отправке
Важно: Не злоупотребляйте рассылками! Telegram может заблокировать бота за спам. Рекомендуемая частота: не чаще 1-2 раз в неделю.

Лучшие практики рассылок

  • Персонализация: обращайтесь по имени
  • Ценность: предлагайте что-то полезное, а не только рекламу
  • Краткость: короткие сообщения читают чаще
  • Call-to-action: добавляйте четкий призыв к действию
  • Эмодзи: делают сообщение живым, но не переборщите
  • Время отправки: рассылайте в активные часы (10:00-20:00)

Часто задаваемые вопросы (FAQ)

Ответы на самые популярные вопросы пользователей SpellBook.

Сколько стоит использование платформы?

Бесплатный тариф дает 5 сообщений для тестирования. Для полноценной работы доступны платные тарифы: Pro (2990₽/мес) с безлимитными сообщениями и Партнер (9900₽/мес) с возможностью заработка через партнерскую программу.

Как работает бесплатный тариф?

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

Нужны ли технические знания для создания ассистента?

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

Могу ли я продавать своих ассистентов?

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

Какие модели ИИ доступны?

Мы предоставляем доступ к последним версиям ChatGPT-5, оптимизированным для качественных ответов. Также используется fallback-модель для обеспечения стабильности работы.

Как изменить системный промпт уже созданного ассистента?

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

Мой Telegram-бот не отвечает. Что делать?

Проверьте: 1) Правильность токена бота, 2) Включена ли Telegram-интеграция в настройках ассистента, 3) Наличие активной подписки, 4) Попробуйте переподключить бота — удалите токен, сохраните, затем вставьте снова.

Как удалить ассистента?

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

База знаний не работает. Ассистент не использует мои документы.

Убедитесь: 1) Файлы успешно обработаны (статус "Готово"), 2) База знаний подключена к ассистенту в настройках, 3) Вопрос пользователя релевантен содержимому документов. Попробуйте задать более конкретный вопрос, связанный с загруженными материалами.

Как работает режим совещания?

Режим совещания использует 2-3 ассистента для анализа одного вопроса. Каждый эксперт дает свой ответ, затем создается итоговый саммарайз. Доступность зависит от тарифа: бесплатный — недоступно, Pro — 1 в неделю, Партнер — 60 в месяц.

Можно ли получить пассивный доход с помощью SpellBook?

Да! На тарифе Партнер работает MLM-программа с 3 уровнями: 1 уровень — 20%, 2 уровень — 10%, 3 уровень — 5%. Приглашайте пользователей по реферальной ссылке и получайте процент от их подписок.

Есть ли API для интеграции?

Нет, платформа SpellBook не предоставляет REST API для сторонних интеграций. Доступны встраивание виджета на сайт через JavaScript и Telegram-боты.

Решение проблем

Столкнулись с проблемой? Вот решения самых частых ситуаций.

Ассистент дает некорректные ответы

Возможные причины и решения:

  • Нечеткий промпт: Уточните системный промпт, добавьте больше деталей о роли и ограничениях
  • Недостаточно контекста: Добавьте базу знаний с релевантной информацией
  • Слишком общие вопросы: Попросите пользователей задавать более конкретные вопросы
  • Противоречивые инструкции: Проверьте промпт на логические противоречия

Виджет на сайте не загружается

Проверьте следующее:

  • Код встраивания вставлен перед </body>
  • В коде указан правильный ID ассистента
  • Нет блокировки скриптов от AdBlock или антивируса
  • Браузер поддерживает современный JavaScript (обновите браузер)
  • Нет ошибок в консоли браузера (F12 → Console)

Telegram-бот не отвечает на сообщения

Шаги для решения:

  1. Убедитесь, что токен бота указан правильно (без пробелов)
  2. Проверьте, включен ли переключатель "Включить Telegram"
  3. Убедитесь, что у вас активна подписка (Pro или Партнер)
  4. Попробуйте отправить команду /start боту
  5. Переподключите бота: удалите токен, сохраните, добавьте снова
  6. Проверьте, не заблокирован ли бот в Telegram

Файл базы знаний не обрабатывается

Возможные причины:

  • Слишком большой файл: максимум 5 МБ
  • Неподдерживаемый формат: используйте PDF, DOCX, TXT, CSV, XLSX
  • Поврежденный файл: попробуйте пересохранить документ
  • Защищен паролем: снимите защиту и загрузите снова
  • Скан без OCR: система не распознает текст с изображений

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

Закончились бесплатные сообщения

Что делать:

  • Оформите подписку Pro (2990₽/мес) для безлимитного использования
  • Используйте промокод, если он у вас есть
  • Станьте Партнером (9900₽/мес) и зарабатывайте, приглашая других пользователей
  • Оптимизируйте промпты для более коротких ответов

Ассистент отклонен при публикации в маркетплейс

Частые причины отклонения:

  • Неполное или неясное описание функционала
  • Отсутствие аватара или некачественное изображение
  • Ассистент не работает должным образом (протестируйте перед публикацией)
  • Дублирование существующих ассистентов в маркетплейсе
  • Нарушение правил платформы или содержание запрещенного контента

Исправьте указанные замечания и отправьте на модерацию повторно.

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

Проверьте:

  • Включена ли галочка "Включить динамические кнопки" в настройках
  • Системный промпт достаточно подробен и описывает цели ассистента
  • Диалог имеет достаточно контекста (кнопки генерируются на основе содержания)
Не нашли решение? Свяжитесь с технической поддержкой в Telegram: @Spellbook_tech. Мы ответим в течение 24 часов!
SpellBook

Полная документация платформы

Присоединяйтесь к нашему сообществу

Наш канал Тех. поддержка

Получайте промокоды, новости и помощь от команды SpellBook

© 2025 SpellBook. Все права защищены.

Главная Маркетплейс Обучение Поддержка