> ## Documentation Index
> Fetch the complete documentation index at: https://docs.hubtalk.ai/llms.txt
> Use this file to discover all available pages before exploring further.

# Когда что-то пошло не так

> Частые отказы, что они означают и что с ними делать.

# Когда что-то пошло не так

Ошибки приходят машинным кодом и английским пояснением. **Ориентируйтесь на код:** текст пояснения может меняться. Вот те, что встречаются в жизни чаще всего; полный перечень — в [Коды ошибок](/ru/v4/web-api/errors).

| Код                                                                | Что случилось                                                                                                                                  | Что делать                                                                                        |
| ------------------------------------------------------------------ | ---------------------------------------------------------------------------------------------------------------------------------------------- | ------------------------------------------------------------------------------------------------- |
| `idempotency_key_required`                                         | не прислан ключ повтора                                                                                                                        | добавить заголовок, см. [Как проходит обзвон](/ru/v4/web-api/how-it-works)                        |
| `idempotency_key_reuse`                                            | тот же ключ с другим телом                                                                                                                     | взять новый ключ для новой кампании или партии                                                    |
| `idempotency_key_in_flight`                                        | первый запрос с этим ключом ещё выполняется                                                                                                    | дождаться его ответа, не повторять                                                                |
| `campaign_agent_unknown`                                           | агента с таким именем в вашей организации нет                                                                                                  | проверить имя агента; неопубликованный агент — другой случай, он даёт черновик, а не отказ        |
| `dialing_route_unresolved`                                         | агент не привязан ни к одной линии                                                                                                             | привязать в разделе «Телефония»                                                                   |
| `dialing_route_ambiguous`                                          | агент привязан к нескольким                                                                                                                    | назвать линию явно, см. [Привязку набора](/ru/v4/web-api/campaign-fields)                         |
| `dialing_binding_incomplete`                                       | назван номер или группа без линии                                                                                                              | прислать ещё и линию, либо не присылать ничего из трёх                                            |
| `campaign_timezone_unknown`                                        | часовой пояс не распознан                                                                                                                      | название вида `Asia/Almaty`; смещения вида `+05:00` не принимаются                                |
| `campaign_classification_invalid`                                  | цель обзвона не из списка                                                                                                                      | одно из трёх значений [Согласие и цель обзвона](/ru/v4/web-api/rules)                             |
| `campaign_window_invalid`                                          | окончание раньше начала                                                                                                                        | проверить окно                                                                                    |
| `campaign_spec_invalid`                                            | отклонены настройки: скорость не из ряда `1, 2, 5, 10, 20, 30, 60, 100`, неверные повторы, рабочие часы, действие по дублям или длина названия | сверить настройки со справочником                                                                 |
| `working_hours_wider_than_law`                                     | рабочие часы шире окна обзвона организации или законного окна                                                                                  | сузить часы или не задавать их вовсе                                                              |
| `launch_blocked`                                                   | запуск не прошёл проверки                                                                                                                      | причины перечислены в самой ошибке; блокер по реестру несёт обновлённый список совпадений         |
| `campaign_transition_invalid`                                      | переход невозможен из текущего состояния (например, возобновить отменённую)                                                                    | проверить состояние кампании                                                                      |
| `market_package_not_installed`                                     | для вашей организации не установлен пакет рынка, номера нельзя проверить                                                                       | обратиться в поддержку                                                                            |
| `dnc_screen_required`                                              | загрузка старого формата, без построчной сверки с реестром                                                                                     | загрузить номера заново                                                                           |
| `report_filter_invalid`                                            | неверное значение `only` у отчёта по загрузке                                                                                                  | убрать фильтр или передать `only=dnc_match`                                                       |
| `calls_rejected`                                                   | в партии добавляемых номеров есть строка с ошибкой данных — партия не принята целиком                                                          | исправить строки из разбора в ошибке и прислать партию заново с тем же ключом повтора             |
| `calls_dnc_matched`                                                | в партии есть номер из реестра «не звонить» — партия не принята целиком                                                                        | убрать такие номера из своей базы (список — в отчёте загрузки `only=dnc_match`) и прислать заново |
| `campaign_closed`                                                  | кампания завершена или отменена и номера больше не принимает                                                                                   | создать новую кампанию                                                                            |
| `calls_required` / `calls_batch_too_large`                         | партия пуста или больше 1000 строк                                                                                                             | присылать от 1 до 1000 номеров за запрос                                                          |
| `attestation_invalid`                                              | подпись партии не в форме `{"confirmed": true}`                                                                                                | прислать ровно это поле, без `import_id`                                                          |
| `attestation_import_id_required`                                   | при отдельном запуске не назван номер загрузки, под которой ставится подпись                                                                   | передать `import_id` из ответа на создание                                                        |
| `campaign_open_ends_at_required` / `campaign_open_ends_at_too_far` | у кампании, открытой к добавлению звонков, нет даты окончания или она дальше 30 суток                                                          | назвать дату окончания в пределах горизонта                                                       |
| `campaign_not_found` / `import_not_found`                          | такой кампании или загрузки в вашей организации нет                                                                                            | проверить идентификатор                                                                           |