---
title: "Kuanza haraka (API)"
description: "Jibu simu yako ya kwanza kwa ejenti wa AI: pata ufunguo wa API, unda ejenti, toa namba ya simu, na piga simu ya majaribio ya moja kwa moja — yote kupitia API ya REST."
---
Mwongozo huu unakuonyesha miito minne ya REST inayohitajika kujibu
simu yako ya kwanza kwa ejenti wa AI.
Utahitaji [akaunti ya ThunderPhone](https://app.thunderphone.com).
Kujisajili ni bila malipo na huchukua chini ya dakika moja. Unapendelea kubofya badala ya kutumia curl?
[Mwongozo wa kuanza haraka wa dashibodi](/sw/quickstart-dashboard) hukufikisha kwenye
simu hiyo ya kwanza bila kuandika msimbo wowote.
## Hatua ya 1: Pata ufunguo wa API
Fungua [app.thunderphone.com](https://app.thunderphone.com).
Nenda kwenye **Shirika → Funguo** katika dashibodi.
Bofya **Unda ufunguo**, ipe jina, kisha nakili thamani ya
`sk_live_...`. Ufunguo halisi huonyeshwa **mara moja tu** — uhifadhi
katika msimamizi wako wa siri mara moja.
Umekwama? [Unda ufunguo wa API wa seva](/sw/guides/api-keys) unaeleza
mchakato huu kwa kina hatua kwa hatua, na msaidizi wa ndani ya programu anaweza
kukuonyesha kila kidhibiti moja kwa moja.
Katika mwongozo huu wote, badilisha `sk_live_YOUR_API_KEY` kwa thamani
uliyonakili hivi punde. Ufunguo hutambua shirika lako kiotomatiki, kwa hivyo
huhitaji kamwe kuweka kitambulisho cha shirika kwenye URL.
## Hatua ya 2: Unda ejenti
Ejenti hufafanua jinsi AI inavyoshughulikia mazungumzo — prompt, sauti,
ngazi ya bidhaa, zana, na ustahiki wa 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);
```
Ngazi za bidhaa: `spark` imeboreshwa kwa gharama, `bolt` kwa kasi, na
`storm-base` / `storm-extra` kwa akili kwenye prompt changamano. Tazama
[Ejenti](/api-reference/agents#product-tiers-at-a-glance) kwa ulinganisho
kamili.
## Hatua ya 3: Toa nambari ya simu
Ombi hili linaomba ThunderPhone nambari na kumteua ejenti wako
mpya kama mshughulikiaji wa simu zinazoingia. (Ili kuleta nambari yako kutoka kwa mtoa huduma wa VoIP,
angalia [miunganisho ya VoIP](/api-reference/voip-connections)
badala yake.)
```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"])
```
Nambari yako mpya huanza katika `status="provisioning"` na kubadilika kuwa
`active` ndani ya sekunde chache; kufikia unapofunga kivinjari chako,
nambari huwa tayari kupokea simu.
## Hatua ya 4 (si lazima): Sanidi webhook
Kwa matukio ya wakati halisi (uelekezaji wa simu unaobadilika, uchakataji baada ya simu) ongeza
endpoint ya webhook. Jiandikishe kwa matukio unayohitaji pekee.
```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"]
}'
```
Jibu lina `secret` ya matumizi ya mara moja — inakili kwenye kidhibiti chako
cha siri. Tumia siri hiyo kuthibitisha kichwa cha `X-ThunderPhone-Signature`
kwenye maombi yanayoingia (angalia
[muhtasari wa Webhooks](/sw/webhooks/overview)).
## Hatua ya 5: Jaribu ejenti wako
Piga simu kwenye nambari uliyoitoa hivi punde. Ejenti hupokea simu, hujitambulisha,
na hufuata prompt yako.
Kagua simu baada ya kuisha:
```bash
curl https://api.thunderphone.com/v1/calls \
-H "Authorization: Bearer sk_live_YOUR_API_KEY"
```
Chunguza simu mahususi ili kupata transkripti na URL ya rekodi:
```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"
```
---
## Hatua zinazofuata
Ruhusu ejenti wako kupiga API zako wakati wa mazungumzo.
Anzisha simu kutoka kwenye msimbo wako mwenyewe.
Jibu matukio ya simu kwa wakati halisi.
Kila endpoint ya umma, imeandikwa.