> ## Documentation Index
> Fetch the complete documentation index at: https://docs.thunderphone.com/llms.txt
> Use this file to discover all available pages before exploring further.

# Kampanye outbound

> Unggah daftar kontak dan biarkan agen menanganinya — dengan jendela panggilan, percobaan ulang, dan progres langsung.

Kampanye menghubungi daftar kontak untuk Anda: pilih agen, unggah
CSV, atur waktu panggilan diizinkan, dan ThunderPhone memproses daftar
tersebut — mencoba ulang panggilan yang tidak dijawab dan pesan suara sesuai jadwal
yang Anda pilih. Temukan di **Engagement → Kampanye** (`/dashboard/campaigns`).

Untuk panggilan terprogram satu kali, gunakan
[API panggilan keluar](/id/guides/place-outbound-calls).

## Prasyarat

* Agen suara AI yang sudah di-deploy.
* **Nomor telepon VoIP** yang terhubung ke organisasi Anda untuk melakukan panggilan —
  nomor demo hanya untuk panggilan masuk dan tidak dapat melakukan panggilan kampanye. Lihat
  [Hubungkan provider VoIP](/id/guides/voip-providers).
* Kontak sebagai file CSV (atau JSON yang ditempel) dengan kolom `phone` atau
  `phone_number`. **Maksimal 5.000 baris per unggahan**, dengan encoding UTF-8.
  Setiap kolom tambahan disimpan sebagai variabel per kontak pada catatan
  kontak kampanye.

## Buat kampanye

<Steps>
  <Step title="Klik Kampanye baru">
    Beri nama, pilih **agen suara AI**, dan pilih **nomor asal**
    (salah satu nomor VoIP Anda).
  </Step>

  <Step title="Unggah CSV kontak">
    Baris dengan nomor telepon tidak valid ditolak secara terpisah dan
    dilaporkan kembali bersama nomor barisnya — sisanya tetap berhasil diimpor.
  </Step>

  <Step title="Atur jendela waktu panggilan">
    Pilih **zona waktu** dan jendela **mulai/berakhir harian**; kampanye
    hanya melakukan panggilan dalam jendela tersebut. Jendela dapat melewati tengah malam (misalnya 22:00 → 02:00).
    Secara opsional, atur **mulai pada** untuk menjadwalkan peluncuran dan
    **berakhir pada** setelah kampanye selesai secara otomatis.
  </Step>

  <Step title="Sesuaikan kecepatan dan percobaan ulang">
    * **Panggilan bersamaan** — jumlah panggilan yang dijalankan kampanye ini sekaligus
      (1–10, default 3). Organisasi Anda juga dibatasi hingga **10
      panggilan keluar bersamaan** untuk semua aktivitas, sehingga kampanye
      paralel berbagi batas tersebut.
    * **Jumlah percobaan maksimum** — berapa kali setiap kontak dapat dihubungi
      (default 2).
    * **Jeda percobaan ulang (menit)** — waktu tunggu sebelum mencoba ulang (default 60).
    * **Coba ulang pada** — hasil yang memicu percobaan ulang: **tidak dijawab**,
      **pesan suara**, **gagal** (semuanya aktif secara default).
  </Step>

  <Step title="Buat draf, lalu mulai">
    Kampanye dibuat sebagai draf — kontak hanya dapat ditambahkan saat
    kampanye masih berupa draf. Memulai kampanye memerlukan persetujuan eksplisit
    atas biaya panggilan. Dengan **mulai pada** di masa mendatang, kampanye menjadi
    *terjadwal*; jika tidak, kampanye langsung mulai *berjalan*.
  </Step>
</Steps>

## Cara kerja hasil dan percobaan ulang

Setelah setiap panggilan, kontak mendapatkan hasil — panggilan yang berhasil
ditandai selesai; panggilan yang dinilai tidak dijawab, terdeteksi sebagai pesan suara, atau
gagal akan dicoba ulang jika hasil tersebut ada dalam daftar **coba ulang pada** Anda dan
kontak masih memiliki sisa percobaan. Kontak yang kehabisan percobaan ditandai
*habis*; kegagalan yang tidak dapat dicoba ulang ditandai *gagal*.

<Note>
  Panggilan dijeda secara otomatis selama saldo akun Anda bermasalah,
  dan dilanjutkan setelah normal kembali. Aktifkan
  [isi ulang otomatis](/id/guides/billing-and-topups) untuk kampanye jangka panjang.
</Note>

## Pantau dan kendalikan

Setiap kartu kampanye menampilkan status dan progresnya (misalnya "173 dari 248
selesai"). Buka kampanye untuk melihat rincian status, hasil per kontak,
dan panggilan terbaru — masing-masing menautkan ke transkrip dan
rekaman lengkap di riwayat panggilan.

* **Jeda / lanjutkan** — menjeda menghentikan panggilan baru; panggilan yang sudah
  berlangsung akan selesai secara alami. Kampanye yang dijeda dapat diedit dan dilanjutkan.
* **Batalkan** — menghentikan kampanye secara permanen.
* Kampanye selesai dengan sendirinya ketika setiap kontak mencapai status akhir
  atau waktu **berakhir pada** terlewati.

Status kampanye: `draft`, `scheduled`, `running`, `paused`,
`completed`, `cancelled`. Status kontak: `pending`, `scheduled`,
`calling`, `completed`, `failed`, `exhausted`.

## Langkah berikutnya

<CardGroup cols={2}>
  <Card title="Pantau panggilan secara langsung" icon="tower-broadcast" href="/id/guides/monitor-live-calls">
    Dengarkan panggilan kampanye saat berlangsung.
  </Card>

  <Card title="API panggilan keluar" icon="phone-arrow-up-right" href="/id/guides/place-outbound-calls">
    Lakukan panggilan individual secara terprogram.
  </Card>
</CardGroup>