---
title: "Изходящи кампании"
description: "Качете списък с контакти и оставете агент да го обработи — с времеви прозорци за обаждания, повторни опити и проследяване на напредъка на живо."
---
Кампаниите набират списък с контакти от ваше име: изберете агент, качете
CSV файл, задайте кога са разрешени обажданията и ThunderPhone обработва списъка
— като повтаря обажданията без отговор и до гласова поща по избрания от вас график. Ще ги намерите в **Ангажираност → Кампании** (`/dashboard/campaigns`).
За еднократни програмни обаждания използвайте вместо това
[API за изходящи обаждания](/bg/guides/place-outbound-calls).
## Предварителни изисквания
- Деплойнат гласов агент.
- **VoIP телефонен номер**, свързан с вашата организация, от който да се извършват обаждания —
номерата на ThunderPhone са само за входящи обаждания и не могат да извършват обаждания в кампании. Вижте
[Свързване на VoIP доставчик](/bg/guides/voip-providers).
- Контакти като CSV файл (или поставен JSON) с колона `phone` или
`phone_number`. **До 5 000 реда при качване**, кодирани в UTF-8.
Новите JSON качвания трябва да са плоски: допълнителните стойности могат да бъдат низове, числа,
булеви стойности или `null`. Редовете, съдържащи масиви или вложени обекти, се отхвърлят
поотделно със съобщение за валидиране; валидните редове все пак се импортират. CSV клетките
са низове. Приетите допълнителни колони се запазват като променливи за всеки контакт в
записите за контакти на кампанията и се подават автоматично при всяко набиране. Заглавки като
`name` и `account_id` съответстват на `{{name}}` и `{{account_id}}` в подканата на запазения
агент. Съпоставянето на име може също да комбинира колони в `name`. Вижте
[променливи за всяко обаждане](/bg/guides/call-variables) за стойностите по подразбиране, правилата за именуване,
ограничението от 32 KB за обект и стойностите, върнати в уебкуките за завършване.
По-старите записи за контакти може да съдържат вложени метаданни от по-ранни JSON качвания.
Тези метаданни остават в съхранения контакт. При всяко набиране стойностите, които не са скаларни, се пропускат от
полезния товар с променливи и се записват имената на игнорираните ключове за този опит, без
да се записват стойности. Повторните опити използват същото филтриране.
## Създаване на кампания
Дайте ѝ име, изберете **гласовия агент** и изберете **номера за обаждане от**
(един от вашите VoIP номера).
Редовете с невалиден телефонен номер или невалидни променливи се отхвърлят поотделно и
се връщат с номерата на редовете им — останалите се импортират без проблем.
Изберете **часова зона** и **дневен начален/краен** прозорец; кампанията
набира само в него. Прозорците може да преминават през полунощ (напр. 22:00 → 02:00).
По желание задайте **начало в**, за да насрочите стартирането, и
**край в**, след който кампанията приключва автоматично.
- **Едновременни обаждания** — колко обаждания тази кампания извършва едновременно
(1–10, по подразбиране 3). Вашата организация също е ограничена до **10
едновременни изходящи обаждания** общо, така че паралелните
кампании споделят този лимит.
- **Максимален брой опити** — колко пъти може да бъде набиран всеки контакт
(по подразбиране 2).
- **Изчакване преди повторен опит (минути)** — времето за изчакване преди повторен опит (по подразбиране 60).
- **Повторен опит при** — кои резултати задействат повторен опит: **без отговор**,
**гласова поща**, **неуспешно** (всички са включени по подразбиране).
Кампаниите се създават като чернови — контакти могат да се добавят само докато
кампанията е чернова. Стартирането на кампания изисква изрично съгласие
с таксите за обажданията. При бъдещо **начало в** тя става
*насрочена*; в противен случай започва *в ход* незабавно.
## Как работят резултатите и повторните опити
След всяко обаждане контактът получава резултат — успешните обаждания се
отбелязват като завършени; обаждане, оценено като без отговор, разпознато като гласова поща или
неуспешно, се повтаря, ако този резултат е в списъка ви **повторен опит при** и
контактът има оставащи опити. Контактите, които изчерпят опитите си, се отбелязват като
*изчерпани*; неуспехите, за които не се извършва повторен опит, се отбелязват като *неуспешни*.
Набирането се поставя на пауза автоматично, докато салдото по акаунта ви не е изрядно,
и се възобновява, щом стане. Оставете
[автоматичното зареждане](/bg/guides/billing-and-topups) включено за дълги кампании.
## Наблюдение и управление
Всяка карта на кампания показва нейния статус и напредък (напр. „173 от 248
завършени“). Отворете кампания, за да видите разбивката по статус, резултатите
за всеки контакт и последните обаждания — всяко води към пълния транскрипт и
запис в хронологията на обажданията.
- **Пауза / възобновяване** — поставянето на пауза спира новите набирания; вече
провежданите обаждания завършват естествено. Кампаниите на пауза могат да се
редактират и възобновяват.
- **Отказ** — спира кампанията окончателно.
- Кампанията завършва автоматично, когато всеки контакт достигне финално
състояние или премине моментът **край в**.
Статуси на кампаниите: `draft`, `scheduled`, `running`, `paused`,
`completed`, `cancelled`. Статуси на контактите: `pending`, `scheduled`,
`calling`, `completed`, `failed`, `exhausted`.
## Следващи стъпки
Слушайте обажданията от кампаниите в реално време.
Осъществявайте отделни обаждания програмно.