ThunderPhone 2.0 je tu.Začnite sami, že od 2 ¢/min.Preberite obvestilo
Začnite

Getting Started

View as Markdown
Open in
ClaudeChatGPTCursor

Hitri začetek (API)

Odgovorite na svoj prvi telefonski klic z agentom z umetno inteligenco: pridobite ključ API, ustvarite agenta, zagotovite telefonsko številko in opravite preizkusni klic v živo — vse prek API-ja REST.

Ta vodnik vas popelje skozi štiri klice REST, potrebne za odgovor na vaš prvi telefonski klic z glasovnim agentom z umetno inteligenco.

1. korak: Pridobite ključ API

  1. Prijavite se
  2. Pomaknite se do ključev

    Na nadzorni plošči odprite Organizacija → Ključi.

  3. Ustvarite ključ

    Kliknite Ustvarite ključ, mu določite ime in kopirajte vrednost sk_live_.... Neobdelani ključ je prikazan samo enkrat — takoj ga shranite v upravitelja skrivnosti.

V celotnem vodniku zamenjajte sk_live_YOUR_API_KEY z vrednostjo, ki ste jo pravkar kopirali. Ključ samodejno prepozna vašo organizacijo, zato vam ID-ja organizacije nikoli ni treba dodati v URL-je.

2. korak: Ustvarite agenta

Agent določa, kako umetna inteligenca obravnava pogovore — poziv, glas, produktni paket, orodja in upravičenost do gradnika.

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. korak: Zagotovite telefonsko številko

Ta klic od ThunderPhone zahteva številko in vašega novega agenta dodeli kot upravljavca dohodnih klicev. (Če želite uporabiti svojo številko pri ponudniku VoIP, si oglejte povezave VoIP.)

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

Vaša nova številka se začne v stanju status="provisioning" in v nekaj sekundah preide v active; ko zaprete brskalnik, je številka že pripravljena na sprejemanje klicev.

4. korak (izbirno): Nastavite webhook

Za dogodke v realnem času (dinamično usmerjanje klicev, obdelava po klicu) dodajte končno točko webhooka. Naročite se le na dogodke, ki jih potrebujete.

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

Odgovor vsebuje enkratno secret — kopirajte jo v upravitelja skrivnosti. To skrivnost uporabite za preverjanje glave X-ThunderPhone-Signature pri dohodnih zahtevah (glejte Pregled webhookov).

5. korak: Preizkusite svojega agenta

Pokličite številko, ki ste jo pravkar zagotovili. Agent se oglasi, se predstavi in sledi vašemu pozivu.

Po koncu klica preglejte klic:

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

Odprite podrobnosti določenega klica, da pridobite prepis in URL posnetka:

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"

Naslednji koraki

Dodajte funkcijska orodja

Agentu omogočite klicanje svojih API-jev med pogovorom.

Opravljajte odhodne klice

Sprožite klice iz svoje kode.

Obravnavajte webhooke

Odzivajte se na dogodke klicev v realnem času.

Celotna referenca API-ja

Dokumentirane so vse javne končne točke.