Wiki по проекту ОтветБот

О сервисе

ОтветБот — это инновационный сервис для создания умных ассистентов, которые отвечают на вопросы ваших клиентов 24/7 на основе вашей базы знаний. Вам не нужно программировать или нанимать разработчиков — просто загрузите документы и подключите бота.

Что умеет ОтветБот?

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

Преимущества перед традиционной поддержкой

Регистрация

Как зарегистрироваться?

Регистрация в сервисе ОтветБот занимает не более 2 минут и не требует специальных знаний. Следуйте простой пошаговой инструкции:

Что после регистрации?

После успешной регистрации вы попадёте в личный кабинет — центр управления вашим ботом. Здесь вы сможете:

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

Создание бота в сервисе ОтветБот — это простой процесс, который занимает несколько минут. Вы можете создать ботов для трёх популярных платформ: Telegram, ВКонтакте и Мессенджер MAX. Все боты аккаунта используют общую базу знаний.

Telegram бот

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

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

1. Откройте приложение Telegram на вашем устройстве
2. В поиске найдите официального бота @BotFather — это сервис для создания и управления ботами
3. Нажмите кнопку «Запустить» или отправьте команду /start
4. Отправьте команду /newbot для создания нового бота
5. Следуйте инструкциям BotFather: придумайте имя бота (как он будет отображаться в списке контактов) и username (уникальный идентификатор, должен заканчиваться на «bot»)
6. После успешного создания BotFather пришлёт вам токен — сохраните его, он понадобится для подключения
7. В личном кабинете ОтветБот перейдите в раздел «Боты» → «Telegram»
8. Вставьте токен в соответствующее поле и нажмите «Сохранить»
9. Проверьте работу: найдите вашего бота в Telegram и отправьте тестовое сообщение

Советы по настройке Telegram бота:

• Выбирайте понятное имя бота, связанное с вашим брендом
• Username должен быть уникальным и легко запоминающимся
• Настройте аватар и описание бота через BotFather командой /setuserpic и /setdescription

VK бот

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

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

1. Создайте сообщество ВКонтакте (группу, встречу или публичную страницу), если у вас его ещё нет
2. Перейдите в настройки сообщества: «Управление» → «Сообщения»
3. Включите сообщения сообщества (выберите «Для всех пользователей» или «Только для участников»)
4. Перейдите в «Управление» → «Сообщения» → «Настройки для бота»
5. Включите пункт «Возможности ботов»
6. Включите Bots Long Poll API (позволяет боту получать события в реальном времени без настройки сервера)
7. Перейдите в «Управление» → «Дополнительно» → «Работа с API»
8. На вкладке «Ключи доступа» нажмите кнопку «Создать ключ»
9. Выберите права доступа: отметьте «messages» (Доступ к сообщениям сообщества)
10. Подтвердите создание ключа в мобильном приложении ВКонтакте или по СМС
11. Скопируйте полученный ключ доступа (токен)
12. Узнайте ID группы: он указан в URL страницы группы (число после public или club) или можно найти в настройках
13. В личном кабинете ОтветБот перейдите в раздел «Боты» → «VK»
14. Вставьте токен и ID группы в соответствующие поля
15. Проверьте работу: найдите вашего бота в VK и отправьте тестовое сообщение

Советы по настройке VK бота:

• Используйте официальное название вашей компании для группы
• Загрузите логотип и обложку группы для узнаваемости
• Настройте приветственное сообщение для новых подписчиков
• Регулярно обновляйте информацию в группе

MAX бот

Мессенджер MAX — современная платформа для бизнес-коммуникации, разработанная VK. Бот MAX позволяет автоматизировать общение с клиентами и интегрироваться с бизнес-процессами. Для работы с чат-ботами необходимо иметь верифицированный профиль организации, ИП или самозанятого на платформе MAX для бизнеса.

Создание чат-бота в MAX:

