ThunderPhone 2.0 sasa inapatikana.Anza mwenyewe, kuanzia 2¢/dakika.Soma tangazo
Anza sasa

Getting Started

View as Markdown
Open in
ClaudeChatGPTCursor

Kuanza haraka (API)

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.

Hatua ya 1: Pata ufunguo wa API

  1. Ingia
  2. Nenda kwenye Funguo

    Nenda kwenye Shirika → Funguo katika dashibodi.

  3. Unda ufunguo

    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.

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.

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
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"])
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);

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 badala yake.)

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/<id-from-previous> \
  -H "Authorization: Bearer sk_live_YOUR_API_KEY" \
  -H "Content-Type: application/json" \
  -d '{"inbound_agent_id": 12}'
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.

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).

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:

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:

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

Ongeza zana za utendaji

Ruhusu ejenti wako kupiga API zako wakati wa mazungumzo.

Piga simu zinazotoka

Anzisha simu kutoka kwenye msimbo wako mwenyewe.

Shughulikia webhook

Jibu matukio ya simu kwa wakati halisi.

Marejeleo kamili ya API

Kila endpoint ya umma, imeandikwa.