Pornire rapidă (API)

Acest ghid vă prezintă cele patru apeluri REST necesare pentru a răspunde la primul dumneavoastră apel telefonic cu un agent AI.

Veți avea nevoie de un cont ThunderPhone. Înregistrarea este gratuită și durează mai puțin de un minut. Preferați să dați clic în loc să folosiți curl? Ghidul rapid din tabloul de bord vă permite să primiți același prim apel fără să scrieți cod.

Pasul 1: Obțineți o cheie API

Autentificați-vă

Deschideți app.thunderphone.com.

Accesați Chei

Accesați Organizație → Chei în tabloul de bord.

Creați o cheie

Faceți clic pe Creați cheie, denumiți-o și copiați valoarea sk_live_.... Cheia neprelucrată este afișată o singură dată — stocați-o imediat în managerul dumneavoastră de secrete.

V-ați blocat? Creați o cheie API de server vă prezintă acest flux pas cu pas, iar copilotul din aplicație poate evidenția fiecare control pentru dumneavoastră în timp real.

Pe parcursul acestui ghid, înlocuiți sk_live_YOUR_API_KEY cu valoarea pe care tocmai ați copiat-o. Cheia vă identifică automat organizația, astfel încât nu trebuie niciodată să includeți un id de organizație în URL-uri.

Pasul 2: Creați un agent

Un agent definește modul în care AI-ul gestionează conversațiile — promptul, vocea, nivelul de produs, instrumentele și eligibilitatea pentru widget.

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

Niveluri de produs: spark este optimizat pentru cost, bolt pentru viteză, iar storm-base / storm-extra pentru inteligență în cazul prompturilor complexe. Consultați Agenți pentru comparația completă.

Pasul 3: Alocați un număr de telefon

Acest apel solicită un număr din poolul demo ThunderPhone și atribuie noul dumneavoastră agent drept handler pentru apelurile de intrare. (Pentru a aduce propriul număr de la un furnizor VoIP, consultați conexiuni VoIP în schimb.)

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

Noul dumneavoastră număr începe cu status="provisioning" și trece la active în câteva secunde; până când închideți browserul, numărul este pregătit să preia apeluri.

Pasul 4 (opțional): Configurați un webhook

Pentru evenimente în timp real (rutare dinamică a apelurilor, procesare după apel), adăugați un endpoint webhook. Abonați-vă numai la evenimentele de care aveți nevoie.

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

Răspunsul conține un secret de unică folosință — copiați-l în managerul dumneavoastră de secrete. Utilizați acel secret pentru a verifica antetul X-ThunderPhone-Signature pentru cererile primite (consultați prezentarea generală a webhookurilor).

Pasul 5: Testați agentul

Apelați numărul pe care tocmai l-ați alocat. Agentul răspunde, se prezintă și urmează promptul dumneavoastră. Inspectați apelul după ce se încheie:

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

Analizați un apel specific pentru a prelua transcrierea și URL-ul înregistrării:

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"

Pașii următori

Adăugați instrumente de funcții

Permiteți agentului să apeleze API-urile dumneavoastră în timpul unei conversații.

Inițiați apeluri de ieșire

Declanșați apeluri din propriul cod.

Gestionați webhookuri

Reacționați la evenimentele apelurilor în timp real.

Referință API completă

Fiecare endpoint public, documentat.

Getting Started

Using the dashboard

Connect tools & data

Analyze & improve

Team & account

Developer cookbook

Operations

Pasul 1: Obțineți o cheie API

Pasul 2: Creați un agent

Pasul 3: Alocați un număr de telefon

Pasul 4 (opțional): Configurați un webhook

Pasul 5: Testați agentul

Pașii următori

Adăugați instrumente de funcții

Inițiați apeluri de ieșire

Gestionați webhookuri

Referință API completă

​Pasul 1: Obțineți o cheie API

​Pasul 2: Creați un agent

​Pasul 3: Alocați un număr de telefon

​Pasul 4 (opțional): Configurați un webhook

​Pasul 5: Testați agentul

​Pașii următori

Adăugați instrumente de funcții

Inițiați apeluri de ieșire

Gestionați webhookuri

Referință API completă

Pasul 1: Obțineți o cheie API

Pasul 2: Creați un agent

Pasul 3: Alocați un număr de telefon

Pasul 4 (opțional): Configurați un webhook

Pasul 5: Testați agentul

Pașii următori