---
title: "Konsep inti"
description: "Peta segala hal di Platform — fungsi setiap objek, lokasinya di dashboard, dan API yang menggunakannya."
---
ThunderPhone adalah platform lengkap untuk membangun, menjalankan, dan meningkatkan
agen suara AI. Halaman ini adalah petanya: setiap konsep yang akan Anda temui, masing-masing
dalam satu bagian singkat, beserta tampilan dasbor dan API yang mendukungnya.
Baca sekilas sekali, lalu kembali lagi kapan pun suatu istilah perlu dijelaskan.
Sidebar dasbor mencerminkan struktur ini:
[Agen](#agents), [suara](#voices), [nomor telepon](#phone-numbers),
[widget web](#web-widgets), [panggilan](#calls),
[portal klien](#client-portals), [pengetahuan](#knowledge-bases).
[Pemantauan langsung](#live-monitoring) dan
[kampanye](#campaigns) keluar.
[Aplikasi, API, server MCP, dan penyedia VoIP](#connections) yang
dapat digunakan agen Anda.
[Simulasi](#simulations), [set validasi](#validation-sets),
[eksperimen](#experiments),
[masalah](#issues), [laporan](#reports),
[observabilitas](#observability).
[Tim & peran](#team-and-roles), [kunci API](#organizations),
[peringatan](#alerts), [penagihan](#billing).
[Webhook](#webhooks) dan [function tool](#function-tools) untuk
kode Anda sendiri.
---
## Organisasi
Sebuah **organisasi** adalah unit tenancy. Setiap sumber daya lain —
agen, nomor telepon, panggilan, kunci — dimiliki oleh tepat satu organisasi.
Akun Anda dapat menjadi bagian dari banyak organisasi; masing-masing memiliki saldo,
kunci, dan daftar anggotanya sendiri.
Kunci API `sk_live_` yang Anda buat di bawah **Organisasi → Kunci**
terikat pada satu organisasi. Keterikatan inilah yang membuat REST API sangat
sederhana: Anda tidak pernah memasukkan id organisasi ke dalam jalur URL, karena
kunci Anda sudah mengidentifikasinya.
**Di dasbor:** pengalih organisasi (footer sidebar) dan pengaturan
**Organisasi** — tab untuk Akun saya, Umum, Kunci, Peringatan,
Pengaturan Penagihan, dan Riwayat Penagihan. Lihat
[referensi pengaturan Organisasi](/id/guides/organization-settings).
**Di API:** [`/v1/orgs`](/api-reference/organizations),
[`/v1/developer/api-keys`](/api-reference/developer-api-keys).
---
## Agen
Sebuah **agen** adalah konfigurasi AI yang menjalankan panggilan. Konfigurasi ini mencakup:
- Sebuah **Prompt** yang mengatur apa yang dikatakan agen dan cara agen berperilaku —
termasuk tindakan panggilan seperti transfer, penekanan keypad, dan mengakhiri panggilan,
yang berupa baris Prompt biasa, bukan konfigurasi terpisah.
- Sebuah **tingkat engine** (`spark`, `bolt`, `storm-*`): Spark dioptimalkan
untuk biaya, Bolt untuk kecepatan, Storm untuk kecerdasan pada Prompt yang kompleks.
- Sebuah **suara** serta **bahasa utama** dan **bahasa tambahan**
opsional — agen beralih secara otomatis saat penelepon mengganti
bahasa. Lihat [Bahasa yang didukung](/id/guides/supported-languages).
- Kemampuan yang terpasang: [aplikasi terhubung](#connections),
[koneksi API](#connections), [basis pengetahuan](#knowledge-bases),
[server MCP](#connections), dan
[function tool](#function-tools) inline.
- Pengaturan perilaku: urutan bicara, mode pengakuan, trek latar belakang,
batas waktu tunggu.
Perubahan di builder **disimpan otomatis sebagai draf**; tidak ada yang aktif hingga
Anda mengklik **Deploy**. Setiap deployment disimpan sebagai snapshot di tab
**Riwayat** builder, sehingga Anda dapat memeriksa dan memulihkan versi sebelumnya.
**Di dasbor:** **Agen Suara** → builder agen
(`/dashboard/agents`). Lihat
[Bangun agen suara pertama Anda](/id/guides/build-an-agent).
**Di API:** [`/v1/agents`](/api-reference/agents) — CRUD,
duplikasi, transfer, riwayat versi, dan helper Prompt.
---
## Suara
**Pustaka suara** berisi suara yang dapat digunakan agen, sampel yang dapat
diputar, bahasa yang kompatibel, pengelompokan gender dan aksen, serta biaya tambahan
untuk suara/bahasa premium. Pemutar sampel berbayar dapat menyintesis frasa Anda sendiri
dengan 1–500 karakter sebelum Anda memilih.
Organisasi yang memenuhi syarat juga dapat membuat **suara kustom** dari sampel WAV atau
MP3 singkat. Suara kustom memiliki kuota dan Status pembuatan asinkron; setelah
siap, suara tersebut muncul di pemilih agen yang sama dengan suara pustaka.
**Di dasbor:** **Suara** (`/dashboard/voices`). Lihat
[Pustaka suara dan suara kustom](/id/guides/voice-library).
**Di API:** [`/v1/voices`](/api-reference/voices),
[sampel suara](/api-reference/voice-samples), dan
[suara kustom](/api-reference/custom-voices).
---
## Nomor telepon
**Nomor telepon** dimiliki oleh organisasi dan merutekan panggilan masuk ke
agen (serta dapat menangani panggilan keluar). Dua sumber:
- **nomor ThunderPhone** — nomor AS asli yang disediakan dari
kumpulan ThunderPhone, aktif dalam hitungan detik, {/* rate:phone */}$1/bulan ditambah biaya 1¢/menit{/* /rate */}.
Nomor ini awalnya hanya untuk panggilan masuk. Admin organisasi dapat meminta
panggilan keluar dari halaman Nomor Telepon; ThunderPhone meninjau setiap
permintaan secara manual, dan nomor yang disetujui dapat melakukan panggilan dan menjalankan kampanye.
Secara default, sebuah organisasi dapat memiliki 25 nomor.
- **nomor VoIP** — dibawa dari provider Anda sendiri melalui
[koneksi VoIP](#connections). Twilio dan Telnyx terhubung langsung
dengan kunci API (Telnyx juga memiliki penyiapan akun baru terpandu);
SignalWire, Vonage, Plivo, dan trunk SIP lainnya terhubung melalui
penyiapan SIP, yaitu konfigurasi SIP manual. Setelah diimpor dan diverifikasi, nomor VoIP
mendukung panggilan masuk dan keluar.
Setiap baris nomor memungkinkan Anda mengatur mode perutean, memilih agen
untuk panggilan masuk, dan memberi label pada nomor.
**Di dasbor:** **Nomor Telepon** (`/dashboard/phone-numbers`).
Lihat [Dapatkan nomor telepon](/id/guides/get-a-phone-number).
**Di API:** [`/v1/phone-numbers`](/api-reference/phone-numbers),
[`/v1/voip-connections`](/api-reference/voip-connections),
[`/v1/phone-number-labels`](/api-reference/phone-number-labels).
---
## Panggilan
Setiap panggilan masuk, panggilan keluar, simulasi, dan sesi widget
menjadi **log panggilan**. Panggilan memuat transkrip lengkap dengan tag peran,
riwayat giliran terstruktur (termasuk pemanggilan alat), rekaman,
total penagihan, serta penilaian AI dan laporan masalah opsional.
Saat panggilan **langsung**, Anda dapat membukanya dan **menyimak** — Anda bergabung
secara diam-diam, dan tidak ada peserta panggilan yang mendengar Anda. Setelah menyimak,
Anda dapat **berbisik**: ketik instruksi yang langsung dikirim ke agen Anda
di tengah panggilan; penelepon tidak pernah mendengarnya, dan agen
mengikutinya secara langsung.
**Di dasbor:** **Riwayat Panggilan** (`/dashboard/call-history`) untuk
arsip dan detail per panggilan; **Live** untuk panggilan yang sedang berlangsung. Lihat
[Tinjau, dengarkan, dan arahkan panggilan Anda](/id/guides/review-calls).
**Di API:** [`/v1/calls`](/api-reference/calls) — daftar, transkrip,
riwayat, audio, penilaian, ekspor;
[`/v1/issue-reports`](/api-reference/issue-reports).
---
## Portal klien
**Portal klien** adalah tampilan riwayat panggilan bermerek dan hanya-baca untuk klien
eksternal. Admin organisasi memilih agen yang panggilannya ditampilkan, menambahkan
email pemirsa yang disetujui, mengunggah logo dan warna aksen, serta secara opsional memverifikasi
domain kustom. Pemirsa portal dapat memeriksa detail panggilan, transkrip, dan rekaman
yang tersedia tanpa menerima akses dasbor.
**Di dasbor:** **Portal klien** (`/dashboard/client-portals`). Lihat
[Portal klien](/id/guides/client-portals).
**Di API:** [`/v1/client-portals`](/api-reference/client-portals) untuk
antarmuka pengelolaan admin.
---
## Widget web
**Widget web** memberi pengunjung situs Anda percakapan berbasis mikrofon
dengan agen — tanpa perlu nomor telepon. Widget ini melakukan autentikasi dengan
**kunci yang dapat dipublikasikan** (`pk_live_...`) yang hanya dapat digunakan browser dari domain
yang Anda izinkan, sehingga aman digunakan dalam kode sisi klien. Daftar domain
bukan autentikasi, dan pengaturan sesi yang dapat dikirim oleh halaman dinonaktifkan hingga Anda mengizinkannya pada kunci tersebut.
Kunci berjalan dalam salah satu dari dua mode: `agent` (terikat secara statis pada satu agen)
atau `webhook` (server Anda memilih konfigurasi untuk setiap pengunjung — lihat
[Konfigurasi dinamis per panggilan](/id/guides/dynamic-call-config)). Sesi widget
mengalir melalui infrastruktur panggilan yang sama dengan panggilan telepon.
**Di dasbor:** **Widget Web** (`/dashboard/web-widgets`) —
buat widget, atur mode dan agen, kelola domain yang diizinkan, dan
salin cuplikan sematan. Lihat
[Buat widget web](/id/guides/embed-a-web-widget-dashboard).
**Di API:** [`/v1/publishable-key`](/api-reference/publishable-keys),
[`/v1/mic-session`](/api-reference/mic-sessions), dan
[dokumentasi SDK Widget](/id/widget/overview).
---
## Basis pengetahuan
**Basis pengetahuan** adalah kumpulan dokumen yang dapat dicari agen Anda
saat panggilan berlangsung untuk mendasari jawabannya — unggah file, tempel teks, atau impor
halaman web melalui URL, lalu hubungkan basis pengetahuan tersebut ke agen di
builder. Agen mengkuerinya dengan alat pencarian bawaan setiap kali
percakapan memerlukannya.
**Di dasbor:** **Pengetahuan** (`/dashboard/knowledge`) untuk
perpustakaan dokumen; bagian **Pengetahuan** di builder untuk menghubungkannya ke
agen. Lihat
[Berikan agen Anda basis pengetahuan](/id/guides/knowledge-base).
---
## Koneksi
Koneksi adalah cara agen menjangkau dunia luar. Empat jenis, satu
grup sidebar:
- **Aplikasi** (`/dashboard/app-connections`) — koneksi OAuth ke
Slack, HubSpot, Salesforce, Google Calendar, Google Sheets, dan
Cal.com. Hubungkan sekali, lalu aktifkan alat per operasi (kirim
pesan Slack, perbarui atau tambahkan kontak HubSpot, pesan slot Cal.com…)
untuk agen mana pun. Lihat [Hubungkan aplikasi](/id/guides/connect-apps).
- **API** (`/dashboard/api-connections`) — ubah API HTTP apa pun menjadi
tindakan agen. Tempel perintah cURL dan panduan AI menyusun draf definisi
alat, atau buat secara manual; tombol **Uji Permintaan** menjalankan
panggilan sandbox sebelum Anda merilisnya. Lihat
[Koneksi API](/id/guides/api-connections) — antarmuka dasbor untuk
[`/v1/integrations`](/api-reference/integrations).
- **MCP** (`/dashboard/mcp-connections`) — tambahkan server Model Context
Protocol melalui URL dan biarkan agen menggunakan alat yang disediakannya.
Lihat [Tambahkan server MCP](/id/guides/mcp-servers).
- **VoIP** (`/dashboard/voip-connections`) — kredensial provider untuk
[menggunakan nomor telepon Anda sendiri](#phone-numbers). Lihat
[Hubungkan provider VoIP](/id/guides/voip-providers).
ThunderPhone juga menyediakan endpoint MCP sendiri agar klien MCP eksternal dapat
mencantumkan agen, memeriksa panggilan dan transkrip, serta melakukan panggilan. Lihat
[Gunakan ThunderPhone sebagai server MCP](/id/guides/thunderphone-mcp-server).
**Di API:** [`/v1/integrations`](/api-reference/integrations),
[`/v1/mcp-servers`](/api-reference/mcp-servers), dan
[`/v1/voip-connections`](/api-reference/voip-connections); lihat juga
[Buat integrasi alat](/id/guides/build-tool-integration).
---
## Kampanye
**Kampanye** melakukan panggilan keluar dalam skala besar: unggah CSV berisi
kontak, pilih agen dan nomor asal, lalu atur jendela panggilan
(hari dan jam, dengan mempertimbangkan zona waktu), konkurensi, serta kebijakan percobaan ulang
(jumlah maksimum percobaan dan hasil mana — tidak dijawab, pesan suara, gagal — yang
dicoba ulang). Kampanye memproses daftar tersebut dan mencatat setiap panggilan
di Riwayat Panggilan.
**Di dasbor:** **Kampanye** (`/dashboard/campaigns`). Lihat
[Jalankan kampanye panggilan keluar](/id/guides/outbound-campaigns).
**Untuk panggilan terprogram satu kali:** gunakan
[API panggilan keluar](/id/guides/place-outbound-calls).
## Pemantauan langsung
**Langsung** menampilkan setiap panggilan yang sedang berlangsung di seluruh organisasi, dan memungkinkan Anda
membuka salah satunya untuk [mendengarkan dan membisikkan](#calls) secara real time. Ini adalah
permukaan supervisi: pantau prompt baru saat menerima trafik nyata pertamanya, atau awasi kampanye yang sedang berjalan.
**Di dashboard:** **Langsung** (`/dashboard/live`). Lihat
[Memantau dan mensupervisi panggilan langsung](/id/guides/monitor-live-calls).
---
## Simulasi
Sebuah **simulasi** adalah penelepon AI yang melakukan percakapan nyata dengan agen Anda
— jalur telepon yang sama, transkrip nyata, penilaian nyata — sehingga Anda
dapat menguji sebelum (dan setelah) merilisnya. Arahkan ke agen atau nomor
telepon, tulis sendiri skenario penelepon atau **buat skenario
dengan AI** dari prompt agen (termasuk kasus tepi, jika Anda memintanya),
dan pantau panggilannya secara langsung.
Skenario dikelompokkan dalam **suite** yang menetapkan tingkat kelulusan minimum dan dapat
menjadi gerbang rilis di CI; regresi terhadap baseline yang diterima dilaporkan
untuk setiap skenario.
**Di dashboard:** **Simulasi** (`/dashboard/simulations`), serta
tombol **Simulasi** di dalam builder agen. Lihat
[Mensimulasikan panggilan](/id/guides/simulate-a-call).
**Di API:** [`/v1/test-calls`](/api-reference/test-calls) dan
runner suite — lihat [Menguji agen secara menyeluruh](/id/guides/test-agents).
---
## Set validasi
Sebuah **set validasi** mengubah momen panggilan nyata menjadi pemeriksaan
regresi satu giliran yang dapat diulang. Setiap contoh membekukan konteks percakapan, audio
penelepon yang relevan, respons asli, dan perilaku yang diharapkan. Pemutaran ulang dijalankan terhadap
draf agen saat ini tanpa melakukan panggilan lain, dan dialog deploy dapat
menampilkan apakah eksekusi terbaru masih sesuai dengan draf tersebut.
**Di dashboard:** **Set validasi** (`/dashboard/validation`) untuk dataset
organisasi dan tab **Validasi** pada builder agen untuk eksekusi. Lihat
[Set validasi](/id/guides/validation-sets).
**Di API:** [`/v1/validation-sets`](/api-reference/validation-sets) dan
endpoint pemutaran ulang agen/contoh pada halaman referensi yang sama.
---
## Eksperimen
Sebuah **eksperimen** melakukan pengujian A/B terhadap konfigurasi agen pada trafik langsung:
tentukan varian (Prompt, engine, atau pengaturan yang berbeda), bagi
trafik di antaranya, dan bandingkan hasil per varian. Gunakan ini sebagai pengganti
membuat sendiri logika bucket dalam webhook.
**Di dashboard:** **Eksperimen** (`/dashboard/experiments`) dan
tab **A/B** di builder agen. Lihat
[Eksperimen (pengujian A/B)](/id/guides/experiments-ab-testing).
---
## Masalah
Sebuah **masalah** adalah problem yang ditandai pada panggilan tertentu — diajukan oleh
peninjau manusia atau dideteksi oleh penilaian AI. Masalah mencakup tingkat keparahan,
sumber, dan status, dan halaman Masalah adalah antrean triase: filter,
periksa panggilan bermasalah, dan lacak perbaikannya.
**Di dashboard:** **Masalah** (`/dashboard/issues`), serta
penandaan per panggilan di Riwayat Panggilan. Lihat [Triase masalah](/id/guides/issues).
**Di API:** [`/v1/issue-reports`](/api-reference/issue-reports).
---
## Laporan
Sebuah **laporan** menjawab pertanyaan bahasa alami tentang data panggilan Anda
("Apa tiga alasan utama penelepon meminta berbicara dengan manusia minggu
lalu?") dengan analisis yang ditulis AI, dibatasi pada agen dan rentang
tanggal yang Anda pilih.
**Di dashboard:** **Laporan** (`/dashboard/reports`). Lihat
[Laporan](/id/guides/reports).
---
## Observabilitas
**Observabilitas** adalah permukaan metrik: volume panggilan, hasil, dan
kualitas dari waktu ke waktu, dapat difilter berdasarkan agen dan jangka waktu, dengan ekspor
untuk analisis lanjutan.
**Di dashboard:** **Observabilitas** (`/dashboard/observability`).
Lihat [Observabilitas](/id/guides/observability).
---
## Peringatan
Sebuah **aturan peringatan** memantau metrik (tingkat keberhasilan, tingkat kegagalan,
skor rata-rata, volume panggilan, regresi suite) selama jangka waktu dan
aktif saat melewati ambang batas Anda. Notifikasi dikirim ke email dan
Slack, serta memicu event `alert.triggered` ke
[endpoint webhook](/id/webhooks/endpoints) Anda.
**Di dashboard:** **Organisasi → Peringatan**. Lihat
[Peringatan](/id/guides/alerts).
---
## Webhook
ThunderPhone mengirim **webhook HTTP POST** ke server Anda saat berbagai hal
terjadi selama dan setelah panggilan. Dua model pengiriman:
- **Endpoint webhook** (direkomendasikan): kelola banyak URL di
[`/v1/developer/webhook-endpoints`](/id/webhooks/endpoints) dengan
secret per endpoint dan langganan peristiwa per endpoint.
- **Webhook URL tunggal lama**: satu URL per organisasi. Dikelola di
[`/v1/webhook`](/api-reference/organizations#legacy-single-url-webhook)
atau di bawah **Organisasi → Umum**. Dipertahankan untuk kompatibilitas mundur.
Peristiwa dibagi menjadi dua kelas:
- **Peristiwa pemblokiran** mengharapkan server Anda merespons dengan konfigurasi
yang membentuk panggilan yang sedang berlangsung — yaitu
[peristiwa panggilan masuk](/id/webhooks/call-incoming)
(`telephony.incoming` / `web.incoming`). Panggilan telepon menunggu hingga
13 detik, termasuk satu percobaan ulang, dan sesi widget 10 detik.
Tidak ada agen cadangan: tanpa konfigurasi yang dapat digunakan, panggilan
telepon diakhiri dan sesi widget gagal.
- **Peristiwa non-pemblokiran** adalah notifikasi kirim-dan-lupakan, yang dicoba ulang
dengan backoff eksponensial — lihat
[semantik pengiriman](/id/webhooks/overview).
Setiap permintaan membawa tanda tangan HMAC-SHA256 bertimestamp dalam
`X-ThunderPhone-Signature-V2`, beserta
`X-ThunderPhone-Signature` lama yang hanya mencakup isi. Lihat
[verifikasi tanda tangan](/id/webhooks/overview).
---
## Alat fungsi
**Alat fungsi** adalah endpoint HTTP yang dapat dipanggil agen Anda
di tengah percakapan. Anda memberikan ThunderPhone skema fungsi bergaya OpenAI
beserta URL endpoint; agen memutuskan kapan harus memanggilnya, lalu
ThunderPhone membuat permintaan HTTP bertanda tangan dari servernya dan memberikan
hasilnya kembali kepada agen.
Agen juga memiliki **kemampuan panggilan bawaan** — mengalihkan panggilan,
mengirim input keypad (DTMF), mengakhiri panggilan, menunggu dalam antrean — yang
Anda aktifkan dengan baris Prompt biasa, bukan definisi alat.
**Di dashboard:** bagian **Koneksi API** di builder (lihat
[Koneksi](#connections)).
**Di API:** [`/v1/integrations`](/api-reference/integrations) dan
[spesifikasi Alat Fungsi](/id/tools/overview).
---
## Tim dan peran
Setiap organisasi memiliki daftar anggota dengan dua peran: **Anggota** membangun
dan mengoperasikan agen; **Admin** juga mengelola tim dan penagihan.
Undang melalui email — undangan kedaluwarsa setelah 7 hari dan dapat dicabut;
menu ⋯ pada baris anggota mengubah peran atau menghapus seseorang. Masuk tunggal
dapat dikonfigurasi untuk seluruh organisasi — lihat [SSO](/id/guides/sso).
**Di dashboard:** **Organisasi → Umum**. Lihat
[Undang tim Anda](/id/guides/invite-your-team).
**Di API:** [`/v1/members`](/api-reference/members),
[`/v1/invites`](/api-reference/invites).
---
## Penagihan
ThunderPhone bersifat **prabayar**. Setiap organisasi memiliki saldo USD; panggilan
mengurangi saldo tersebut sesuai tarif per menit agen (tingkat mesin ditambah biaya tambahan —
builder menampilkan tarif total secara langsung saat Anda mengubah pengaturan, dan
[bahasa tambahan tertentu](/id/guides/supported-languages) menambahkan {/* rate:language */}3¢/menit{/* /rate */}). Saat
saldo mencapai nol, panggilan masuk ditolak dan panggilan keluar
mengembalikan `402 Payment Required`.
Isi ulang secara manual, atau aktifkan **isi ulang otomatis** dengan ambang saldo,
jumlah pengisian ulang, dan batas pengeluaran bulanan opsional — sehingga panggilan
tidak pernah terputus di tengah kalimat.
**Di dashboard:** **Organisasi → Pengaturan Penagihan** dan
**Riwayat Penagihan**. Lihat
[Tambahkan dana dan aktifkan isi ulang otomatis](/id/guides/billing-and-topups), serta
[referensi harga lengkap](/id/guides/pricing).
**Di API:** [`/v1/billing`](/api-reference/billing).
---
## Kopilot dalam aplikasi
Dashboard dilengkapi **kopilot** bawaan — tanyakan "bagaimana cara melakukan X"
dan kopilot akan menjawab berdasarkan dokumentasi ini, menawarkan panduan
langkah demi langkah yang menyoroti kontrol sebenarnya, serta dapat memutar ulang
tur terpandu apa pun. Ini adalah cara tercepat untuk menemukan kontrol yang disebutkan
halaman ini. Lihat [Tanyakan kepada kopilot dalam aplikasi](/id/guides/ask-the-copilot).
---
## Merangkainya
Wizard lima langkah: agen → penagihan → nomor → simulasi → peninjauan.
Panggilan pertama yang sama dalam empat panggilan REST.
Buat agen, isi saldo, dapatkan nomor, simulasikan, dan tinjau panggilan.
Aplikasi OAuth, API kustom, server MCP, dan penyedia VoIP.
Laporan, observabilitas, eksperimen, masalah, dan peringatan.
Undangan dan peran, kunci API, keamanan, dan SSO.
Resep API: masuk, keluar, konfigurasi dinamis, alat, pengujian.
Lakukan pemeriksaan HMAC dengan benar sekali dan gunakan kembali di mana saja.