ThunderPhone 2.0 jau čia.Viską atlikite savarankiškai – nuo 2 ct/min.Skaityti pranešimą
Pradėti

Getting Started

View as Markdown
Open in
ClaudeChatGPTCursor

Greitoji pradžia (API)

Atsiliepkite į pirmąjį telefono skambutį naudodami DI agentą: gaukite API raktą, sukurkite agentą, priskirkite telefono numerį ir atlikite tiesioginį bandomąjį skambutį – visa tai per REST API.

Šiame vadove aprašomi keturi REST iškvietimai, kurių reikia, kad į pirmąjį telefono skambutį atsakytų AI agentas.

1 veiksmas: gaukite API raktą

  1. Prisijunkite
  2. Eikite į raktus

    Skydelyje eikite į Organizacija → Raktai.

  3. Sukurkite raktą

    Spustelėkite Sukurti raktą, suteikite jam pavadinimą ir nukopijuokite sk_live_... reikšmę. Neapdorotas raktas rodomas tik vieną kartą — nedelsdami išsaugokite jį savo slaptų duomenų tvarkyklėje.

Visame šiame vadove pakeiskite sk_live_YOUR_API_KEY ką tik nukopijuota reikšme. Raktas automatiškai identifikuoja jūsų organizaciją, todėl URL adresuose niekada nereikia nurodyti organizacijos ID.

2 veiksmas: sukurkite agentą

Agentas apibrėžia, kaip AI tvarko pokalbius — raginimą, balsą, produkto lygį, įrankius ir valdiklio tinkamumą.

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 veiksmas: suteikite telefono numerį

Ši užklausa paprašo ThunderPhone numerio ir priskiria jūsų naują agentą kaip įeinančių skambučių tvarkytuvą. (Jei norite naudoti savo numerį iš VoIP teikėjo, žr. VoIP jungtys.)

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ūsų naujasis numeris iš pradžių turi būseną status="provisioning" ir per kelias sekundes pereina į active; kol uždarysite naršyklę, numeris jau bus pasirengęs priimti skambučius.

4 veiksmas (pasirenkama): nustatykite žiniatinklio kablį

Norėdami gauti įvykius realiuoju laiku (dinaminį skambučių nukreipimą, apdorojimą po skambučio), pridėkite žiniatinklio kablio galinį tašką. Prenumeruokite tik jums reikalingus įvykius.

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

Atsakyme pateikiamas vienkartinis secret — nukopijuokite jį į savo paslapčių tvarkyklę. Naudokite šią paslaptį, kad patikrintumėte X-ThunderPhone-Signature antraštę gaunamose užklausose (žr. Žiniatinklio kablių apžvalga).

5 veiksmas: išbandykite agentą

Paskambinkite ką tik suteiktu numeriu. Agentas atsilieps, prisistatys ir vykdys jūsų raginimą.

Peržiūrėkite skambutį jam pasibaigus:

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

Atidarykite konkretų skambutį, kad gautumėte transkripciją ir įrašo 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"

Tolesni veiksmai

Pridėkite funkcijų įrankius

Leiskite agentui pokalbio metu iškviesti jūsų API.

Skambinkite išeinančiais skambučiais

Paleiskite skambučius iš savo kodo.

Tvarkykite žiniatinklio kablius

Reaguokite į skambučių įvykius realiuoju laiku.

Išsami API nuoroda

Dokumentuoti visi viešieji galiniai taškai.