Hitri začetek (API)

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

1. korak: Pridobite ključ API

1. Prijavite se

   Odprite app.thunderphone.com.

2. Pomaknite se do Ključev

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

3. Ustvarite ključ

   Kliknite Ustvari ključ, mu dodelite ime in kopirajte vrednost sk_live_.... Celotna vrednost ključa je prikazana samo enkrat — takoj jo shranite v upravljalnik skrivnosti.

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

2. korak: Ustvarite agenta

Agent določa, kako UI obravnava pogovore — poziv, glas, raven izdelka, orodja in upravičenost za gradnik.

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

Korak 3: Zagotovite telefonsko številko

Ta klic od ThunderPhoneove predstavitvene zbirke zahteva številko in vašemu novemu agentu dodeli vlogo obravnavalca dohodnih klicev. (Če želite uporabiti lastno številko ponudnika VoIP, si namesto tega oglejte povezave VoIP.)

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

Vaša nova številka se najprej ustvari s stanjem status="provisioning" in v nekaj sekundah preide v active; ko zaprete brskalnik, je številka pripravljena na sprejemanje klicev.

Korak 4 (izbirno): Nastavite spletni kavelj

Za dogodke v realnem času (dinamično usmerjanje klicev, obdelava po klicu) dodajte končno točko spletnega kavlja. Naročite se samo 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 upravljalnik skrivnosti. To skrivnost uporabite za preverjanje glave X-ThunderPhone-Signature pri dohodnih zahtevah (glejte Pregled spletnih kavljev).

Korak 5: Preizkusite agenta

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

Po koncu klica ga preglejte:

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