> ## 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.

# Правила повторов, сохранение и правка

> Правила повторов скрипта, маршрутизация, сохранение и отказы, правка и удаление скрипта, чек-лист перед передачей клиенту.

# Правила повторов, сохранение и правка

## Вкладка «Правила повторов»

![Вкладка «Правила повторов»](https://mintcdn.com/hubtalk/imXtUGq2OJsLMMCI/images/v4_adapter_registry_retry_rules.png?fit=max\&auto=format\&n=imXtUGq2OJsLMMCI\&q=85\&s=06c1bd0720ff64dbda3ae42a79c21d40)

1. **«Взять из пресета»**: «Стандартный», «Агрессивный», «Осторожный» или пресеты организации.
2. **«Скопировать правила в скрипт»** — это копия: дальнейшая правка пресета скрипт не меняет.
3. Редактор правил — тот же, что у кампаний: условие → действие, порядок сверху вниз.

* Правила — **один набор на все кампании этого скрипта**. Число попыток и интервал приходят в запросе (`try`, часы и минуты) или берутся из дефолтов учётной записи, а правила решают, какие исходы перезванивать.
* Кроме обычных условий по статусу есть четыре условия разговора, нужные для похожести на V2: **«Абонент положил трубку»**, **«Клиент молчал»**, **«Слишком короткий»**, **«Тишина (авто-завершение)»**. Подсказки под ними объясняют, как такой звонок вёл себя в V2.
* **«Недозвон»** — перезвон V2 по статусу `failed`: набор не дал соединения, точной причины телефония не сообщила. V2 такой номер перезванивал; чтобы скрипт делал так же, добавьте правило **«Недозвон» → «Перезвонить через время»** или **«Перезвонить на следующем проходе»**. Попытка набора тратится.
* Правило без «Попыток, раз» срабатывает один раз; больше 30 не бывает. Если у агента нет критерия успеха, правило «Цель не достигнута» никогда не сработает — кабинет это подписывает. Про критерии успеха — [Цели](https://docs.hubtalk.ai/ru/v4/platform/agent-settings/goals.md).

## Вкладка «Маршрутизация»

![Вкладка «Маршрутизация»](https://mintcdn.com/hubtalk/imXtUGq2OJsLMMCI/images/v4_adapter_registry_routing.png?fit=max\&auto=format\&n=imXtUGq2OJsLMMCI\&q=85\&s=ce3f9b06065e79f33e2b34ff440fbc33)

1. Заглушка: правила маршрутизации появятся вместе с конструктором правил; скрипт реестра всегда направлен на своего агента.

Маршрутизация пока не редактируется из кабинета. Маршрутизирующие скрипты (без агента, с правилами «по истории номера») — отдельная будущая доработка.

## Сохранение и отказы

Кнопка **«Добавить скрипт»** / **«Сохранить»** выключена, пока что-то не заполнено. Её подсказка называет первое препятствие в таком порядке:

1. имя скрипта;
2. агент;
3. классификация;
4. явная привязка не завершена;
5. ошибка поля;
6. не выбрана переменная агента;
7. сигнатурная переменная без значения;
8. ошибка правила.

Сводка внизу показывает покрытие: «Агент получит X переменных из Y: A из полей и B от ядра адаптера» и список непередаваемых полей.

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

| Отказ | Куда переводит | Что сделать |
| - | - | - |
| Имя скрипта не должно быть пустым… | Скрипт и агент → имя | Исправить имя. |
| У учётной записи уже есть скрипт с таким именем | Скрипт и агент → имя | Открыть существующий скрипт вместо нового. |
| Агент не найден в организации учётной записи или находится в архиве / Агент ни разу не публиковался | Скрипт и агент → агент | Опубликовать агента или выбрать другого. |
| Выберите классификацию для скрипта с агентом | Скрипт и агент → классификация | Задать цель обзвона. |
| Привязка набора не входит в сабгруппы транков, доступные организации… | Скрипт и агент → привязка | Выбрать транк и сабгруппу, к которой привязан агент. |
| Поле схемы № N задано неверно: … | Поля → строка N | Исправить форму, пределы или значения. |
| Поле … зарезервировано платформой | Поля → строка | Переименовать поле или цель записи. |
| Поле … направлено в переменную …, которую опубликованный агент не использует | Поля → строка | Выбрать существующую переменную или опубликовать агента с этой переменной. |
| Переменную … задаёт платформа во время звонка | Поля → все записи с этой целью | Выбрать другую переменную. |
| Сигнатурная переменная агента … не получает значения от скрипта | Поля → левая панель | Направить на неё поле или добавить поле с этим именем кнопкой «＋ поле». |
| Резервное значение поля … задано неверно | Поля → строка | Резерв должен укладываться в форму поля: длина, набор символов, до 1000 символов. |
| Правило повтора № N задано неверно | Правила → правило N | Исправить условие или действие. |

> [!WARNING]
>
> **Новая публикация агента скрипт не перепроверяет.** Карта переменных сверяется с опубликованной версией агента в момент сохранения скрипта. Если потом агента опубликовали заново с новой сигнатурной переменной, скрипт останется сохранённым, но кампании по нему перестанут запускаться, а клиент получит «Internal error, try again later».
>
> После каждой публикации агента, который используется в реестре, откройте скрипт и сохраните его заново: сводка покажет, что изменилось.

## Правка и удаление скрипта

* Карандаш в строке открывает то же окно с заголовком «Скрипт \<имя>». Все вкладки редактируются; смена агента заново сверяет карту переменных.
* Если агент удалён, в архиве или не опубликован, кабинет показывает пометку и предупреждение «Скрипт не сохранится, пока его не направят на живого опубликованного агента».
* Удаление — корзина в строке или кнопка **«Удалить скрипт»** внизу окна, с подтверждением. После удаления запросы клиента с этим именем скрипта перестают приниматься. Уже созданные кампании не трогаются.

![Подтверждение удаления скрипта](https://mintcdn.com/hubtalk/imXtUGq2OJsLMMCI/images/v4_adapter_registry_script_delete.png?fit=max\&auto=format\&n=imXtUGq2OJsLMMCI\&q=85\&s=eb74c88e0c635ea7e5f569352d09c9ce)

## Чек-лист перед передачей клиенту

> [!TIP]
>
> 1. Учётная запись активна, пароль передан клиенту.
> 2. Для каждого имени скрипта из запросов клиента есть строка реестра с опубликованным агентом и классификацией.
> 3. Схема полей совпадает с реальной строкой запроса: ни лишних, ни пропущенных ключей.
> 4. Сводка показывает «привязка: авто, однозначна» или явную привязку.
> 5. Ни одна сигнатурная переменная агента не «без значения».
> 6. Тестовый `create` с одной строкой на свой номер проходит, кампания видна в кабинете организации, звонок состоялся, агент произнёс переменные.


This documentation is built and hosted on [Mintlify](https://mintlify.com), a developer documentation platform.