1. Перейдите на платформу MAX для бизнеса по адресу business.max.ru
2. Выберите верифицированный профиль организации, ИП или самозанятого
3. В разделе «Чат-боты» нажмите кнопку «Создать»
4. Заполните данные в карточке бота: логотип (500х500 px, не более 5 МБ), название (1-59 символов), описание (не более 200 символов), телефон компании (опционально), сайт (опционально)
5. Ник бота генерируется автоматически по шаблону idИНН_bot для ИП/юрлиц или se(orgid)_bot для самозанятых
6. Нажмите «Создать» — бот перейдёт на модерацию
7. Дождитесь одобрения модерации (проверка занимает до 48 часов по рабочим дням)

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

После успешной модерации чат-бота токен станет доступен в расширенных настройках. Токен — уникальный идентификатор бота, с помощью которого он будет взаимодействовать с API MAX.

1. Перейдите на платформу MAX для бизнеса в раздел «Чат-боты»
2. Если у вас несколько ботов, выберите нужного из списка
3. Нажмите «Перейти» → «Расширенные настройки» → «Настроить»
4. Токен находится в поле с одноимённым названием
5. Скопируйте токен (пример: AAHdqTcvCH1vGWJxfSeofSAs0K5PALDsaw)

Подключение бота к ОтветБот:

1. В личном кабинете ОтветБот перейдите в раздел «Боты» → «MAX»
2. Вставьте токен в соответствующее поле
3. Нажмите «Сохранить»

Активация ботов

После добавления всех ботов (или одного) необходимо их активировать для начала работы.

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

1. В личном кабинете ОтветБот найдите тумблер статуса бота в верхней части страницы
2. Переключите тумблер в положение «Включено»
3. Проверьте работу: отправьте тестовое сообщение в каждом подключённом мессенджере

Безопасность токенов

Общие рекомендации по созданию ботов

• Начните с одной платформы, затем добавляйте другие по мере необходимости
• Загрузите документы перед активацией бота для качественных ответов
• Настройте приветственное сообщение для лучшего первого впечатления
• Регулярно анализируйте диалоги для улучшения качества ответов
• Используйте аналитику для понимания потребностей клиентов

Загрузка документов

Документы — это основа базы знаний вашего бота. Чем качественнее и релевантнее документы вы загрузите, тем точнее будут ответы бота. Сервис поддерживает загрузку документов в множестве форматов.

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

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

1. Войдите в личный кабинет ОтветБот
2. Перейдите в раздел «Документы» в левом меню или на главной странице личного кабинета
3. Нажмите кнопку «Загрузить документ» в правом верхнем углу
4. Выберите файл с вашего компьютера (поддерживаемые форматы: PDF, TXT, DOCX, DOC, MD, RTF, HTML, CSV, JSON, XML, LOG)
5. Дождитесь окончания загрузки файла
6. Документ автоматически отправится на обработку
7. Следите за статусом обработки в списке документов
8. После завершения обработки документ станет доступен для бота

Какие форматы поддерживаются?

Сервис поддерживает следующие форматы документов:

• PDF файлы — наиболее популярный формат для документов, инструкций, прайс-листов и другой структурированной информации. Поддерживаются текстовые PDF с возможностью копирования текста.
• Текстовые файлы (TXT) — простой формат для неструктурированных текстов, FAQ, инструкций и другой информации.
• Word документы (DOCX, DOC) — документы Microsoft Word в новых и старых форматах.
• Markdown (MD, MARKDOWN) — формат для технической документации и README файлов.
• Rich Text Format (RTF) — универсальный формат текстовых документов.
• HTML страницы (HTML, HTM) — веб-страницы и HTML-документы.
• CSV файлы — табличные данные, прайс-листы, каталоги.
• JSON файлы — структурированные данные в формате JSON.
• XML файлы — структурированные данные в формате XML.
• LOG файлы — лог-файлы и технические отчёты.

Требования к документам:

• Максимальный размер файла: 50 МБ
• PDF файлы должны содержать текст (не сканированные изображения)
• Текстовые файлы должны быть в кодировке UTF-8
• Документы должны быть на русском или английском языке

Статусы обработки

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

