Kampányok

A kampány az, ahogyan automatikusan futtat egy workflow-t sok névjegyen. Ahelyett, hogy egyesével indítana hívásokat az API-n keresztül, feltölti a telefonszámok listáját, és az IntraCord tárcsázza azokat – tiszteletben tartva az ütemezési ablakokat, a párhuzamossági korlátokat és az újrapróbálkozási szabályokat.

Hogyan működik egy kampány

1. Névjegyek CSV-fájljának feltöltése — rendelkeznie kell egy phone_number oszloppal; minden extra oszlop minden hívásnál initial_context lesz
2. Hozza létre a kampányt — kapcsolja össze egy workflow-val, állítsa be a párhuzamosságot, az idősávokat, és próbálja újra
3. Indítsa el – Az IntraCord elkezdi tárcsázni a névjegyeket a párhuzamossági korlátig
4. A haladás nyomon követése – a feldolgozott, befejezett, sikertelen és függőben lévő számlálások valós időben történő nyomon követése
5. Szünet és folytatás – bármikor leállíthatja és újraindíthatja a haladás elvesztése nélkül

A névjegyek CSV

A CSV mozgatja a kampányt. Minden sor egy névjegy.

phone_number,customer_name,account_id,plan
+14155550100,Jane Smith,acc_001,premium
+14155550101,Bob Jones,acc_002,basic

A phone_number-n túli oszlopokat a rendszer automatikusan initial_context néven adja át minden hívásnak, így sablonváltozóként elérhetővé válik az ügyintéző promptjában – így minden hívás nagymértékben személyre szabottnak tűnhet.

Ütemezés és párhuzamosság

A párhuzamosság szabályozza, hogy hány hívás fusson egyidejűleg. Ezt a telefoncsomagja korlátozza. Kezdésként állítsa be konzervatívan.

Az idősávok korlátozzák, hogy IntraCord mikor tárcsázhat – hasznos a munkaidő vagy a szabályok betartása érdekében:

{
  "timezone": "America/New_York",
  "time_slots": [
    { "day": "monday", "start": "09:00", "end": "17:00" },
    { "day": "tuesday", "start": "09:00", "end": "17:00" }
  ]
}

Ha nincs beállítva időrés, az IntraCord folyamatosan tárcsáz a kampány elindítása után.

Próbálja újra a viselkedést

Az IntraCord automatikusan újrapróbálhatja azokat a névjegyeket, akik nem válaszoltak, elfoglaltak vagy hangpostára mentek:

{
  "retry_config": {
    "max_attempts": 3,
    "retry_interval_minutes": 60
  }
}

Áramköri megszakító

Az áramköri megszakító automatikusan szünetelteti a kampányt, ha a híváshiba aránya túl magas lesz – megvédve a felesleges költekezést és a telefonos hírnévvel kapcsolatos problémákat, amelyeket egy rosszul konfigurált ügynök vagy egy rossz névjegylista okoz.

Ha engedélyezve van, az IntraCord egy gördülő időablakon belül figyeli a hibaarányt. Ha túllépi a küszöbértéket, a kampány automatikusan szünetel, és a probléma kivizsgálása után manuálisan kell folytatni.

Beállítás	Alapértelmezett	Leírás
Meghibásodási küszöb (%)	50	Szünet, ha a hibaarány az ablakon belül meghaladja ezt a százalékot
Ablak (másodperc)	120	Gördülő időablak, amely alatt a hibaarányt kiszámítják
Minimális hívások az ablakban	5	Minimális számú hívás szükséges ahhoz, hogy a megszakító kioldódjon – megakadályozza a hamis pozitív eredményeket kis mintákon

Az áramkör-megszakító által szüneteltetett kampány ugyanúgy viselkedik, mint a manuálisan szüneteltetett kampány – a repülés közbeni hívások a szokásos módon fejeződnek be, és a mögöttes probléma megoldása után folytatható.

A kampány életciklusa

Állapot	Jelentése
draft	Létrehozva, de még nem indult el
running	Aktív tárcsázás
paused	Megállt; onnan folytatja, ahol abbahagyta
completed	Minden kapcsolat feldolgozva
failed	Végzetes hiba történt

A kampányt bármikor szüneteltetheti és folytathatja. A repülés közbeni hívások a szokásos módon fejeződnek be, mielőtt a szünet érvénybe lép.

Eredmények

Minden partner hívása futási rekordot hoz létre a teljes átirattal, felvétellel és összegyűjtött kontextussal – ugyanúgy, mint egy manuálisan indított hívás. Használja a Get Campaign Runs endpointot az összes lekéréséhez.

A kezdéshez tekintse meg a Campaigns API referenciát.