ThunderPhone 2.0 ir klāt.Sāciet uzreiz — no 2 centiem minūtē.Lasīt paziņojumu
Sākt darbu

Getting Started

Ātrais sākums (API)

Atbildiet uz savu pirmo tālruņa zvanu ar balss aģentu: iegūstiet API atslēgu, izveidojiet aģentu, piešķiriet tālruņa numuru un veiciet tiešraides pārbaudes zvanu — visu izmantojot REST API.

Šajā ceļvedī ir aprakstīti četri REST izsaukumi, kas nepieciešami, lai ar mākslīgā intelekta aģentu atbildētu uz savu pirmo tālruņa zvanu.

1. darbība: iegūstiet API atslēgu

  1. Piesakieties
  2. Atveriet sadaļu Atslēgas

    Informācijas panelī atveriet Organizācija → Atslēgas.

  3. Izveidojiet atslēgu

    Noklikšķiniet uz Izveidot atslēgu, piešķiriet tai nosaukumu un nokopējiet sk_live_... vērtību. Neapstrādātā atslēga tiek parādīta tikai vienu reizi — nekavējoties saglabājiet to savu slepeno datu pārvaldniekā.

Visā šajā ceļvedī aizstājiet sk_live_YOUR_API_KEY ar tikko nokopēto vērtību. Atslēga automātiski identificē jūsu organizāciju, tāpēc URL nekad nav jānorāda organizācijas ID.

2. darbība: izveidojiet aģentu

Balss aģents nosaka, kā mākslīgais intelekts apstrādā sarunas — uzvedni, balsi, produkta līmeni, rīkus un logrīka pieejamību.

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

3. darbība: nodrošiniet tālruņa numuru

Šis izsaukums pieprasa numuru no ThunderPhone demonstrācijas kopas un piešķir jūsu jauno aģentu kā ienākošo zvanu apstrādātāju. (Lai izmantotu savu numuru no VoIP pakalpojumu sniedzēja, skatiet VoIP savienojumus.)

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

Jūsu jaunajam numuram sākotnēji ir status="provisioning", un tas dažu sekunžu laikā pāriet uz active; līdz brīdim, kad aizvērsiet pārlūkprogrammu, numurs būs gatavs saņemt zvanus.

4. darbība (pēc izvēles): iestatiet tīmekļa aizķeri

Lai saņemtu notikumus reāllaikā (dinamiska zvanu maršrutēšana, apstrāde pēc zvana), pievienojiet tīmekļa aizķeres galapunktu. Abonējiet tikai tos notikumus, kas jums nepieciešami.

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"]
  }'

Atbildē ir vienreiz lietojams secret — nokopējiet to savā slepeno datu pārvaldniekā. Izmantojiet šo slepeno vērtību, lai pārbaudītu X-ThunderPhone-Signature galveni ienākošajiem pieprasījumiem (skatiet Tīmekļa aizķeru pārskatu).

5. darbība: pārbaudiet savu aģentu

Piezvaniet uz tikko nodrošināto numuru. Aģents atbildēs, iepazīstinās ar sevi un sekos jūsu uzvednei.

Pēc zvana beigām pārbaudiet zvana informāciju:

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

Atveriet konkrētu zvanu, lai iegūtu transkripciju un ieraksta URL:

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"

Nākamās darbības

Pievienojiet funkciju rīkus

Ļaujiet savam aģentam sarunas laikā izsaukt jūsu API.

Veiciet izejošos zvanus

Aktivizējiet zvanus no sava koda.

Apstrādājiet tīmekļa aizķeres

Reaģējiet uz zvanu notikumiem reāllaikā.

Pilna API atsauce

Dokumentēts katrs publiskais galapunkts.