---
title: "Kampeni za kupiga simu"
description: "Pakia orodha ya mawasiliano na uache ejenti aishughulikie — kwa vipindi vya kupiga simu, majaribio ya kurudia, na maendeleo ya moja kwa moja."
---
Kampeni hupigia orodha ya anwani kwa niaba yako: chagua ejenti, pakia
CSV, weka muda ambao kupiga simu kunaruhusiwa, na ThunderPhone hushughulikia orodha
— ikijaribu tena simu zisizojibiwa na ujumbe wa sauti kulingana na ratiba unayochagua. Zipate chini ya **Ushirikishaji → Kampeni** (`/dashboard/campaigns`).
Kwa simu za programu za mara moja, tumia
[API ya simu za kutoka](/sw/guides/place-outbound-calls) badala yake.
## Mahitaji ya awali
- Ejenti ya sauti iliyotumwa.
- **Nambari ya simu ya VoIP** iliyounganishwa na shirika lako ya kupigia simu —
nambari za ThunderPhone ni za simu zinazoingia pekee na haziwezi kupiga simu za kampeni. Tazama
[Unganisha mtoa huduma wa VoIP](/sw/guides/voip-providers).
- Anwani katika faili ya CSV (au JSON iliyobandikwa) yenye safu ya `phone` au
`phone_number`. **Hadi safu 5,000 kwa kila upakiaji**, iliyosimbwa kwa UTF-8.
Upakiaji mpya wa JSON lazima uwe bapa: thamani za ziada zinaweza kuwa mifuatano, nambari,
boolea, au `null`. Safu zilizo na mikusanyiko au vitu vilivyopachikwa hukataliwa
kibinafsi kwa ujumbe wa uthibitishaji; safu halali bado huingizwa. Seli za CSV
ni mifuatano. Safu za ziada zinazokubalika huhifadhiwa kama vigeu vya kila anwani kwenye rekodi za
anwani za kampeni na hutolewa kiotomatiki kwa kila upigaji. Vichwa kama
`name` na `account_id` hulingana na `{{name}}` na `{{account_id}}` katika prompt
ya ejenti iliyohifadhiwa. Ulinganishaji wa jina unaweza pia kuunganisha safu kuwa `name`. Tazama
[vigeu vya kila simu](/sw/guides/call-variables) kwa chaguo-msingi, kanuni za majina,
kikomo cha kitu cha KB 32, na thamani zinazorejeshwa katika webhook za ukamilishaji.
Rekodi za zamani za anwani zinaweza kuwa na metadata iliyopachikwa kutoka upakiaji wa awali wa JSON.
Metadata hiyo hubaki kwenye anwani iliyohifadhiwa. Kila upigaji huacha thamani zisizo za scalar kutoka
kwa mzigo wa vigeu na huweka kumbukumbu za majina ya funguo zilizopuuzwa kwa jaribio hilo, bila
kuweka kumbukumbu za thamani. Majaribio ya kurudia hutumia uchujaji huo huo.
## Unda kampeni
Ipe jina, chagua **ejenti ya sauti**, na uchague **nambari ya kupigia**
(moja ya nambari zako za VoIP).
Safu zenye nambari ya simu isiyo halali au vigeu visivyo halali hukataliwa kibinafsi na
kuripotiwa pamoja na nambari zao za safu — safu zingine huingizwa bila tatizo.
Chagua **ukanda wa saa** na kipindi cha **mwanzo/mwisho wa kila siku**; kampeni
hupiga simu ndani yake pekee. Vipindi vinaweza kuvuka usiku wa manane (kwa mfano, 22:00 → 02:00).
Kwa hiari, weka **kuanza saa** ili kuratibu uzinduzi na
**kumaliza saa** ambayo kampeni hukamilika kiotomatiki baada yake.
- **Simu za wakati mmoja** — idadi ya simu ambazo kampeni hii huendesha kwa wakati mmoja
(1–10, chaguo-msingi 3). Shirika lako pia limewekewa kikomo cha **simu 10
za kutoka kwa wakati mmoja** katika kila kitu, hivyo kampeni
sambamba hushiriki kikomo hicho.
- **Idadi ya juu ya majaribio** — idadi ya mara ambazo kila anwani inaweza kupigiwa
(chaguo-msingi 2).
- **Muda wa kusubiri kabla ya kurudia (dakika)** — muda wa kusubiri kabla ya jaribio la kurudia (chaguo-msingi 60).
- **Rudia kwa** — matokeo yanayoanzisha jaribio la kurudia: **hakuna jibu**,
**ujumbe wa sauti**, **imeshindwa** (yote yamewashwa kwa chaguo-msingi).
Kampeni huundwa kama rasimu — anwani zinaweza kuongezwa tu wakati
kampeni ni rasimu. Kuanzisha kampeni kunahitaji idhini ya wazi
kwa gharama za simu. Ikiwa kuna **kuanza saa** kwa siku zijazo, inakuwa
*imeratibiwa*; vinginevyo inaanza *kuendeshwa* mara moja.
## Jinsi matokeo na majaribio ya kurudia yanavyofanya kazi
Baada ya kila simu, anwani hupata matokeo — simu zilizofanikiwa
huwekwa alama kuwa zimekamilika; simu iliyotathminiwa kuwa hakuna jibu, iliyotambuliwa kuwa ujumbe wa sauti, au
iliyoshindwa hujaribiwa tena ikiwa matokeo hayo yako katika orodha yako ya **rudia kwa** na
anwani bado ina majaribio yaliyosalia. Anwani zinazoishiwa na majaribio huwekwa alama
kuwa *zimechoka*; hitilafu zisizoweza kurudiwa huwekwa alama kuwa *zimeshindwa*.
Kupiga simu husitishwa kiotomatiki wakati salio la akaunti yako haliko katika hali
inayokubalika, na huendelea likirejea katika hali hiyo. Weka
[ujazaji wa kiotomatiki](/sw/guides/billing-and-topups) ukiwa umewashwa kwa kampeni ndefu.
## Fuatilia na udhibiti
Kila kadi ya kampeni huonyesha hali na maendeleo yake (kwa mfano, "173 kati ya 248
zimekamilika"). Fungua kampeni ili kuona uchanganuzi wa hali, matokeo ya kila anwani
na simu za hivi karibuni — kila kimoja huunganisha kwenye transkripti kamili na
rekodi katika historia ya simu.
- **Sitisha / endelea** — kusitisha huzuia upigaji simu mpya; simu ambazo tayari
zinaendelea hukamilika kwa kawaida. Kampeni zilizosimamishwa zinaweza kuhaririwa na kuendelezwa.
- **Ghairi** — husimamisha kampeni kabisa.
- Kampeni hukamilika yenyewe kila anwani inapofikia hali ya mwisho au muda wa **end at** unapopita.
Hali za kampeni: `draft`, `scheduled`, `running`, `paused`,
`completed`, `cancelled`. Hali za anwani: `pending`, `scheduled`,
`calling`, `completed`, `failed`, `exhausted`.
## Hatua zinazofuata
Sikiliza simu za kampeni zinavyoendelea.
Piga simu za mtu mmoja mmoja kwa programu.