---
title: "Брзи почетак (API)"
description: "Одговорите на свој први телефонски позив уз помоћ AI агента: преузмите API кључ, креирајте агента, обезбедите телефонски број и упутите тест позив уживо — све путем REST API-ја."
---
Овај водич Вас води кроз четири REST позива потребна да одговорите
на свој први телефонски позив помоћу AI агента.
Биће Вам потребан [ThunderPhone налог](https://app.thunderphone.com).
Регистрација је бесплатна и траје мање од минута. Више волите кликање него рад у командној линији?
[Брзи почетак на контролној табли](/sr/quickstart-dashboard) омогућава исти
први позив без писања кода.
## Корак 1: Преузмите API кључ
Отворите [app.thunderphone.com](https://app.thunderphone.com).
На контролној табли идите на **Организација → Кључеви**.
Кликните на **Креирај кључ**, доделите му назив и копирајте
вредност `sk_live_...`. Необрађени кључ се приказује **само једном** — одмах га сачувајте
у свом менаџеру тајни.
Заглавили сте? [Креирање API кључа за сервер](/sr/guides/api-keys) објашњава
овај поступак корак по корак, а копилот у апликацији може
уживо да Вам истакне сваку контролу.
У целом овом водичу замените `sk_live_YOUR_API_KEY` вредношћу коју сте
управо копирали. Кључ аутоматски идентификује Вашу организацију, па
никада не морате да стављате ИД организације у URL адресе.
## Корак 2: Креирајте агента
Агент одређује како AI води разговоре — упит, глас,
ниво производа, алате и доступност виџета.
```bash 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 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"])
```
```javascript 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);
```
Нивои производа: `spark` је оптимизован за цену, `bolt` за брзину, а
`storm-base` / `storm-extra` за интелигенцију при сложеним упитима. Погледајте
[Агенте](/api-reference/agents#product-tiers-at-a-glance) за потпуно
поређење.
## Корак 3: Обезбедите телефонски број
Овај позив тражи број од ThunderPhone и додељује вашег
новог агента као обрађивача долазних позива. (Да бисте користили сопствени број од VoIP
провајдера, погледајте [VoIP везе](/api-reference/voip-connections).)
```bash 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/ \
-H "Authorization: Bearer sk_live_YOUR_API_KEY" \
-H "Content-Type: application/json" \
-d '{"inbound_agent_id": 12}'
```
```python 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"])
```
Ваш нови број почиње са `status="provisioning"` и прелази у
`active` у року од неколико секунди; док затворите прегледач,
број је спреман за примање позива.
## Корак 4 (опционо): Подесите веб-хук
За догађаје у реалном времену (динамичко усмеравање позива, обрада након позива) додајте
крајњу тачку веб-хука. Претплатите се само на догађаје који су вам потребни.
```bash
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"]
}'
```
Одговор садржи једнократну вредност `secret` — копирајте је у свој
менаџер тајни. Користите ту тајну да бисте потврдили заглавље
`X-ThunderPhone-Signature` у долазним захтевима (погледајте
[Преглед веб-хукова](/sr/webhooks/overview)).
## Корак 5: Тестирајте агента
Позовите број који сте управо обезбедили. Агент се јавља, представља
се и прати ваш упит.
Прегледајте позив након што се заврши:
```bash
curl https://api.thunderphone.com/v1/calls \
-H "Authorization: Bearer sk_live_YOUR_API_KEY"
```
Отворите детаље одређеног позива да бисте преузели транскрипт и URL снимка:
```bash
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"
```
---
## Следећи кораци
Омогућите агенту да позива ваше API-је током разговора.
Покрећите позиве из сопственог кода.
Реагујте на догађаје позива у реалном времену.
Документована је свака јавна крајња тачка.