Инструкции по WebAI

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

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

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

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

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

После входа

• Обзор — статус, быстрые действия, что сделать дальше
• Агенты — список и редактор агента
• Заявки — все лиды с виджета
• Баланс — пакеты токенов и оплата
• Настройки — аккаунт и вход

Пять шагов настройки

Откройте агента в кабинете. Редактор идёт по шагам ?step=1…5. Справа — живой превью виджета.

Код на сайт

Один скрипт. Атрибут 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.

Тексты и база знаний агента

На шаге «Тексты» заполните то, что посетитель видит, и то, по чему отвечает модель.

Что видит посетитель

• Приветственный пузырь — короткое сообщение при открытии
• Автооткрытие — через N секунд (можно отключить, поставив 0)
• Подзаголовок / welcome / placeholder — тон диалога
• Быстрые ответы — кнопки-подсказки под полем ввода
• Звук ответа — опционально

База знаний (поле в кабинете)

Текстовая инструкция до 20 000 символов. Сюда пишите факты: услуги, цены, условия, FAQ, запреты («не называй цены, которых нет в тексте»).

Раздел «База знаний» в меню кабинета — заготовка под загрузку файлов. Пока рабочие знания задаются полем на шаге «Тексты» у агента. Для обучения по PDF и договорам — услуга Агент по документам.

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

Макеты чата

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

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

• Формы: rounded, circle, pill, avatar, dock
• Иконка и подпись на кнопке
• Для dock — отдельные тексты лида

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

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

«Powered by WebAI»

Плашку можно скрыть на тарифе Business. На Online она обычно видна.

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

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

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

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

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

Подключение @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.

Для сложных CRM и внутренних процессов компании смотрите Агент для бизнеса — внедрение под ключ.

Подписки, тест и токены

• 7 дней теста после старта — агент онлайн
• Без оплаты после теста виджет на паузе; настройки и знания сохраняются
• Токены — доп. ответы сверх лимита месяца; остаток до 12 месяцев
• Сначала тратится лимит подписки, потом токены
• Без активной подписки агент офлайн, даже если токены остались

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

• Мини — 50 BYN · ~240 ответов
• Старт — 150 BYN · ~800
• Бизнес — 400 BYN · ~2400
• Pro — 900 BYN · ~6400

Внедрение под ключ

• Документы — от 2 340 BYN (+ месяц Online)
• Для бизнеса — от 5 850 BYN (+ месяц Business)

Оплата: счёт / ЕРИП / карта — как договоримся. Пакеты в разделе «Баланс» кабинета; онлайн-оплата картой в кабинете расширяется.

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

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

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

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

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