Как установить ИИ-чат на сайт WordPress

Что вы устанавливаете: внешний виджет, а не чат внутри WordPress

ИИ-чат AiMaxChat на WordPress — это внешний виджет. Скрипт подключается к публичным страницам сайта и открывает окно диалога у посетителя. Посетителю не нужно входить в WordPress и не нужно логиниться в AiMaxChat, чтобы написать в чат. Вы один раз вставляете код или параметры бота, дальше внешний вид и база знаний управляются из кабинета сервиса, без правки темы после каждого изменения прайса.

Перед установкой на прод посмотрите публичное демо: так видно кнопку, окно диалога и поведение бота на учебной базе. Демо не подставляет ваш WordPress, но снижает сюрприз «а как это выглядит у клиента». Когда решите ставить на свой сайт, сначала создайте бота, загрузите документы и проверьте ответы в тест-чате кабинета. Ставить пустой виджет на боевой сайт незачем.

Есть два публичных пути установки. Первый — вставить готовый HTML-код с внешним script в тему, footer или блок «произвольный HTML». Второй — поставить официальный плагин AiMaxChat из zip-дистрибутива сервиса и прописать параметры бота в настройках. Не ищите в каталоге WordPress выдуманные названия вроде «AiMaxChat Pro 5.0»: используйте только официальный zip сервиса, без номера версии из головы.

Как вставить внешний script через HTML

Самый прямой путь не зависит от темы. В кабинете после создания бота вы копируете фрагмент: подключение script с CDN виджета и вызов инициализации с идентификатором бота, публичным токеном и URL API. Этот фрагмент вставляют перед закрывающим тегом body или в footer.php дочерней темы. Если правите родительскую тему напрямую, обновление темы затрёт вставку — лучше дочерняя тема или плагин вставки кода.

После публикации откройте публичную страницу в режиме инкогнито, без входа в админку WordPress. Кнопка чата должна появиться у гостя. Если виджета нет, проверьте кеш страницы, плагин оптимизации, который режет script, и то, что код не попал только на черновик. Конструкторы страниц иногда оборачивают HTML так, что script не выполняется — тогда перенесите вставку в footer сайта, а не в блок одной страницы.

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

Как поставить официальный плагин AiMaxChat

Официальный плагин AiMaxChat распространяется zip-файлом с публичного URL сервиса, без выдуманных номеров версий в этой статье. Скачайте архив, в админке WordPress откройте «Плагины» → «Добавить новый» → «Загрузить плагин», установите и активируйте. Затем откройте настройки AiMaxChat и вставьте botId, publicToken, apiUrl и URL скрипта виджета — те же параметры, что в HTML-коде.

Плагин удобнее ручной правки темы: меньше риска затереть код при обновлении. Логика ответов по-прежнему живёт в кабинете AiMaxChat, а не в PHP темы. Не ставьте сторонние «универсальные чат-плагины», подставляя ключи AiMaxChat наугад: совместимость не обещается. Если zip в вашем контуре ещё не задан, используйте HTML-вставку из предыдущего раздела — публичный чат от этого не становится «неофициальным».

После активации откройте сайт как гость. Если кнопки нет, отключите на минуту плагины кеша и минификации JS, проверьте, что параметры не с пробелами и лишними кавычками. Не публикуйте secret-ключи backend в настройках плагина: нужен только публичный токен виджета. Админку WordPress посетитель по-прежнему не видит.

Что не делать при установке на WordPress

Не ставьте виджет в закрытую «зону для подписчиков», если чат нужен гостям прайса. Не вставляйте код одновременно в тему и в плагин — получите двойную инициализацию. Не храните в HTML секретные ключи сервера. Не обещайте, что плагин «подтянет WooCommerce-заказы в базу знаний»: источник ответов — загруженные документы в кабинете, не корзина WordPress.

Не обновляйте тему, затирая footer, если код жил только там: либо дочерняя тема, либо плагин. Не верьте сторонним «универсальным чатам», которые просят те же поля. Официальный путь — zip AiMaxChat или чистый HTML-скрипт сервиса. Номер версии в этой статье не выдумываем: берите актуальный архив с публичного URL плагина сервиса.

После релиза назначьте, кто меняет базу знаний. Смена прайса не требует захода в WordPress. Если редактор сайта и владелец базы — разные люди, так даже лучше: меньше случайных правок PHP. WordPress остаётся витриной, кабинет AiMaxChat — источником ответов и лидов. Плагин или HTML-вставку после этого трогают только при смене бота или домена API. Обычное обновление документов в кабинете на сайт не влияет.

Проверка, лиды и типичные ошибки

Проверьте диалог на мобильной теме и на десктопе. Задайте вопрос из вашей базы и вопрос вне базы. Второй должен дать честный отказ, а не выдуманную цену. Отправьте тестовый контакт и найдите его в журнале лидов кабинета. Если лида нет, виджет, возможно, в demo-режиме без API или страница режет исходящие запросы.

Типичные ошибки: код только на главной, а прайс на другой странице без виджета; плагин оптимизации вырезает script с CDN; конфликт нескольких чатов на странице; старый кеш CDN. Ещё ошибка — ставить виджет до загрузки прайса. Сначала тест-чат в кабинете, потом WordPress. Обновление документов в кабинете не требует переустановки плагина.

Когда WordPress-вставка стабильна, можно масштабировать: те же параметры на поддомене, отдельные боты на разные языковые версии, если у вас несколько ботов по тарифу. Чтобы получить код и ключи своего бота, пройдите регистрацию, создайте бота, загрузите базу и откройте раздел установки в кабинете.

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