Golova Bot

Вход в панель управления

Пароль задаётся в файле .env (ADMIN_PASSWORD). По умолчанию: admin

…

Нейросеть

Ключ хранится только на вашем сервере в базе данных и никогда не отдаётся в браузер клиента.

Бот

Как бот представляется и ведёт себя. Сценарии и факты загружаются во вкладке «Скрипты».

Доступ виджета

Ключ виджета публичный (он в коде страницы), а список доменов не даёт чужим сайтам пользоваться вашим ботом.

…

Скрипты и материалы

Сценарии разговоров, прайсы, ответы на вопросы. Форматы: .txt, .md, .docx, .pdf. Пример лежит в папке examples/.

Перетащите файлы сюда или нажмите, чтобы выбрать
или вставить текст вручную

Анализ скриптов → playbook

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

Тестируйте через кнопку чата справа внизу.

Мессенджеры

Один и тот же бот с теми же скриптами отвечает в Telegram, Max, WhatsApp и Viber. Все диалоги видны во вкладке «Диалоги». Кнопки «Продолжить в мессенджере» в виджете переносят разговор с сайта вместе с историей.

Telegram и Max работают и без него (long polling). WhatsApp и Viber принимают сообщения только через вебхук, им адрес обязателен. Для локальной проверки подойдёт туннель (ngrok, cloudflared).

Telegram выключен

Как получить токен

1. В Telegram откройте @BotFather → /newbot → придумайте имя и username бота.
2. Скопируйте токен сюда, нажмите «Проверить токен» и «Сохранить».
3. Напишите боту любое сообщение — он ответит по вашим скриптам. Без публичного адреса бот работает через long polling, пока запущен сервер.

Вебхук (при заданном публичном адресе): —

Max выключен

Как получить токен

1. Зайдите на business.max.ru/self под аккаунтом Max. Нужен подтверждённый профиль организации, ИП или самозанятого (для физлиц ботов нет).
2. Раздел «Чат-боты» → «Создать»: логотип 500×500, название, описание до 200 символов. Имя бота вида idИНН_bot платформа задаёт сама.
3. Бот уходит на модерацию, до 48 рабочих часов. Уведомление придёт в Max от бота «MAX для бизнеса».
4. Когда статус станет «создан», в карточке бота появится токен. Вставьте его сюда, нажмите «Проверить токен» и «Сохранить».

Ссылка на бота: https://max.ru/имя_бота, с переносом истории: https://max.ru/имя_бота?start=КОД. Документация: dev.max.ru.

Вебхук: —

WhatsApp выключен

Кнопка «Продолжить в WhatsApp» работает даже без подключения API: достаточно номера. Чтобы бот сам отвечал в WhatsApp, нужен WhatsApp Business Cloud API (Meta) и публичный адрес сервера.

Webhook URL: укажите публичный адрес
Verify token: —
Как подключить Cloud API

1. developers.facebook.com → создайте приложение типа Business → добавьте продукт WhatsApp.
2. В разделе API Setup возьмите Phone number ID и создайте постоянный токен (System user с правом whatsapp_business_messaging).
3. В Configuration → Webhook укажите Webhook URL и Verify token отсюда, подпишитесь на поле messages.
4. Включите галочку выше, сохраните.

Viber выключен

Webhook URL: укажите публичный адрес
Как получить токен

partners.viber.com → Create Bot Account → скопируйте токен. Вебхук ставится автоматически при сохранении с включённой галочкой и заданным публичным адресом.

Уведомления менеджеру

Приходят в Telegram через вашего бота из раздела выше. Чтобы узнать chat_id, напишите боту команду /id (для группы добавьте бота в неё и напишите /id там).

Голосовой звонок в виджете

В шапке чата появляется кнопка «Позвонить»: клиент говорит, бот отвечает голосом по тем же скриптам. Разговор попадает в «Диалоги» текстом.

В голосе бот отвечает быстрой моделью с минимальными рассуждениями и коротко. Для текстового чата эти настройки не действуют.

Как выбрать движок

Браузерный. Речь распознаёт и озвучивает сам браузер клиента (Chrome, Edge, Safari; в Firefox распознавания нет). Ответы генерирует ваш текущий провайдер, поэтому платите только за текст. Задержка 2–4 секунды на реплику, голос зависит от системы клиента. Подходит для старта.

OpenAI Realtime. Живой разговор без пауз, естественный голос, можно перебивать. Аудио идёт напрямую из браузера в OpenAI по WebRTC, сервер лишь выдаёт одноразовый ключ с вашими скриптами. Нужен ключ OpenAI в разделе «Нейросеть» (даже если чат работает на Claude). Ориентировочно от нескольких до десятков центов за минуту разговора, следите за балансом.

Если бот отвечает с задержкой. Главная причина обычно модель: gpt-5 и Opus «думают» перед ответом. Для голоса автоматически берётся быстрая модель, а для текстового чата уменьшите «Глубину рассуждений» в разделе «Нейросеть». Озвучка использует голоса вашей системы: на Mac установите улучшенный русский голос (Настройки → Универсальный доступ → Речь → Системный голос → Управление голосами), звучит заметно естественнее. Самый быстрый и живой вариант — движок OpenAI Realtime.

Микрофон в браузере доступен только по HTTPS или на localhost, поэтому на реальном сайте нужен https-адрес сервера.

Диалоги

обновляются автоматически
Пока пусто
Выберите диалог
Выберите диалог

Код для вставки на сайт

Вставьте перед закрывающим тегом </body> на всех страницах сайта.


      
Открыть демо-страницу

      
Сейчас адрес сервера . После переноса на сервер с доменом откройте эту вкладку там, и код обновится сам.

    

    

      
Куда вставлять

      
Tilda: Настройки сайта → Ещё → «HTML-код для вставки внутрь BODY» → вставить → Сохранить → Опубликовать все страницы.

      
WordPress: плагин «WPCode» или «Insert Headers and Footers» → раздел Footer → вставить. Или в файл темы footer.php перед </body>.

      
Свой сайт: в общий шаблон страницы перед </body>.

      
Запуск на сервере: скопируйте папку проекта на VPS, задайте пароль в .env и выполните docker compose up -d --build. Подробнее в README.md.

      
Программный вызов: GolovaBot.open() открывает чат, GolovaBot.call() сразу начинает голосовой звонок — можно повесить на свою кнопку «Позвонить» на сайте.