Документация
/ Документация
Руководство по интеграции

Диагностика по этапам

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

На этой странице

Зафиксируйте Симптом

Выберите нужный сайт в кабинете и повторите проблему на странице магазина. Запишите адрес страницы без секретных параметров, дату и время, язык, точный запрос и ожидаемый результат. Для товара укажите артикул и выбранный вариант; для базы знаний название материала; для доставки тип события и получателя без токена.

Проверьте, возникает ли проблема у другого товара, в новом разговоре и на мобильном устройстве. Сбой одного предложения не означает отказ всего поиска. Старое сообщение в истории не должно меняться после правки материала; актуальность проверяют новым вопросом. Если есть текст ошибки, сохраните его дословно, не пересказывая «не работает».

Отделите Импорт От Поиска

Симптом Вероятная причина Проверка и действие
Товара нет в кабинете Не выбран источник, ошибка фида или ограничения доступа Проверить источник, результат загрузки и права на публичную выгрузку
Товар есть, точный артикул не находится Не завершена обработка для поиска либо неверно передано поле Сверить артикул и состояние обработки, повторить после обновления
Находится старое описание Старый источник или ручная правка поля Сверить источник и переопределение товара
Неправильная цена у варианта Цена родителя подставлена вместо предложения Проверить поля цены и выбранный offer_id
Удалённый товар остаётся Обновление не удалило старую запись Проверить выбранный режим обновления каталога

Начните с каталога и полей. В Битриксе проверьте источники и экспорт, а не только соединение по ключу. Успешное соединение подтверждает доступ, но не корректность цен, остатков и состава выгрузки. Повторная загрузка без исправления исходного поля повторит ту же ошибку.

Проверьте Показ Виджета

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

Симптом Причина Действие
На одной странице нет строки поиска Не подключён шаблон или контейнер Сверить страницу с встраиванием
Два окна или двойное добавление Повторный скрипт или обработчик Оставить одно согласованное подключение
Цвет или приветствие старые Черновик не сохранён либо другое подключение Сохранить настройки и сверить сайт
На телефоне кнопка перекрыта Верстка или внешний слой магазина Проверить расположение и внешний вид

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

Разберите Ответ Консультанта

Откройте Диалоги (/lk/dialogs) и прочитайте контекст до проблемного ответа. Уточните, что именно неверно: товар, характеристика, условие доставки или действие. Поиск каталога и извлечение знаний для генерации, иногда называемое RAG, требуют разных исправлений.

Симптом Причина Действие
Не отвечает об условиях Нет активного содержательного материала Проверить текст и состояние в базе знаний
Файл прикреплён, ответ пуст Нет извлечённого текста Добавить понятный ручной текст, проверить документ
Отвечает старым правилом Дубли или старая активная редакция Отключить устаревшее, начать новый разговор
Обещает неизвестное свойство Недостаточные или противоречивые факты Исправить данные, проверить вопрос с неизвестным фактом
Не выполняет действие Инструмент не объявлен интеграцией Проверить возможности клиента, не усиливать инструкцию

Смена модели не заменяет источники. Правило «всегда говорить, что есть в наличии» не исправляет отсутствующий остаток и не должно использоваться. Условия подбора проверяются у одного предложения; неизвестное значение нельзя считать выполненным условием.

Отделите Заявку От Доставки

Если контакт отсутствует в Заявках (/lk/leads), сначала проверьте сам сбор контакта и правильный сайт. Если заявка есть, но письмо или CRM-запись отсутствуют, переходите к уведомлениям: события, включённый канал, получатель, активное назначение и права внешнего сервиса. Ошибка мессенджера отображается в его карточке; сохранённый выключенный канал не является работающим.

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

Передайте Воспроизводимый Случай

Перед обращением соберите краткую последовательность: «страница → запрос → вариант → действие → фактический результат → ожидаемый результат». Приложите снимок только нужного участка с скрытыми ключами и контактами. Для демонстрационного содержимого подпишите «Демо», не выдавая его за ваш производственный каталог.

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