Как установить ИИ-агента на сайт

Быстрый старт за 5 шагов

1. Войдите в кабинет По кнопке «Войти» на сайте или по адресу /cabinet/. Нужен номер телефона Беларуси (+375).
2. Создайте агента В разделе «Агенты» нажмите создать. Появится ID вида wa_ + 12 символов.
3. Пройдите 6 шагов редактора Профиль → макет → тексты → форма заявки → уведомления → обучение ИИ (цены, контакты, база знаний).
4. Вставьте код на сайт Скопируйте скрипт из карточки агента и поставьте перед </body>.
5. Включите агента и проверьте Переключатель «Включён на сайте» → откройте сайт → напишите в виджет тестовый вопрос.

Вход по телефону

Авторизация без пароля: телефон → код из SMS → вход.

1. Нажмите «Войти» в шапке или откройте кабинет.
2. Введите номер в формате +375 (XX) XXX-XX-XX.
3. Нажмите «Получить код».
4. Введите код из SMS и нажмите «Войти».

После входа

• Обзор — сводка за 7 дней, график, последние заявки и диалоги
• Агенты — список, редактор и код установки
• Баланс — пакеты ответов и оплата (счёт / ЕРИП)
• Расход — ответы по дням и последние диалоги
• Диалоги — все чаты, конверсия чат → контакт
• Заявки — лиды с виджета и статусы
• База знаний — обзор тарифов обучения (Старт → Премиум)
• Тикеты — поддержка
• Настройки — профиль, Telegram, дайджест чатов

Шесть шагов настройки

Откройте агента в кабинете. Редактор идёт по шагам ?step=1…6. Справа внизу — живой превью виджета: меняете настройки — сразу видно, как на сайте.

Код на сайт

Один скрипт. Атрибут data-agent — ваш ID из кабинета (формат wa_ + 12 шестнадцатеричных символов).

<script src="https://webai.by/embed.js" data-agent="wa_xxxxxxxxxxxx" defer></script>

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

• Перед закрывающим тегом </body> на всех страницах, где нужен виджет
• Либо в общий шаблон / footer CMS (Bitrix, WordPress, Tilda — через HTML-блок)
• Атрибут defer уже в примере — не убирайте без причины

Что делает скрипт

1. Проверяет data-agent
2. Запрашивает конфиг: /api/agent-config.php?id=…
3. Подключает стили и виджет, монтирует чат на странице

Частые ошибки

• Нет или битый data-agent → в консоли: укажите data-agent="wa_…"
• Агент выключен → «агент недоступен»
• Скрипт только на одной странице → на остальных кнопки не будет
• Два одинаковых embed на странице → оставьте один

Код также лежит в карточке агента в кабинете — копируйте оттуда, чтобы не ошибиться в ID.

Шаг 6 — обучение ИИ

Это главный шаг для качества ответов. Откройте агента → Обучение ИИ (?step=6). Справа виден индикатор готовности (о бизнесе, цены, контакты, сайт, база знаний).

Тарифы обучения

• Старт — база до 2 000 символов, поля вручную + изучение одной страницы. Ответ +5%. По умолчанию и в пакетах Тест-драйв / Локальный бизнес.
• Старт+ — база до 10 000 символов, sitemap до 5 страниц, умное ИИ‑извлечение. Ответ +10%. Открывается пакетом Интернет-магазин (150 BYN).
• Бизнес — база до 40 000 символов, sitemap до 15 страниц. Ответ +20%. Открывается пакетом Отдел продаж (400 BYN).
• Про — база до 100 000 символов, до 50 страниц sitemap. Ответ +30%. Открывается пакетом Масштаб / Ultra (900 BYN).
• Премиум — база до 500 000 символов, до 120 страниц sitemap. Ответ +40% (по запросу / отдельно).

Что заполнить

1. О компании и цены — два главных блока, на них агент опирается в каждом ответе.
2. Контакты — телефоны, email, адрес, часы, соцсети (реальные данные, без выдумок).
3. Страница сайта — URL услуг/цен → «Изучить и заполнить». На Старт+ и выше — «Обойти sitemap».
4. Стиль ответов — характер агента (дружелюбный, поддержка, эксперт и др.).
5. База знаний (промпт) — FAQ, правила, блок «Чего не делать». Есть шаблон FAQ и подсказки по темам.

После правок нажмите «Сохранить обучение». Раздел «База знаний» в меню кабинета — обзор тарифов; рабочие поля — только в шаге 6 редактора агента.

Макет, кнопка и позиция

Темы и аватар (шаг 1)

32 палитры (классика, градиенты, узоры, космос). Аватар: стоковые лица (фото, силуэты, мультики, боты, маскоты) или загрузка своего JPG/PNG.

Макеты чата (шаг 2)

Classic, compact, soft — выбирайте под плотность сайта.

Кнопка запуска

