---
title: "Швидкий старт (API)"
description: "Дайте відповідь на свій перший телефонний дзвінок за допомогою AI-агента: отримайте ключ API, створіть агента, підключіть номер телефону та здійсніть тестовий дзвінок у реальному часі — усе через REST API."
---
Цей посібник проведе вас через чотири REST-виклики, потрібні для відповіді
на ваш перший телефонний дзвінок за допомогою AI-агента.
Вам потрібен [обліковий запис ThunderPhone](https://app.thunderphone.com).
Реєстрація безкоштовна й займає менш ніж хвилину. Надаєте перевагу клікам, а не curl?
[Швидкий старт у панелі керування](/uk/quickstart-dashboard) дає змогу прийняти
той самий перший дзвінок без написання коду.
## Крок 1: Отримайте API-ключ
Відкрийте [app.thunderphone.com](https://app.thunderphone.com).
У панелі керування перейдіть до **Організація → Ключі**.
Натисніть **Створити ключ**, надайте йому назву та скопіюйте
значення `sk_live_...`. Необроблений ключ відображається **лише один раз** — негайно збережіть його
у своєму менеджері секретів.
Потрібна допомога? У посібнику [Створення серверного API-ключа](/uk/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-V2` у вхідних запитах (див.
[Огляд вебхуків](/uk/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 під час розмови.
Запускайте виклики з власного коду.
Реагуйте на події викликів у реальному часі.
Документація для кожної публічної кінцевої точки.