Chatballs: open-source чатбот поддержки с ИИ, который работает на вашем сервере

Нет, стоп. Давайте я напишу правильную новость по предоставленному источнику.

---

Chatballs собирает обращения из Telegram, MAX, почты и веб-чата в одном окне, где первой отвечает нейросеть, а оператор подключается только когда бот не справился, и всё это разворачивается на вашем сервере под открытой лицензией.

Автор проекта, практикующий разработчик с опытом более 15 лет, столкнулся с типичной задачей: пользователи пишут отовсюду, вопросы повторяются, а готовые платформы либо не поддерживают нужные каналы, либо тянут за собой CRM и воронки продаж. Ни один существующий инструмент не закрыл все требования, поэтому появился Chatballs. Источник: репозиторий на GitHub и сайт проекта.

Какую задачу решает Chatballs?

Chatballs берёт на себя первую линию поддержки пользователей. Это не CRM и не замена колл-центра.

Схема простая:

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

Оператор при этом работает со всеми каналами из одного интерфейса и не переключается между Telegram, почтой и другими окнами.

Что понадобится

• Собственный сервер для установки (Chatballs работает только в режиме self-hosted, то есть разворачивается на вашем оборудовании, а не в чужом облаке).
• PostgreSQL с расширением pgvector для семантического поиска по базе знаний (система разбивает текст на фрагменты и создаёт эмбеддинги, числовые представления смысла, чтобы находить релевантные ответы).
• Токен Telegram-бота и/или аккаунт MAX, если нужны эти каналы.
• Доступ к IMAP/SMTP, если подключаете почту.
• AI-провайдер на ваш выбор: система позволяет указать своего поставщика нейросетей для генерации ответов и для распознавания голоса (speech-to-text, перевод голосового сообщения в текст).
• Время на настройку: от получаса на базовую установку до нескольких часов на заполнение базы знаний и создание нескольких агентов.

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

1. Клонируйте репозиторий с GitHub:

git clone https://github.com/dartdavros/chatballs.git

1. Разверните систему на сервере по инструкции из репозитория. Chatballs распространяется под лицензией AGPL-3.0, то есть код открыт, и вы можете его изучить и доработать.

2. Подключите каналы. В настройках добавьте Telegram, MAX, почту через IMAP/SMTP. Для веб-чата на сайте вставьте виджет:

<script src="https://support.example.ru/chat-widget.js"
        data-widget-key="ваш_ключ" async></script>

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

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

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

1. Наполните базу знаний. Создайте категории и статьи. Каждая статья может содержать текст и вложения. Знания привязываются к конкретным агентам: агент одного продукта не видит документацию другого.

2. Настройте группы сотрудников. Например: техническая поддержка, продажи, бухгалтерия. Каждая точка входа связывается с агентом и группой, которая получает обращения при эскалации.

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

Как устроена передача диалога человеку?

Пока вопрос в зоне ответственности агента, отвечает нейросеть. Диалог переходит к оператору по нескольким причинам:

• Пользователь сам попросил человека.
• В базе знаний нет ответа.
• Агент не уверен в результате.
• Вопрос требует индивидуальной проверки.
• Оператор забрал диалог вручную.

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

Что делать с этим прямо сейчас, по ролям

Автору на Дзене. Если вы ведёте канал и получаете однотипные вопросы в личку или комментарии, Chatballs позволяет собрать базу ответов и отдать рутину чатботу поддержки. Подключите Telegram-бота, загрузите FAQ, и агент будет отвечать за вас на повторяющиеся вопросы про рекламу, сотрудничество и навигацию по каналу.

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

Предпринимателю в РФ. Платформа работает на вашем сервере, данные не уходят в чужое облако. Поддержка MAX, мессенджера, который набирает аудиторию в России, уже встроена. Западные аналоги этот канал не поддерживают. Код открыт, лицензия AGPL-3.0, подписка не нужна.

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