• Формы: rounded, circle, pill, avatar, dock
• Иконка и подпись на кнопке
• Для dock — отдельные тексты лида
• Автооткрытие чата — через N секунд (0 = выкл.)

Позиция на экране

Карта позиций: слева / по центру / справа / mid-left / mid-right. Проверьте на мобильном: кнопка не должна перекрывать корзину или чат мессенджера.

Цвета поля ввода (шаг 3)

На тёмных темах фон и текст поля задаются отдельно. По умолчанию поле светлое — так текст читается на тёмном виджете. «С темы» — вернуть авто.

«Powered by WebAI»

Плашку можно скрыть на шаге «Макет и кнопка» (white-label). Доступно при активном пакете Отдел продаж (обучение Бизнес).

Форма заявки в виджете

1. Шаг 4 → включите «Показывать форму заявки».
2. Настройте заголовок, кнопку и текст успеха.
3. Включите нужные поля: имя, телефон, email, компания, город, сообщение.
4. Отметьте обязательные (по умолчанию телефон обязателен).

Заявки всегда попадают в кабинет → Заявки, даже если Telegram или email не настроены.

Заявка из текста чата

Посетитель может написать контакт в сообщении — телефон с пробелами или без, имя в одной строке. Если агент подтвердил, что свяжется («оставьте номер — перезвоним»), заявка сохранится автоматически. Повтор с тем же номером за 6 часов обновит существующую заявку, а не создаст дубликат.

На главной кабинета («Обзор») и в разделах Заявки / Диалоги видна статистика и конверсия чат → контакт.

Когда форма не появится

• Форма выключена в настройках
• Агент выключен на сайте

Подключение @webaiby_bot

Бот @webaiby_bot шлёт уведомления о заявках в ваш Telegram.

1. Откройте агента → шаг «Уведомления».
2. Нажмите «Подключить Telegram».
3. Откроется ссылка вида t.me/webaiby_bot?start=… (действует около 30 минут).
4. В Telegram нажмите Start.
5. Бот ответит «Готово» — кабинет подтянет статус сам.

• Один Telegram-чат привязывается к одному аккаунту кабинета
• Отключить можно той же кнопкой в уведомлениях
• Без персональной ссылки из кабинета бот попросит подключиться оттуда

Email и webhook в CRM

Email

На шаге «Уведомления» укажите адрес — копия заявки уйдёт на почту (через серверную отправку).

Webhook

Укажите HTTPS URL. При новой заявке WebAI отправит POST с JSON:

{
  "event": "webai.lead",
  "agent_id": "wa_xxxxxxxxxxxx",
  "lead": { /* поля заявки */ }
}

Принимающая сторона должна отвечать 2xx. Используйте для amoCRM, Bitrix24, своих скриптов или Make/n8n.

Webhook удобен для amoCRM, Bitrix24, Make/n8n. Настройка — в кабинете на шаге «Уведомления».

Тест и пакеты ответов

Те же тарифы, что в кабинете и на странице Цены. Для бизнеса в Беларуси — договор с ООО «Портал 360», оплата в BYN (счёт / ЕРИП).

• 7 дней теста после старта — агент онлайн
• Без баланса после теста виджет на паузе; настройки и обучение сохраняются
• Каждый ответ списывается с баланса пакета
• Чем больше пакет — тем выгоднее ответ

Пакеты ответов

• Тест-драйв — 19 BYN · ~144 ответа (обучение Старт)
• Локальный бизнес — 50 BYN · ~384 ответа (обучение Старт)
• Интернет-магазин — 150 BYN · ~1 280 ответов (+ обучение Старт+)
• Отдел продаж — 400 BYN · ~3 840 ответов (+ обучение Бизнес)
• Масштаб / Ultra — 900 BYN · ~10 240 ответов (+ обучение Про)

Нужна помощь с установкой скрипта — оставьте заявку. Оплата в кабинете → «Баланс». Подробный разбор — в статье про цены и на странице для бизнеса в Беларуси.

Как проверить, что всё работает

1. Агент включён, на шаге 6 сохранено обучение, код на сайте с верным ID.
2. Откройте сайт в режиме инкогнито (без кэша админки).
3. Должна появиться кнопка виджета → откройте чат → задайте вопрос из обучения / базы знаний.
4. Отправьте тестовую заявку → она в «Заявках» и (если подключено) в Telegram / email / webhook.

Если виджет не виден

• Откройте консоль браузера (F12) — сообщения начинаются с [WebAI]
• Проверьте блокировщики рекламы и CSP сайта (должен разрешать webai.by)
• Убедитесь, что страница отдаётся по HTTPS (смешанный контент реже, но бывает на http-сайтах)

Страницы и статьи в помощь

Помимо этой инструкции на сайте есть посадочные и блог — удобно отправить клиенту или команде.

FAQ · весь блог · продуктовая страница виджета

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