Ātrais sākums (API)

Šajā ceļvedī aprakstīti četri REST pieprasījumi, kas nepieciešami, lai atbildētu uz pirmo tālruņa zvanu ar balss aģentu.

Jums būs nepieciešams ThunderPhone konts. Reģistrācija ir bez maksas un aizņem mazāk nekā minūti. Vai dodat priekšroku klikšķināšanai, nevis curl lietošanai? Informācijas paneļa ātrā sākšana nodrošina to pašu pirmo zvanu, nerakstot kodu.

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

Piesakieties

Atveriet app.thunderphone.com.

Dodieties uz Atslēgas

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

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 savā noslēpumu pārvaldniekā.

Vai iestrēgāt? Ceļvedī Izveidojiet servera API atslēgu šī darbplūsma ir aprakstīta soli pa solim, un lietotnē iebūvētais palīgs var reāllaikā izcelt katru vadīklu.

Š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 adresēs nekad nav jānorāda organizācijas ID.

2. darbība: izveidojiet aģentu

Balss aģents nosaka, kā MI apstrādā sarunas — uzvedni, balsi, produkta līmeni, rīkus un atbilstību logrīka izmantošanai.

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

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

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

Produktu līmeņi: spark ir optimizēts izmaksām, bolt — ātrumam, bet storm-base / storm-extra — sarežģītu uzvedņu apstrādes intelektam. Pilnu salīdzinājumu skatiet sadaļā Aģenti.

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

Šis izsaukums pieprasa numuru no ThunderPhone demonstrācijas kopas 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.)

# 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}'

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 jaunā numura sākotnējais statuss ir status="provisioning", un tas dažu sekunžu laikā pāriet uz active; līdz pārlūkprogrammas aizvēršanai numurs ir gatavs pieņemt zvanus.

4. darbība (neobligāti): 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 ir 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ējs 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šajos pieprasījumos (skatiet Tīmekļa aizķeru pārskatu).

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

Piezvaniet uz tikko nodrošināto numuru. Balss aģents atbild, iepazīstina ar sevi un izpilda jūsu uzvedni. Pēc zvana beigām pārskatiet to:

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

Pārejiet uz 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.

Getting Started

Using the dashboard

Connect tools & data

Analyze & improve

Team & account

Developer cookbook

Operations

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

2. darbība: izveidojiet aģentu

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

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

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

Nākamās darbības

Pievienojiet funkciju rīkus

Veiciet izejošos zvanus

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

Pilna API atsauce

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

​2. darbība: izveidojiet aģentu

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

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

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

​Nākamās darbības

Pievienojiet funkciju rīkus

Veiciet izejošos zvanus

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

Pilna API atsauce

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

2. darbība: izveidojiet aģentu

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

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

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

Nākamās darbības