Описание ошибок

При выполнении роботов Олчат могут возникать ошибки. Каждая ошибка сопровождается кодом (error_code) и текстовым описанием (error). Код ошибки полезен для программной обработки в бизнес-процессах, а текст — для быстрой диагностики.

Ошибки идентификации получателя

Код	Описание	Причина	Решение
CHAT_ID_EMPTY	Идентификатор чата не указан	Поле с номером телефона, ID чата или username пустое	Проверьте заполненность поля CRM; добавьте условие на непустоту
PHONE_EMPTY	Номер телефона не указан	Поле телефона пустое	Заполните номер телефона в CRM-карточке
USERNAME_EMPTY	Username не указан	Поле username пустое	Укажите username в параметрах робота
CHAT_NOT_FOUND	Чат не найден	Номер не зарегистрирован в мессенджере, неверный формат или приватность	Проверьте формат номера; используйте Проверку телефона

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

Код	Описание	Причина	Решение
LINE_NOT_FOUND	Линия не найдена или не активна	Аккаунт не авторизован, коннектор отключён или линия удалена	Проверьте статус коннектора в Олчат; переавторизуйте аккаунт
CLIENT_ERROR	Не удалось подключиться к мессенджеру	Сессия истекла, аккаунт заблокирован, API мессенджера недоступен	Переавторизуйте аккаунт; повторите через несколько минут

Ошибки параметров

Код	Описание	Причина	Решение
MESSAGE_EMPTY	Сообщение не указано	Текст сообщения пустой	Заполните поле сообщения; проверьте переменные
NAME_EMPTY	Имя контакта не указано	Поле имени пустое (робот отправки контакта)	Укажите имя контакта
TITLE_EMPTY	Название не указано	Новое название чата не задано	Заполните поле названия
COORDS_EMPTY	Координаты не указаны	Широта или долгота не заданы	Укажите оба значения координат
COORDS_INVALID	Некорректные координаты	Значения координат не являются числами	Проверьте формат: числа с точкой, без букв
DIALOG_ID_EMPTY	ID диалога не указан	Не задан идентификатор диалога	Укажите ID диалога; получите из предыдущего робота
TRANSFER_ID_EMPTY	Не указан получатель	Не указан ни ID оператора, ни ID очереди	Заполните TRANSFER_ID или выберите оператора
CHAT_ID_EMPTY	ID чата не указан	Поле ID чата пустое	Укажите числовой ID чата
ID_EMPTY	ID чата или сообщения не указан	Не указан один из обязательных ID	Заполните оба поля
TEXT_EMPTY	Текст сообщения не указан	Поле текста пустое (робот планирования)	Заполните текст сообщения

Ошибки файлов

Код	Описание	Причина	Решение
FILE_ERROR	Ошибка при подготовке файла	Не удалось скачать или обработать файл	Проверьте ссылку на файл; убедитесь в доступности
FILE_NOT_FOUND	Файл не найден	Файл не существует по указанному пути или ID	Проверьте URL, ID файла на диске или значение поля CRM

Ошибки отправки

Код	Описание	Причина	Решение
SEND_ERROR	Ошибка при отправке	Общая ошибка отправки через API мессенджера	Проверьте подключение; повторите отправку
DELETE_ERROR	Ошибка удаления сообщения	Не удалось удалить сообщение (MAX)	Проверьте ID сообщения; убедитесь, что сообщение существует
EDIT_ERROR	Ошибка редактирования	Не удалось отредактировать сообщение (MAX)	Проверьте ID сообщения; убедитесь, что оно доступно для редактирования

Ошибки ожидания ответа

Код	Описание	Причина	Решение
SUBSCRIPTION_ERROR	Не удалось создать подписку	Внутренняя ошибка при регистрации ожидания	Повторите попытку; обратитесь в поддержку

Ошибки управления ОЛ

Код	Описание	Причина	Решение
OPERATOR_ERROR	Ошибка операторского действия	Не удалось выполнить действие (принять, завершить и т.д.)	Проверьте, что диалог существует и активен; проверьте права
TRANSFER_ERROR	Ошибка перевода диалога	Не удалось перевести диалог	Проверьте, что диалог активен; убедитесь, что оператор существует
UPDATE_ERROR	Ошибка обновления	Не удалось обновить данные (заголовок чата)	Проверьте ID чата; убедитесь, что чат существует
INFO_ERROR	Ошибка получения информации	Не удалось получить данные диалога или аккаунта	Проверьте идентификатор; убедитесь, что объект существует

Ошибки планирования

Код	Описание	Причина	Решение
INVALID_DELAY	Некорректная задержка	Значение задержки не является числом	Укажите числовое значение в минутах
DELAY_OUT_OF_RANGE	Задержка вне допустимого диапазона	Значение менее 1 или более 43200 минут	Укажите значение от 1 до 43200 (30 дней)
PORTAL_NOT_FOUND	Портал не найден	Внутренняя ошибка идентификации портала	Обратитесь в поддержку
SCHEDULE_FAILED	Не удалось запланировать	Внутренняя ошибка при создании запланированного сообщения	Повторите попытку; обратитесь в поддержку

Ошибки поиска

Код	Описание	Причина	Решение
SEARCH_ERROR	Ошибка при поиске	Не удалось выполнить поиск аккаунта	Проверьте подключение; повторите попытку

Общая ошибка

Код	Описание	Причина	Решение
ERROR	Общая ошибка	Непредвиденная ошибка выполнения	Проверьте текст ошибки; обратитесь в поддержку

Обработка ошибок в бизнес-процессе

Для обработки ошибок в бизнес-процессе используйте условное ветвление:

1. После робота Олчат добавьте Условие
2. Проверьте значение is_sent или success:
   • Если Y — продолжить основной сценарий
   • Если N — выполнить альтернативный сценарий (повторная попытка, уведомление, запись в лог)
3. Для точной обработки используйте error_code:
   • CHAT_NOT_FOUND — отправить через другой канал
   • LINE_NOT_FOUND — уведомить администратора
   • SEND_ERROR — повторить попытку

Совет

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