ThunderPhone 2.0 ir klāt.Sāciet patstāvīgi — no 2 ¢/min.Lasīt paziņojumu
Sākt darbu

Getting Started

View as Markdown
Open in
ClaudeChatGPTCursor

Ātrā sākšana (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 atbildētu uz savu pirmo tālruņa zvanu ar balss aģentu.

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

  1. Piesakieties
  2. Dodieties uz Keys

    Informācijas panelī atveriet Organization → Keys.

  3. Izveidojiet atslēgu

    Noklikšķiniet uz Create key, 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 savā noslēpumu 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

Aģents nosaka, kā MI 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 ThunderPhone numuru un piešķir jūsu jauno balss 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 jaunais numurs sākas ar status="provisioning" un dažu sekunžu laikā pāriet uz active; līdz brīdim, kad aizvērsiet pārlūkprogrammu, numurs būs gatavs pieņemt zvanus.

4. darbība (neobligāti): Iestatiet tīmekļa aizķeri

Lai saņemtu notikumus reāllaikā (dinamisku zvanu maršrutēšanu, apstrādi pēc zvana), pievienojiet tīmekļa aizķeres galapunktu. Abonējiet tikai nepieciešamos notikumus.

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ā noslēpumu pārvaldniekā. Izmantojiet šo noslēpumu, lai verificētu X-ThunderPhone-Signature-V2 galveni ienākošajos pieprasījumos (skatiet Webhook pārskatu).

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

Piezvaniet uz tikko nodrošināto numuru. Balss aģents atbildēs, iepazīstinās ar sevi un ievēros jūsu uzvedni.

Pēc zvana beigām pārskatiet zvanu:

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