---
title: "Mulai Cepat (API)"
description: "Jawab panggilan telepon pertama Anda dengan agen AI: dapatkan kunci API, buat agen, sediakan nomor telepon, dan lakukan panggilan uji langsung — semuanya melalui REST API."
---
Panduan ini memandu Anda melalui empat panggilan REST yang diperlukan untuk menjawab
panggilan telepon pertama Anda dengan agen AI.
Anda memerlukan [akun ThunderPhone](https://app.thunderphone.com).
Pendaftaran gratis dan memerlukan waktu kurang dari satu menit. Lebih suka mengklik daripada menggunakan curl?
[Panduan cepat dashboard](/id/quickstart-dashboard) menghasilkan
panggilan pertama yang sama tanpa menulis kode apa pun.
## Langkah 1: Dapatkan kunci API
Buka [app.thunderphone.com](https://app.thunderphone.com).
Buka **Organisasi → Kunci** di dashboard.
Klik **Buat kunci**, beri nama, lalu salin nilai
`sk_live_...`. Kunci mentah hanya ditampilkan **satu kali** — segera simpan
di pengelola rahasia Anda.
Mengalami kendala? [Buat kunci API server](/id/guides/api-keys) memandu
alur ini secara mendetail langkah demi langkah, dan kopilot dalam aplikasi dapat
menyoroti setiap kontrol secara langsung untuk Anda.
Sepanjang panduan ini, ganti `sk_live_YOUR_API_KEY` dengan nilai yang
baru saja Anda salin. Kunci ini mengidentifikasi organisasi Anda secara otomatis, sehingga
Anda tidak perlu memasukkan id organisasi ke URL.
## Langkah 2: Buat agen
Agen menentukan cara AI menangani percakapan — Prompt, suara,
tingkat produk, alat, dan kelayakan widget.
```bash cURL
curl -X POST https://api.thunderphone.com/v1/agents \
-H "Authorization: Bearer sk_live_YOUR_API_KEY" \
-H "Content-Type: application/json" \
-d '{
"name": "Customer Support",
"prompt": "You are a friendly support agent for Acme Corp. Help with orders, returns, and product info. Be concise and helpful.",
"voice": "john",
"product": "spark"
}'
```
```python Python
import os, requests
agent = requests.post(
"https://api.thunderphone.com/v1/agents",
headers={"Authorization": f"Bearer {os.environ['THUNDERPHONE_API_KEY']}"},
json={
"name": "Customer Support",
"prompt": "You are a friendly support agent for Acme Corp. Help with orders, returns, and product info. Be concise and helpful.",
"voice": "john",
"product": "spark",
},
).json()
print("Agent id:", agent["id"])
```
```javascript Node.js
const agent = await fetch("https://api.thunderphone.com/v1/agents", {
method: "POST",
headers: {
Authorization: `Bearer ${process.env.THUNDERPHONE_API_KEY}`,
"Content-Type": "application/json",
},
body: JSON.stringify({
name: "Customer Support",
prompt: "You are a friendly support agent for Acme Corp. Help with orders, returns, and product info. Be concise and helpful.",
voice: "john",
product: "spark",
}),
}).then((r) => r.json());
console.log("Agent id:", agent.id);
```
Tingkat produk: `spark` dioptimalkan untuk biaya, `bolt` untuk kecepatan, dan
`storm-base` / `storm-extra` untuk kecerdasan pada Prompt kompleks. Lihat
[Agen](/api-reference/agents#product-tiers-at-a-glance) untuk perbandingan
lengkap.
## Langkah 3: Sediakan nomor telepon
Panggilan ini meminta nomor dari ThunderPhone dan menetapkan agen baru
Anda sebagai penangan panggilan masuk. (Untuk membawa nomor Anda sendiri dari penyedia VoIP,
lihat [koneksi VoIP](/api-reference/voip-connections)
sebagai gantinya.)
```bash cURL
# First provision
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"}'
# Then assign the agent you created in Step 2
curl -X PATCH https://api.thunderphone.com/v1/phone-numbers/ \
-H "Authorization: Bearer sk_live_YOUR_API_KEY" \
-H "Content-Type: application/json" \
-d '{"inbound_agent_id": 12}'
```
```python Python
number = requests.post(
"https://api.thunderphone.com/v1/phone-numbers",
headers={"Authorization": f"Bearer {os.environ['THUNDERPHONE_API_KEY']}"},
json={"area_code": "415"},
).json()
requests.patch(
f"https://api.thunderphone.com/v1/phone-numbers/{number['id']}",
headers={"Authorization": f"Bearer {os.environ['THUNDERPHONE_API_KEY']}"},
json={"inbound_agent_id": agent["id"]},
)
print("Your ThunderPhone number:", number["number"])
```
Nomor baru Anda dimulai dengan `status="provisioning"` dan beralih ke
`active` dalam beberapa detik; saat Anda menutup browser,
nomor tersebut sudah siap menerima panggilan.
## Langkah 4 (opsional): Siapkan webhook
Untuk peristiwa waktu nyata (perutean panggilan dinamis, pemrosesan setelah panggilan), tambahkan
endpoint webhook. Berlangganan hanya pada peristiwa yang Anda perlukan.
```bash
curl -X POST https://api.thunderphone.com/v1/developer/webhook-endpoints \
-H "Authorization: Bearer sk_live_YOUR_API_KEY" \
-H "Content-Type: application/json" \
-d '{
"label": "Prod webhook",
"url": "https://your-server.com/thunderphone-webhook",
"events": ["telephony.incoming", "telephony.complete"]
}'
```
Respons berisi `secret` sekali pakai — salin ke pengelola secret Anda. Gunakan secret tersebut untuk memverifikasi header `X-ThunderPhone-Signature-V2` pada permintaan masuk (lihat
[Ringkasan Webhooks](/id/webhooks/overview)).
## Langkah 5: Uji agen Anda
Hubungi nomor yang baru saja Anda sediakan. Agen akan menjawab, memperkenalkan
diri, dan mengikuti Prompt Anda.
Periksa panggilan setelah selesai:
```bash
curl https://api.thunderphone.com/v1/calls \
-H "Authorization: Bearer sk_live_YOUR_API_KEY"
```
Telusuri panggilan tertentu untuk mengambil transkrip dan URL rekaman:
```bash
curl https://api.thunderphone.com/v1/calls/{call_id}/transcript \
-H "Authorization: Bearer sk_live_YOUR_API_KEY"
curl https://api.thunderphone.com/v1/calls/{call_id}/audio \
-H "Authorization: Bearer sk_live_YOUR_API_KEY"
```
---
## Langkah berikutnya
Izinkan agen Anda memanggil API Anda selama percakapan.
Picu panggilan dari kode Anda sendiri.
Tanggapi peristiwa panggilan secara waktu nyata.
Setiap endpoint publik, didokumentasikan.