События ошибок

Выберите нужные события при настройке webhook. Ошибка в событии описывает работу агента или отправку сообщения, а не обязательно сбой доставки самого webhook.

Какие события выбрать

Ошибка выполнения агента и ошибка отправки сообщения — независимые события. Чтобы отслеживать оба этапа, выберите error и message_undelivered. Автоматизация может вызывать агента или отправлять сообщение напрямую: в этих случаях применяются те же события.

Поля события

В data событий error и message_undelivered передаются error_code, error_message и error_message_key, а также доступный контекст: agent_id, sender_type, sender_id, message_event_id, response_id, automation_id, version_id, run_id, task_id и node_id. message_event_id указывает на исходящее сообщение при ошибке отправки. Текст причины может отсутствовать: для программной обработки используйте error_code, а error_message_key обозначает ключ локализации ошибки агента. Внутренние трассировки и полные ответы ИИ-провайдера в событие не входят.

Событие automation_step_failed содержит в data идентификаторы automation_id, version_id, run_id, task_id, node_id, название шага node_name, а также error_code, error_message, occurred_at и retryable: false. Для шага отправки сообщения может присутствовать message_event_id. Общие dialog_id, lead_id и channel_id заполняются, если соответствующий контекст есть; автоматизация без диалога также может прислать это событие.

Промежуточные неудачные попытки, тестовые запуски и предусмотренный переход HTTP-шага по подключённой ветке «Ошибка» не вызывают automation_step_failed. Ошибка шага не означает остановку остальных параллельных веток. Один сбой может дать два разных события: например, message_undelivered и затем automation_step_failed, если из-за неудачной отправки завершился ошибкой шаг автоматизации. При повторной доставке одного события его event_id сохраняется; ручной повтор шага создаёт новую задачу и может привести к новому событию.

Получение этих событий внешним сервером проверяйте в истории доставки.