Для установки чата APX создайте канал «Веб-сайт», скопируйте его код из раздела «Установка» и разместите на страницах сайта. Затем проведите разговор с тестового браузера: сообщение должно появиться у оператора, а ответ — вернуться посетителю. Наличие кнопки чата проверяет лишь часть этой цепочки.
Код нужно брать у того канала, куда должны приходить обращения
В APX откройте «Управление → Каналы связи», добавьте канал типа «Веб-сайт». Укажите понятное название: например, «Основной сайт — заявки». Оно поможет отличить рабочий канал от тестового. Настройте внешний вид и доступ сотрудников, которые будут принимать обращения. Базовый путь описан в справке по виджету.
В настройках созданного канала откройте «Установка». На экране «Вставьте код на сайт» скопируйте весь предложенный фрагмент. В проверенной версии интерфейс формирует его с токеном конкретного канала. Не заменяйте этот фрагмент примером из чужого проекта и не переносите код тестового канала на рабочий сайт по памяти: внешне окна могут оказаться одинаковыми, но обращаться будут к разным настройкам.
Сохраните адрес страницы, название канала и место размещения кода в короткой технической заметке. Для сайта, который поддерживает подрядчик, это полезнее сообщения «чат установлен»: новый специалист сможет найти единственную точку подключения и проверить её после обновления шаблона.
Один фрагмент на страницу, один способ подключения
При прямом размещении вставьте фрагмент перед закрывающим тегом </body> в общий шаблон страниц. В конструкторе используйте предусмотренную им область для пользовательского HTML. Если код добавляет менеджер тегов, настройте публикацию там. Выберите один способ: одновременная вставка в шаблон и менеджер тегов создаёт риск повторного запуска.
В коде APX уже есть загрузчик: он добавляет внешний скрипт /static/widget.js и после его загрузки вызывает инициализацию виджета. Поэтому не нужно рядом вручную подключать тот же файл ещё одним тегом script. Адрес берётся из выданного фрагмента; заменять домен или угадывать путь самостоятельно не требуется.
Учебный пример двойной установки: разработчик разместил код в подвале сайта, а маркетолог позднее добавил его через менеджер тегов. При диагностике проверьте оба места и оставьте одно. Число видимых кнопок не является надёжным способом найти дубли: смотрите опубликованный шаблон, настройки тегов и источники запуска. После исправления снова опубликуйте изменения и обновите тестовую страницу.
Приёмка: посетитель и оператор должны увидеть один разговор
- Откройте опубликованную страницу в отдельном тестовом профиле браузера. Проверьте главную и страницу, с которой обычно приходят заявки.
- Отправьте отличимую фразу, например «Проверка установки, каталог, 14:20». Не используйте реальную заявку клиента.
- Под учётной записью назначенного сотрудника откройте «Диалоги». Найдите именно эту фразу и нужный канал.
- Ответьте «Тест получен» и убедитесь, что ответ появился в окне посетителя. Затем отправьте второе сообщение с сайта.
- Повторите короткий обмен на телефоне. Проверьте, можно ли закрыть окно, прокрутить переписку и продолжить действие на странице.
Успешный результат — совпадение текста и последовательности сообщений с обеих сторон. Скриншот раскрытого виджета этого не доказывает. Если после перехода между страницами поведение меняется, запишите точные адреса: общий шаблон мог подключаться не во всех разделах сайта. Для операторской части пригодится обзор каналов связи.
Три разных сбоя требуют трёх разных проверок
| Наблюдение | Ближайшая проверка |
|---|---|
| Окно вообще не появилось | Опубликован ли фрагмент; загрузился ли widget.js; что сообщает консоль браузера |
| Окно есть, сообщения у сотрудника нет | Тот ли канал в коде; доступен ли он этому сотруднику; нет ли ошибки отправки |
| Сообщение у сотрудника есть, ответ не виден на сайте | Тот ли тестовый разговор открыт; что происходит с соединением и повторной отправкой |
В инструментах разработчика браузера вкладка Network показывает сетевые запросы, Console — сообщения об ошибках. Зафиксируйте время с часовым поясом, адрес страницы, название канала и текст ошибки. Если загрузку ограничивает Content Security Policy, передайте администратору конкретное сообщение: эта политика управляет разрешёнными ресурсами, как объясняет документация MDN. Отключать всю защиту сайта ради проверки не следует.
Проверка в другом браузере помогает отделить особенность локального окружения от ошибки установки, но не заменяет разбор причины. Передайте поддержке воспроизводимые шаги и результат каждого направления обмена. Не прикладывайте пароли и полный журнал посторонних обращений. Установку можно принимать, когда рабочая страница и телефон прошли двусторонний тест, а единственная точка подключения кода известна.
