Решение проблем

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

Процессор показывает статус “Ошибка”

Красный цвет узла означает, что процессор завершился с критической ошибкой.

Диагностика

1. Кликните на узел процессора с ошибкой.
2. Перейдите на вкладку “Логи”.
3. Найдите последнее сообщение с уровнем ERROR - оно содержит описание ошибки.

Распространённые причины

Ошибка подключения к внешнему сервису

• Проверьте доступность сервиса (реестр, CRM, API).
• Убедитесь, что учётные данные актуальны.
• Проверьте, не истёк ли срок действия токена или вебхука.

Ошибка в конфигурации

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

Ошибка при обработке данных

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

Решение

Исправьте конфигурацию или входные данные и перезапустите воронка. Процессор продолжит обработку с того места, где остановился (необработанные пакеты будут обработаны).

Нет данных на выходе процессора

Процессор завершился успешно (зелёный статус), но таблица данных пуста.

Диагностика

1. Проверьте, есть ли данные на выходе предыдущего процессора.
2. Убедитесь, что между процессорами есть связь (соединение на холсте).
3. Проверьте фильтры на текущем процессоре - возможно, они отсеивают все записи.
4. Посмотрите в логах, сколько пакетов было получено и сколько обработано.

Распространённые причины

Нет связи между процессорами

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

Слишком строгие фильтры

• Временно удалите или ослабьте фильтры и перезапустите воронку.
• Проверьте имена полей в условиях фильтра.

Предыдущий процессор не создал пакеты

• Перейдите к предыдущему процессору и проверьте его данные.
• Возможно, проблема началась ещё раньше в цепочке.

Переменные не подставляются

В результатах видны строки вида {{processor-name.field}} вместо реальных значений.

Диагностика

1. Проверьте точное имя процессора-источника (видно в заголовке узла на холсте).
2. Проверьте имя поля в схеме данных процессора-источника.
3. Убедитесь, что процессор-источник находится в цепочке перед текущим (связь на холсте).

Распространённые причины

Опечатка в имени процессора

• Имена чувствительны к регистру. Сверьте написание символ за символом.

Опечатка в имени поля

• Откройте схему данных или просмотр данных процессора-источника и скопируйте точное имя поля.

Нет связи в цепочке

• Процессор может находиться на холсте, но не быть связанным в цепочку. Переменные доступны только из связанных предшественников.

Решение

Исправьте имя переменной в конфигурации и сохраните. Перезапустите воронку.

Ошибка при загрузке файла

Файл не загружается или данные отображаются некорректно.

Диагностика

1. Проверьте формат файла (CSV, XLSX, JSON).
2. Проверьте размер файла.
3. Посмотрите превью данных после загрузки.

Распространённые причины и решения

Неверная кодировка (кракозябры)

• Вручную выберите кодировку Windows-1251 или CP866 в настройках процессора.
• Пересохраните файл в UTF-8.

ИНН потерял ведущие нули

• Отформатируйте колонку ИНН в Excel как “Текст” и пересохраните.
• Используйте CSV вместо Excel.

Файл слишком большой

• Разделите файл на части.
• Удалите ненужные колонки.

Подробнее смотрите в руководстве Импорт данных из файла.

Ошибки подключения к CRM

Процессоры CRM Search или CRM Update выдают ошибки.

Диагностика

1. Перейдите в Настройки -> CRM-подключения.
2. Нажмите “Проверить подключение”.
3. Посмотрите текст ошибки.

Распространённые причины и решения

Вебхук недействителен

• Войдите в Bitrix24 и проверьте, что вебхук не удалён и не деактивирован.
• При необходимости создайте новый вебхук и обновите настройки подключения.

Недостаточно прав доступа

• Проверьте права вебхука в Bitrix24 (crm, crm.contact, crm.company и т.д.).
• Добавьте необходимые разрешения.

Портал временно недоступен

• Подождите несколько минут и повторите попытку.
• Проверьте статус портала Bitrix24.

Подробнее смотрите в руководстве Подключение CRM.

Заканчиваются токены

Баланс токенов быстро расходуется при выполнении воронок.

Причины

• Обработка большого объёма данных без фильтрации.
• Использование процессоров с высоким расходом (GPT-фильтр, расширенный поиск).
• Повторные запуски воронки на одних и тех же данных.

Решения

1. Добавьте фильтры: отсеивайте ненужные записи до дорогих процессоров.
2. Уменьшите maxPackets: обрабатывайте данные порциями.
3. Оптимизируйте промпты: для GPT-процессоров используйте лаконичные промпты.
4. Проверьте дублирование: убедитесь, что воронка не обрабатывает уже обработанные записи (система по умолчанию пропускает обработанные пакеты).

Воронка “завис” (долго выполняется)

Воронка запущен, но прогресс не движется.

Диагностика

1. Проверьте статус узлов на холсте.
2. Откройте логи выполняющегося процессора.
3. Проверьте, есть ли записи с ошибками.

Распространённые причины и решения

Внешний сервис отвечает медленно

• Это нормально для некоторых API. Дождитесь завершения.
• Проверьте логи на предмет таймаутов.

Обработка большого объёма данных

• Проверьте прогресс в логах. Если процент увеличивается - процессор работает, просто медленно.

Процессор действительно завис

• Нажмите кнопку “Отменить” для остановки выполнения.
• Проверьте логи на предмет ошибок.
• Перезапустите воронку.

Фильтры пропускают не те записи

Процессор обрабатывает записи, которые должны были быть отфильтрованы, или наоборот.

Диагностика

1. Откройте настройки фильтра и перечитайте условие.
2. Проверьте данные источника: соответствуют ли значения полей ожиданиям.
3. Проверьте типы данных: числа и строки обрабатываются по-разному.

Распространённые причины

Неверный тип сравнения

• Числа указывайте без кавычек: revenue > 1000000
• Строки указывайте в одинарных кавычках: status = 'active'

Опечатка в имени поля

• Имена полей чувствительны к регистру. Сверьте с схемой данных.

Логическая ошибка в условии

• Проверьте приоритет операторов AND и OR. Используйте скобки для явной группировки.

Подробнее смотрите в руководстве Настройка фильтров.

Общие рекомендации по отладке

1. Начинайте с малого: при отладке установите maxPackets: 3-5, чтобы быстро увидеть результат.
2. Проверяйте пошагово: запускайте процессоры по одному, проверяя данные на каждом шаге.
3. Читайте логи: в логах содержится подробная информация о ходе выполнения.
4. Упрощайте: если воронка сложная, временно отключите часть процессоров и проверяйте по частям.
5. Сверяйте имена: большинство проблем связаны с опечатками в именах процессоров, полей или переменных.

Если проблема не решена

Если вы не нашли решение в этом руководстве:

1. Соберите информацию: скриншот ошибки, текст из логов, конфигурацию процессора.
2. Проверьте другие руководства по конкретным темам.
3. Обратитесь в поддержку, предоставив собранную информацию.