• Ожидает обработки — документ загружен и находится в очереди на обработку. Обычно обработка начинается в течение нескольких секунд.
• Обрабатывается — документ сейчас обрабатывается системой. Время обработки зависит от размера файла и может занять от нескольких секунд до нескольких минут.
• Готов — документ успешно обработан и готов к использованию. Бот может использовать его для ответов на вопросы.
• Ошибка — произошла ошибка при обработке документа. Попробуйте загрузить документ повторно или обратитесь в поддержку.

Как работает обработка документов?

При загрузке документа система выполняет следующие действия:

1. Извлекает текст из документа
2. Разбивает текст на смысловые фрагменты (чанки)
3. Создаёт векторные представления для каждого фрагмента
4. Сохраняет векторные представления в базе данных
5. Индексирует документ для быстрого поиска

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

Советы по загрузке документов

Для достижения наилучшего качества ответов следуйте рекомендациям:

• Загружайте релевантные документы — FAQ, инструкции, прайсы, регламенты, описания товаров и услуг
• Разбивайте большие документы на части для лучшего качества ответов. Оптимальный размер документа: 10-50 страниц
• Используйте структурированные документы с чёткими заголовками и разделами
• Регулярно обновляйте базу знаний — удаляйте устаревшие документы и добавляйте актуальные
• Проверяйте качество текста — избегайте опечаток, грамматических ошибок и неясных формулировок
• Загружайте документы на разных языках если вы работаете с международной аудиторией
• Организуйте документы по категориям для удобства управления

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

В личном кабинете вы можете:

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

Примеры документов для загрузки

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

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

Менеджеры

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

Добавление менеджеров

Для перенаправления вопросов менеджерам необходимо сначала добавить их в систему. Менеджеры — это сотрудники вашей компании, которые будут отвечать на сложные вопросы клиентов.

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

1. Войдите в личный кабинет ОтветБот
2. Перейдите в раздел «Менеджеры» в левом меню
3. Заполните форму добавления менеджера:
• Имя менеджера — укажите имя сотрудника
• Платформа — выберите одну платформу: Telegram, VK или MAX
• ID платформы — укажите числовой ID пользователя в выбранной платформе:
  • Для Telegram: числовой ID (можно узнать через @userinfobot)
  • Для VK: числовой ID пользователя
  • Для MAX: числовой ID пользователя
• Активен — включите переключатель, если менеджер готов принимать вопросы
• Начало работы (МСК) — укажите время начала рабочего дня по московскому времени
• Конец работы (МСК) — укажите время конца рабочего дня по московскому времени
4. Нажмите кнопку «Добавить менеджера»
5. Менеджер появится в списке справа и будет готов к работе

Советы по добавлению менеджеров:

Как работает перенаправление менеджерам?

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

Процесс перенаправления:

Условия перенаправления:

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

Настройка рабочего времени менеджеров

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

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

1. В личном кабинете перейдите в раздел «Менеджеры»
2. При добавлении менеджера укажите время начала и конца рабочего дня
3. Для редактирования рабочего времени нажмите кнопку «Редактировать» рядом с менеджером
4. Измените время начала и конца работы в полях формы
5. Нажмите кнопку «Обновить менеджера» для сохранения изменений

Особенности настройки рабочего времени:

• Единый часовой пояс — время указывается по московскому часовому поясу (МСК) для всех менеджеров
• Автоматический статус — система автоматически определяет, находится ли менеджер на работе
• Отображение статуса — в списке менеджеров показывается статус «Сейчас на работе» или «Не на работе»
• Переключатель «Активен» — можно временно отключить менеджера без изменения рабочего времени

Управление менеджерами

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

• Имя — имя менеджера
• Платформа и ID — выбранная платформа (Telegram, VK или MAX) и числовой ID
• Рабочее время — время начала и конца работы по московскому времени
• Статус активности — «Активен» или «Неактивен»
• Текущий статус — «Сейчас на работе» или «Не на работе»

Действия с менеджерами:

• Редактировать — нажмите кнопку «Редактировать» для изменения данных менеджера. Форма заполнится текущими данными, и вы сможете внести изменения
• Удалить — нажмите кнопку с иконкой корзины для удаления менеджера. Система запросит подтверждение удаления
• Изменить активность — при редактировании можно переключить статус «Активен» для временного отключения менеджера без удаления

Тарифы и оплата

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

Как работает тарификация?

Тарификация основана на количестве диалогов с ботом. Диалог — это одно сообщение пользователя боту и один ответ бота, подготовленный на основе загруженных документов. Один диалог расходует один диалог из пакета, независимо от количества сообщений в нём.

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

Примеры:

• Пользователь задал один вопрос и получил ответ — 1 диалог
• Пользователь задал 5 вопросов подряд — 5 диалогов
• Пользователь вернулся через час и задал новый вопрос — 1 диалог
• Пользователь написал «привет» и бот ответил «Здравствуйте» — 0 диалогов (бесплатно)
• Пользователь оставил отзыв и бот ответил — 0 диалогов (бесплатно)

Пакеты диалогов

Мы предлагаем различные пакеты диалогов для разных потребностей:

• Стартовый пакет — для тестирования и малого бизнеса
• Бизнес пакет — для растущих компаний с умеренным трафиком
• Корпоративный пакет — для крупных предприятий с высоким объёмом диалогов

Преимущества пакетов:

• Без срока действия — диалогы не сгорают, используйте их когда угодно
• Гибкость — выбирайте пакет под ваши потребности
• Прозрачность — вы всегда знаете сколько диалогов осталось
• Экономия — чем больше пакет, тем ниже цена за диалог

Как оплатить?

Оплата пакетов диалогов — простой и безопасный процесс.

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

1. Войдите в личный кабинет ОтветБот
2. Найдите кнопку «Купить пакет» в верхней части страницы
3. Нажмите кнопку «Купить пакет»
4. Выберите подходящий пакет из списка доступных
5. Проверьте детали заказа: количество диалогов и стоимость
6. Выберите способ оплаты: банковская карта, электронные кошельки или другие доступные методы
7. Если у вас есть промокод, введите его в специальное поле
8. Нажмите кнопку «Оплатить»
9. Вы будете перенаправлены на безопасную страницу платёжной системы
10. Следуйте инструкциям для завершения оплаты
11. После успешной оплаты диалоги будут автоматически зачислены на ваш баланс
12. Чек об оплате будет отправлен на почту, которую вы укажете при оплате

Способы оплаты

Поддерживаются следующие способы оплаты:

Промокоды

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

Инвайт-промокоды (регистрация)

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

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

Реферальные промокоды

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

• Приглашённый пользователь — при первой покупке комбинированного пакета с вашим промокодом получает бонусные диалоги и документы
• Вы (владелец промокода) — получаете награду после каждой N-й активации вашего промокода

Как активировать промокод?

Способ активации зависит от типа промокода:

• Инвайт-промокод — введите код на странице регистрации
• Реферальный промокод — введите код при покупке комбинированного пакета в личном кабинете

Ограничения промокодов:

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

Где найти свой реферальный промокод?

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

История платежей

В личном кабинете вы можете просматривать полную историю всех операций с балансом:

Советы по выбору пакета

Кейсы использования

API интеграция

Подключение вашего сервиса к API ОтветБот расширяет возможности использования и позволяет интегрировать интеллектуального ассистента в любые ваши приложения и платформы.

Возможности интеграции

Как начать работу с API?

1. Зарегистрируйтесь в сервисе ОтветБот
2. Загрузите документы в базу знаний
3. Получите API ключ в личном кабинете
4. Изучите документацию API (будет доступна в личном кабинете)
5. Начните интеграцию с вашим сервисом

Релизы и планы по развитию проекта

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

Последние релизы

Планы по развитию

FAQ

Поддержка

Если у вас остались вопросы, вы можете связаться с нами любым удобным способом:

Электронная почта

otvetbot@yandex.ru

Форма обратной связи

Доступна в личном кабинете

Telegram

@otvetbot_supportbot

VK

Написать в сообщество

MAX

Написать боту