Menangani panggilan masuk (API)

Membuat agen pertama Anda secara manual? Dasbor memandu alur yang sama persis — buat agen, tambahkan nomor, simulasikan, tinjau — dengan wizard terpandu. Mulai dari panduan cepat dasbor.

Alur kanonis “menjawab telepon dengan AI”, dari terminal Anda. Anda akan:

Membuat agen dengan Prompt dan suara.
Menyediakan (atau membawa) nomor telepon dan menetapkan agen sebagai penangan panggilan masuknya.
Menelepon nomor tersebut. Amati log panggilan, transkrip, dan rekaman.

Total panggilan API: empat. Total waktu: kurang dari lima menit.

1. Buat agen

Agen menggabungkan Prompt, suara, dan tingkat produk yang akan menangani panggilan. Lihat Agen untuk setiap kolom konfigurasi; minimum yang diperlukan adalah:

curl -X POST https://api.thunderphone.com/v1/agents \
  -H "Authorization: Bearer sk_live_YOUR_API_KEY" \
  -H "Content-Type: application/json" \
  -d '{
    "name":    "Acme Support",
    "prompt":  "You are a friendly support agent for Acme. Help callers with orders and returns. Keep answers short.",
    "voice":   "john",
    "product": "spark"
  }'

Simpan id yang dikembalikan — Anda akan membutuhkannya pada langkah 2.

Pilih spark untuk tanya jawab sederhana dengan biaya terendah, bolt saat kecepatan paling penting. Tingkatkan ke storm-base-with-ack saat Prompt Anda memerlukan penalaran yang lebih mendalam dan dapat menoleransi pengisi selama setengah detik ketika Model berpikir. Lihat tingkat produk.

2. Dapatkan nomor telepon

Jika Anda hanya memerlukan nomor untuk dihubungi, sediakan nomor demo dari kumpulan ThunderPhone:

curl -X POST https://api.thunderphone.com/v1/phone-numbers \
  -H "Authorization: Bearer sk_live_YOUR_API_KEY" \
  -H "Content-Type: application/json" \
  -d '{"area_code": "415"}'

Respons menyertakan id dan number dalam format E.164. Nomor demo dimulai dengan status="provisioning" dan menjadi active dalam beberapa detik — lakukan polling pada GET /v1/phone-numbers/{id} untuk memantau perubahan jika diperlukan.

Untuk produksi, lewati nomor demo dan bawa nomor Anda sendiri melalui VoIP. Nomor demo hanya untuk panggilan masuk dan dibatasi Volume-nya.

3. Tetapkan agen

Kaitkan agen dari langkah 1 dengan arah panggilan masuk nomor tersebut:

curl -X PATCH https://api.thunderphone.com/v1/phone-numbers/{phone_id} \
  -H "Authorization: Bearer sk_live_YOUR_API_KEY" \
  -H "Content-Type: application/json" \
  -d '{"inbound_agent_id": 12}'

Selesai — nomor tersebut aktif. Anda juga dapat menetapkan outbound_agent_id dalam PATCH yang sama agar nomor tersebut juga siap melakukan panggilan keluar.

4. Terima panggilan

Hubungi nomor tersebut dari ponsel Anda. Agen akan menjawab, memperkenalkan diri sesuai Prompt Anda, dan percakapan dimulai. Saat panggilan berlangsung, panggilan akan muncul di GET /v1/calls dengan status="in_progress". Ketika berakhir, catatan diperbarui dengan end_reason, duration_seconds, billable_minutes, dan (pada akhirnya) URL rekaman serta penilaian AI.

5. Periksa hasilnya

Ambil daftar panggilan terbaru:

curl 'https://api.thunderphone.com/v1/calls?limit=5' \
  -H "Authorization: Bearer sk_live_YOUR_API_KEY"

Ambil transkrip:

curl https://api.thunderphone.com/v1/calls/{call_id}/transcript \
  -H "Authorization: Bearer sk_live_YOUR_API_KEY"

Dan URL rekaman (berumur singkat, ditandatangani):

curl https://api.thunderphone.com/v1/calls/{call_id}/audio \
  -H "Authorization: Bearer sk_live_YOUR_API_KEY"

Jika Anda berlangganan ke webhook telephony.complete Anda akan menerima data yang sama sebagai POST ke server Anda — lihat call.complete.

Langkah berikutnya

Konfigurasi dinamis per panggilan

Pilih agen yang berbeda untuk setiap penelepon berdasarkan nomor telepon atau logika kustom dalam webhook.

Tambahkan integrasi tool

Biarkan agen memanggil API Anda di tengah percakapan.

Terima webhook call.complete

Streaming setiap panggilan yang selesai ke pipeline CRM / analitik Anda.

Penilaian AI dan laporan masalah

Nilai setiap panggilan secara otomatis dan arahkan panggilan yang ditandai untuk ditinjau.

Getting Started

Using the dashboard

Connect tools & data

Analyze & improve

Team & account

Developer cookbook

Operations

Menangani panggilan masuk (API)

1. Buat agen

2. Dapatkan nomor telepon

3. Tetapkan agen

4. Terima panggilan

5. Periksa hasilnya

Langkah berikutnya

Konfigurasi dinamis per panggilan

Tambahkan integrasi tool

Terima webhook call.complete

Penilaian AI dan laporan masalah

​1. Buat agen

​2. Dapatkan nomor telepon

​3. Tetapkan agen

​4. Terima panggilan

​5. Periksa hasilnya

​Langkah berikutnya

Konfigurasi dinamis per panggilan

Tambahkan integrasi tool

Terima webhook call.complete

Penilaian AI dan laporan masalah

1. Buat agen

2. Dapatkan nomor telepon

3. Tetapkan agen

4. Terima panggilan

5. Periksa hasilnya

Langkah berikutnya