Отладка и поиск ошибок

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

Проверка результата робота

Таймлайн CRM-карточки

Если у робота включена опция Записать в CRM карточку, результат выполнения отображается в таймлайне сделки или лида.

Журнал бизнес-процесса

Подробный журнал выполнения доступен в бизнес-процессе. Подробнее: Журнал бизнес-процесса.

Возвращаемые значения

Используйте возвращаемые значения для проверки результата:

После робота Олчат добавьте робота Добавить комментарий

В текст комментария вставьте переменные из результата робота:

Результат: {=Результат > is_sent}
Ошибка: {=Результат > error}
Код: {=Результат > error_code}
Chat ID: {=Результат > chat_id}

Комментарий появится в таймлайне CRM-карточки с актуальными значениями.

Типовые проблемы и решения

Робот не выполняется

Симптомы: Робот не запускается при переходе сделки на стадию.

Возможные причины:

Робот добавлен на неправильную стадию
Сделка переведена не тем пользователем (проверьте условие «Кто запускает»)
Робот отключён или удалён

Решение:

Откройте настройку роботов на нужной стадии
Убедитесь, что робот присутствует и активен
Проверьте условия запуска робота (если настроены)

Ошибка «Линия не найдена»

Код ошибки: LINE_NOT_FOUND

Причины:

Аккаунт мессенджера не авторизован
Коннектор отключён
Линия удалена

Решение:

Откройте приложение Олчат
Проверьте статус коннектора — он должен быть подключён
Проверьте авторизацию аккаунта
Если аккаунт отключился, выполните повторную авторизацию

Ошибка «Чат не найден»

Код ошибки: CHAT_NOT_FOUND

Причины:

Номер телефона не зарегистрирован в мессенджере
Номер в неправильном формате
Пользователь скрыл номер в настройках приватности
ID чата указан неверно

Решение:

Проверьте формат номера: Особенности номеров
Используйте робота Проверка телефона для предварительной проверки
Попробуйте другой тип идентификатора (username, ID чата)

Ошибка «Не удалось подключиться к мессенджеру»

Код ошибки: CLIENT_ERROR

Причины:

Сессия мессенджера истекла
Аккаунт заблокирован
Временные проблемы с API мессенджера

Решение:

Проверьте статус подключения в приложении Олчат
Переавторизуйте аккаунт: Переавторизация
Повторите попытку через несколько минут

Ошибка «Сообщение не указано»

Код ошибки: MESSAGE_EMPTY

Причины:

Поле сообщения пустое
Переменная, подставленная в сообщение, пустая

Решение:

Проверьте, что текст сообщения указан в параметрах робота
Если используются переменные, убедитесь, что соответствующие поля CRM заполнены

Робот выполняется, но сообщение не доставлено

Причины:

Получатель заблокировал аккаунт Олчат
Получатель удалил аккаунт мессенджера
Сообщение отфильтровано мессенджером (антиспам)

Решение:

Проверьте значение is_sent — если Y, сообщение было отправлено
Попросите получателя проверить чат в мессенджере
Убедитесь, что аккаунт Олчат не заблокирован получателем

Метод «Комментарий в таймлайн»

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

Шаг 1. Добавьте робота-комментарий

После робота Олчат добавьте стандартного робота Битрикс24 Добавить комментарий к элементу.

Шаг 2. Настройте текст

Вставьте в текст комментария все возвращаемые значения предыдущего робота.

Шаг 3. Проверьте результат

Переведите тестовую сделку на нужную стадию и проверьте комментарий в таймлайне.

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

Тестируйте на тестовых сделках — создайте отдельную сделку для проверки роботов
Проверяйте по одному — при отладке цепочки отключите все роботы, кроме тестируемого
Используйте условия — добавьте условия проверки (is_sent = Y) перед следующими роботами
Логируйте результаты — используйте комментарии для вывода промежуточных значений
Проверяйте журнал — Журнал бизнес-процесса содержит подробную информацию о каждом шаге

Что дальше

Описание ошибок — полный список кодов ошибок и их описание
Журнал бизнес-процесса — как читать журнал выполнения