---
title: "Kimenő kampányok"
description: "Töltsön fel egy kapcsolati listát, és hagyja, hogy egy AI-ügynök végighaladjon rajta — hívási időablakokkal, újrapróbálkozásokkal és valós idejű előrehaladással."
---
A kampányok az Ön nevében tárcsázzák a kapcsolattartók listáját: válasszon egy ügynököt, töltsön fel egy
CSV-fájlt, állítsa be, mikor engedélyezett a hívás, és a ThunderPhone végighalad a listán
— az Ön által választott ütemezés szerint újrapróbálva a nem fogadott hívásokat és a hangpostákat. Ezeket a
**Kapcsolatok → Kampányok** (`/dashboard/campaigns`) alatt találja.
Egyszeri, programozott hívásokhoz használja inkább a
[kimenő hívások API-ját](/hu/guides/place-outbound-calls).
## Előfeltételek
- Egy telepített hangalapú AI-ügynök.
- Kimenő hívásokra engedélyezett telefonszám. Az ügyfél VoIP-számai továbbra is támogatják
a kampányokat. A ThunderPhone-számok kezdetben csak bejövő hívásokra használhatók; a szervezet rendszergazdája
a Telefonszámok oldalon kérhet engedélyt a kimenő hívásokhoz. A ThunderPhone minden
kérelmet manuálisan felülvizsgál, és a jóváhagyott számok kampányokat futtathatnak. Lásd:
[VoIP-szolgáltató csatlakoztatása](/hu/guides/voip-providers).
- Kapcsolatok CSV-fájlként (vagy beillesztett JSON-ként), `phone` vagy
`phone_number` oszloppal. **Feltöltésenként legfeljebb 5 000 sor**, UTF-8 kódolással.
Az új JSON-feltöltéseknek sík szerkezetűeknek kell lenniük: a további értékek lehetnek karakterláncok, számok,
logikai értékek vagy `null`. A tömböket vagy beágyazott objektumokat tartalmazó sorokat
a rendszer egyenként, ellenőrzési üzenettel elutasítja; az érvényes sorok ettől még importálódnak. A CSV-cellák
karakterláncok. Az elfogadott további oszlopokat a rendszer hívásonkénti változókként őrzi meg a kampány
kapcsolati rekordjaiban, és automatikusan minden tárcsázásnak átadja. A ThunderPhone emellett
minden kimenő hívás előtt besorolja a mentett AI-ügynöki promptot, hogy eldöntse,
az ügynöknek kell-e telefonos menüben navigálnia. Az olyan fejlécek, mint a `name` és az `account_id`,
megfelelnek a mentett AI-ügynök promptjában szereplő `{{name}}` és `{{account_id}}` változóknak. A névleképezés
oszlopokat is egyesíthet a `name` változóba. Az alapértelmezésekről, az elnevezési szabályokról,
a 32 KB-os objektumkorlátról és a befejezési webhookokban visszaadott értékekről lásd:
[hívásonkénti változók](/hu/guides/call-variables).
A régebbi kapcsolattartói rekordok korábbi JSON-feltöltésekből származó beágyazott metaadatokat tartalmazhatnak.
Ezek a metaadatok a tárolt kapcsolattartón maradnak. Minden tárcsázás kihagyja a nem skaláris értékeket a
változók hasznos adataiból, és az adott próbálkozásnál naplózza a figyelmen kívül hagyott kulcsneveket az értékek
naplózása nélkül. Az újrapróbálkozások ugyanazt a szűrést használják.
## Kampány létrehozása
Adjon neki nevet, válassza ki a **hangalapú AI-ügynököt**, majd válassza ki a **hívószámot**
(az egyik kimenő hívásra engedélyezett számát).
Az érvénytelen telefonszámot vagy érvénytelen változókat tartalmazó sorokat a rendszer egyenként elutasítja, és
a sorszámukkal együtt jelenti vissza — a többi sor probléma nélkül importálható.
Válasszon egy **időzónát** és egy **napi kezdő/záró** időablakot; a kampány
csak ezen belül tárcsáz. Az időzóna alapértelmezetten a hívószám időzónája
(az USA-ban és Kanadában a körzetszám, máshol az ország alapján), illetve több
időzónát lefedő számok, például díjmentes számok esetén a böngészőjének
időzónája. A mező alatti tipp jelzi, hogy melyik érvényes. Az időablak alapértelmezett értéke
9:00–17:00. Figyelmeztetés jelenik meg, ha az időablak 8:00 előtt kezdődik vagy 21:00 után
ér véget: az ezen órákon kívüli hívások sérthetik a hívási időre vonatkozó szabályokat,
például a TCPA szabályait. Ha a záró időpont korábbi, mint a kezdő időpont, az időablak átnyúlik éjfélen: 22:00 →
02:00 esetén a rendszer 22:00-tól a következő nap 2:00-ig tárcsáz, figyelmeztetés mellett. Az
időablak a kampány időzónájában működik, nem az egyes kapcsolatokéban, ezért bontsa a
kapcsolatokat időzóna szerint csoportokra, ha több időzónában találhatók.
Igény szerint állítson be egy **kezdési időpontot** az indítás ütemezéséhez, valamint egy
**befejezési időpontot**, amely után a kampány automatikusan befejeződik.
- **Egyidejű hívások** — hány hívást indít ez a kampány egyszerre
(1–10, alapértelmezett érték: 3). A kampányok nem indítanak új hívást, amíg a
szervezetében 10 kimenő hívás van folyamatban, így a párhuzamos
kampányok ezen a kereten osztoznak. Minden hívás beleszámít a szervezet
[egyidejű hívási korlátjába](/api-reference/introduction#call-limits)
is (alapértelmezetten 20, a bejövő, kimenő, webes és teszthívásokat együtt számítva).
Ha ezt a korlátot eléri, vagy ugyanazt a számot az elmúlt 10 másodpercben hívták,
a kapcsolat egyszerűen egy későbbi körre vár; a próbálkozásai nem fogynak el.
- **Próbálkozások maximális száma** — hányszor tárcsázható az egyes kapcsolat
(1–10, alapértelmezett érték: 2).
- **Újrapróbálkozási késleltetés (perc)** — az újrapróbálkozás előtti várakozási idő (legalább 30,
alapértelmezett érték: 60).
- **Újrapróbálkozás ekkor** — mely eredmények indítanak újrapróbálkozást: **nincs válasz**,
**hangposta**, **sikertelen** (alapértelmezetten mindegyik engedélyezve van).
Több próbálkozásra vagy rövidebb időközre van szüksége? Forduljon az ügyféltámogatáshoz: a munkatársak
mindkét korlátot megemelhetik a szervezete számára.
A kampányok vázlatként jönnek létre — kapcsolatokat csak akkor lehet hozzáadni, amíg a
kampány vázlat. A kampány indításához kifejezetten hozzá kell járulni a
hívási díjakhoz. Jövőbeli **kezdési időpont** esetén a kampány
*ütemezett* állapotba kerül; egyébként azonnal *futó* állapotba lép.
Az ezen korlátok bevezetése előtt mentett kampányok pontosan a konfigurált módon futnak tovább.
Próbálkozásaik és időközeik más szerkesztések során is a mentett értékeken maradnak.
## Hogyan működnek az eredmények és az újrapróbálkozások
Minden hívás után a kapcsolattartó kap egy eredményt — a sikeres hívások
befejezettként vannak megjelölve; a nem fogadottként értékelt, hangpostaként
észlelt vagy sikertelen hívásokat a rendszer újrapróbálja, ha az eredmény
szerepel az Ön **újrapróbálás itt** listájában, és a kapcsolattartónak még
maradt próbálkozása. Azok a kapcsolattartók, akiknek elfogynak a próbálkozásaik,
*kiürültként* vannak megjelölve; a nem újrapróbálható hibák *sikertelenként*
vannak megjelölve.
A tárcsázás automatikusan szünetel, amíg a fiókegyenlege nincs rendezett
állapotban, és folytatódik, amint azzá válik. Hosszú kampányokhoz tartsa
bekapcsolva az [automatikus feltöltést](/hu/guides/billing-and-topups).
## Figyelés és vezérlés
Minden kampánykártya megjeleníti az állapotát és előrehaladását (például „173 / 248
befejezve”). Nyisson meg egy kampányt az állapotok bontásához, a kapcsolattartónkénti
eredményekhez és a legutóbbi hívásokhoz — mindegyik a teljes átirathoz és felvételhez
vezet a híváselőzményekben.
- **Szüneteltetés / folytatás** — a szüneteltetés leállítja az új tárcsázásokat; a már
folyamatban lévő hívások természetesen befejeződnek. A szüneteltetett kampányok
szerkeszthetők és folytathatók.
- **Mégse** — véglegesen leállítja a kampányt.
- Egy kampány automatikusan befejeződik, amikor minden kapcsolattartó eléri a végleges
állapotot, vagy elérkezik a **befejezés időpontja**.
Kampányállapotok: `draft`, `scheduled`, `running`, `paused`,
`completed`, `cancelled`. Kapcsolattartói állapotok: `pending`, `scheduled`,
`calling`, `completed`, `failed`, `exhausted`.
## Következő lépések
Hallgassa a kampányhívásokat valós időben.
Indítson egyedi hívásokat programozottan.