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

# Пример: перезвоны по исходам

> Готовый запрос `POST /v1/campaigns` с экспертной логикой: свой интервал перезвона на «занято», «нет ответа», автоответчик и короткий разговор.

# Пример: перезвоны по исходам

У каждого исхода звонка может быть своя пауза до следующего набора: правило [экспертной логики](https://docs.hubtalk.ai/ru/v4/web-api/campaign-fields.md#настройка-повторов) с действием `retry_in` и параметром `params.interval_s`. Ниже — готовый запрос и что делает каждая его часть.

## Запрос целиком

Кампания создаётся и запускается одним запросом `POST /v1/campaigns`.

```bash theme={null}
BASE_URL="https://app.hubtalk.ai"   # хост, на котором работает ваш кабинет

curl -X POST "$BASE_URL/v1/campaigns" \
  -H "Authorization: Bearer YOUR_API_KEY" \
  -H "Content-Type: application/json" \
  -H "Idempotency-Key: campaign-2026-10-22-01" \
  -d '{
    "name": "Напоминание о платеже — октябрь",
    "agent_id": "payment_reminder",
    "calls_per_minute": 10,
    "timezone": "Asia/Almaty",
    "working_hours": [
      { "days": [0, 1, 2, 3, 4], "start": "09:00", "end": "19:00" }
    ],
    "classification": "debt_collection",
    "call_strategy": "expert",
    "retry_config": {
      "attempts": 6,
      "interval_s": 3600,
      "rules": [
        { "if": "busy",              "then": "retry_in",          "params": { "interval_s": 600,  "max_matches": 3 } },
        { "if": "no_answer",         "then": "retry_in",          "params": { "interval_s": 5400, "max_matches": 2 } },
        { "if": "voicemail_reached", "then": "retry_in",          "params": { "interval_s": 7200, "max_matches": 2 } },
        { "if": "short_call",        "then": "retry_in",          "params": { "max_duration_s": 15, "interval_s": 3600 } },
        { "if": "no_speech",         "then": "wait_for_pass_end", "params": { "max_matches": 1 } },
        { "if": "user_declined",     "then": "stop_calling" }
      ]
    },
    "attestation": { "confirmed": true },
    "planned_calls": [
      { "phone": "+77001234567", "name": "Айгерим", "variables": { "debt": "15000" } },
      { "phone": "+77007654321", "name": "Данияр",  "variables": { "debt": "8200" } }
    ]
  }'
```

В ответ приходит `201` с `campaign_id`, `status`, `blockers` и `warnings`. `status: "running"` — обзвон пошёл; `draft` — что-то мешает запуску, причина в `blockers`. Полный ответ — в [Создании кампании](https://docs.hubtalk.ai/ru/v4/web-api/campaign-create.md).

## Что делает каждое правило

Каждое правило — пара «если исход → то действие». Интервал считается от конца звонка и для этого контакта заменяет интервал кампании.

| Исход (`if`) | Действие (`then`) | Через сколько | Сколько раз за контакт |
| - | - | - | - |
| `busy` — занято | `retry_in` — перезвонить через время | 10 мин (`600`) | 3 |
| `no_answer` — не взяли трубку | `retry_in` | 1 ч 30 мин (`5400`) | 2 |
| `voicemail_reached` — автоответчик | `retry_in` | 2 ч (`7200`) | 2 |
| `short_call` — разговор короче 15 с (`max_duration_s`) | `retry_in` | 1 ч (`3600`) | без предела правила, только `attempts` кампании |
| `no_speech` — соединилось, но абонент молчал | `wait_for_pass_end` — перезвонить на следующем проходе | — | 1 |
| `user_declined` — абонент отклонил звонок | `stop_calling` — больше не звонить | — | — |

Правило на `voicemail_reached` срабатывает и на `voicemail_suppressed` — когда автоответчик определён, но сообщение оставлять было нельзя. Все значения `if` — это коды `status_reason` из [Исходов звонка](https://docs.hubtalk.ai/ru/v4/web-api/call-status.md) плюс `short_call` и `goal_not_achieved`. Исход, под который не подошло ни одно правило, решает общая таблица исходов, как в `standard`: автоответчик без своего правила перезванивается через `interval_s` кампании ([Исходы звонка](https://docs.hubtalk.ai/ru/v4/web-api/call-status.md#что-кампания-делает-с-номером-после-звонка)). Поэтому в примере на `voicemail_reached` стоит своё правило; когда его `max_matches` исчерпан, автоответчик дальше перезванивается по общей таблице, пока есть наборы. Чтобы на автоответчик больше не звонить, нужно `stop_calling`.

## Правила и ограничения

* **`attempts` — общий потолок наборов на контакт, считая первый**, от 1 до 30. Правила его не расширяют: если наборы кончились, контакт закрывается, даже если у правила остались срабатывания.
* **`interval_s` у `retry_in`** — целые секунды от `60` до `86400` (от 1 минуты до 24 часов). У `retry_in` он обязателен, у других действий — запрещён, иначе `422 campaign_spec_invalid`.
* **`max_matches`** — сколько раз правило может сработать для одного контакта, от 1 до 30, по умолчанию 1. **У `short_call` его нет** — сервер откажет с `422 campaign_spec_invalid`.
* **`max_duration_s` у `short_call`** обязателен, не меньше `10` секунд.
* **Перезвон по постоянной причине запрещён.** Для `invalid_destination` и `spam_blocked` на всех рынках и для `user_declined` и `screener_declined` в пакете рынка США можно только `stop_calling`. На остальных рынках `user_declined` считается временным и перезвон на него разрешён — в примере мы сознательно ставим `stop_calling`.
* **Одна пара «условие + действие» — один раз.** Дубль отклоняется.
* **Экспертный режим без единого правила** не запустится: блокер `rules_empty`.
* **Окно обзвона, реестр «не звонить» и частотные лимиты** действуют на каждый перезвон. Перезвон, который не успевает до конца кампании (`ends_at`), не назначается.
* **Предупреждение `rule_interval_exceeds_end`** — интервал правила не меньше остатка окна кампании: такой перезвон не состоится. Запуск оно не блокирует.
* **`id` правила не передаём** — его назначает сервер (`r-xxxxxxxx`) и возвращает в ответе.

## Чтобы обзвон начался сразу

* **`Idempotency-Key`** обязателен, для каждой новой кампании — свой. Повтор запроса с тем же ключом после таймаута не создаст вторую кампанию.
* **`attestation: {"confirmed": true}`** — подпись согласия абонентов. Без неё кампания создаётся черновиком с блокером `attestation_required`. Подробнее — в [Согласии, реестре и ответственности](https://docs.hubtalk.ai/ru/v4/web-api/rules.md).
* **Агент опубликован.** Иначе — черновик с блокером `agent_not_published`. `agent_id` — это **имя** агента.
* **У агента включено [«Определять автоответчик»](https://docs.hubtalk.ai/ru/v4/platform/agent-settings/voicemail-detection.md).** Без него исхода `voicemail_reached` не будет, и правило на автоответчик не сработает ни разу.
* **`trunk_id`, `route_id` и `from_number` не передаём** — платформа сама найдёт линию по агенту ([Привязка набора](https://docs.hubtalk.ai/ru/v4/web-api/campaign-fields.md#привязка-набора)).
* **`working_hours` только сужает** окно обзвона организации; шире — `422 working_hours_wider_than_law`.

## Где ещё посмотреть

| Что | Страница |
| - | - |
| Заголовки, поля запроса, `call_strategy`, порядок отказов, пример ответа | [Создание кампании](https://docs.hubtalk.ai/ru/v4/web-api/campaign-create.md) |
| `retry_config` и правила: `if`, `then`, `params` | [Поля кампании → Настройка повторов](https://docs.hubtalk.ai/ru/v4/web-api/campaign-fields.md#настройка-повторов) |
| Коды исходов для `if` | [Исходы звонка](https://docs.hubtalk.ai/ru/v4/web-api/call-status.md) |
| Блокеры и предупреждения запуска | [Объект кампании](https://docs.hubtalk.ai/ru/v4/web-api/campaign-object.md) |
| Экспертная логика в кабинете | [Запуск кампании](https://docs.hubtalk.ai/ru/v4/platform/campaign-launch.md) |


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