---
title: "Gelen aramaları yönetin (API)"
description: "Uçtan uca: bir yapay zeka ajanını yapılandırın, bir telefon numarasına atayın, arama alın ve dökümü inceleyin."
---
İlk yapay zeka ajanınızı elle mi oluşturuyorsunuz? Kontrol paneli bu akışın
aynısını — ajanı oluşturma, numara ekleme, simülasyon, inceleme — rehberli
bir sihirbazla sunar. Başlamak için
[kontrol paneli hızlı başlangıcına](/tr/quickstart-dashboard) gidin.
Terminalinizden, standart "bir yapay zekanın telefonu yanıtlaması" akışı.
Yapacaklarınız:
1. Bir istem ve ses ile ajan oluşturun.
2. Bir telefon numarası sağlayın (veya mevcut numaranızı getirin) ve ajanı bu numaranın
gelen arama işleyicisi olarak atayın.
3. Numarayı arayın. Arama günlüğünü, transkripti ve kaydı inceleyin.
Toplam API çağrısı: dört. Toplam süre: beş dakikadan kısa.
## 1. Ajan oluşturun
Bir yapay zeka ajanı, aramayı yönlendirecek istemi, sesi ve ürün katmanını bir araya getirir. Yapay zeka ajanında `max_call_duration_seconds`
ve `ring_duration_seconds` gibi arama sınırlarını da ayarlayabilirsiniz. Ajanlar, yapay zeka ajanı konuşmadan önce önceden kaydedilmiş bir giriş mesajını ve en fazla iki zil sesini çalmak için `intro_clip`
ve `intro_ring_count` özelliklerini de destekler. Yeni ajanlar için ayrıca bir saat dilimi gerekir.
Tüm yapılandırma alanları için [Ajanlar](/api-reference/agents) bölümüne bakın; minimum gereksinimler şunlardır:
```bash
curl -X POST https://api.thunderphone.com/v1/agents \
-H "Authorization: Bearer sk_live_YOUR_API_KEY" \
-H "Content-Type: application/json" \
-d '{
"name": "Acme Support",
"prompt": "You are a friendly support agent for Acme. Help callers with orders and returns. Keep answers short.",
"voice": "john",
"product": "spark"
}'
```
Döndürülen `id` değerini kaydedin — 2. adımda buna ihtiyacınız olacak.
En düşük maliyetle basit soru-cevap için `spark`, hızın en önemli olduğu
durumlarda `bolt` seçin. İstemin daha derin muhakeme gerektirdiğinde ve
model düşünürken yarım saniyelik bir bekleme ifadesini tolere edebildiğinizde
`storm-base-with-ack` katmanına yükseltin. Bkz.
[ürün katmanları](/api-reference/agents#product-tiers-at-a-glance).
## 2. Telefon numarası alın
Yalnızca arayabileceğiniz bir numaraya ihtiyacınız varsa, ThunderPhone
havuzundan bir ThunderPhone numarası alın:
```bash
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"}'
```
Yanıt, E.164 biçiminde bir `id` ve `number` içerir. ThunderPhone
numaraları `status="provisioning"` durumunda başlar ve birkaç saniye içinde
`active` olur — isterseniz geçişi izlemek için
[`GET /v1/phone-numbers/{id}`](/api-reference/phone-numbers#retrieve-a-phone-number)
isteğini düzenli olarak sorgulayın.
ThunderPhone numaraları başlangıçta yalnızca gelen aramalara açıktır. Bir kuruluş
yöneticisi, Telefon Numaraları sayfasından giden arama talebinde bulunabilir. ThunderPhone
her talebi manuel olarak inceler; onaylandıktan sonra numaralar arama yapabilir ve
kampanyalar yürütebilir. Müşteri VoIP numaraları değişmeden kalır.
## 3. Ajanı atayın
1. adımdaki ajanı numaranın gelen arama yönüyle ilişkilendirin:
```bash
curl -X PATCH https://api.thunderphone.com/v1/phone-numbers/{phone_id} \
-H "Authorization: Bearer sk_live_YOUR_API_KEY" \
-H "Content-Type: application/json" \
-d '{"inbound_agent_id": 12}'
```
Hepsi bu — numara yayında. Kuruluşunuz için giden arama onaylandıktan sonra,
aynı PATCH isteğinde `outbound_agent_id` değerini de ayarlayabilirsiniz. O zamana
kadar API bu atamayı `400` ile reddeder.
Gelen aramaları sabit bir `inbound_agent_id` yerine bir yapılandırma webhook'u üzerinden yönlendiriyorsanız, bu webhook artık `agent_id` ve `variables` ile birlikte her arama için bir `timezone` döndürebilir.
## 4. Arama alın
Telefonunuzdan numarayı arayın. Ajan aramayı yanıtlar, isteminize göre kendini
tanıtır ve konuşma başlar.
Arama devam ederken,
[`GET /v1/calls`](/api-reference/calls#list-calls) içinde
`status="in_progress"` ile görünür. Arama sona erdiğinde kayıt; `end_reason`,
`duration_seconds`, `billable_minutes` ve (zamanla) bir kayıt URL'si ile yapay zeka
notuyla güncellenir.
Gelen aramalar, kuruluşunuzun
[eşzamanlı arama sınırına](/api-reference/introduction#call-limits) dahil edilir (varsayılan olarak devam eden 20 arama; giden, web ve test
aramalarıyla paylaşılır). Sınıra ulaşıldığında gelen bir arama, yapay zeka ajanı
yanıtlamadan önce reddedilir ve kapatılır, ücretlendirilmez ve
`concurrent_call_limit_reached` bitiş nedeni ile başarısız bir arama olarak kaydedilir. Daha yüksek bir sınıra
ihtiyacınız varsa support@thunderphone.com adresine e-posta gönderin.
## 5. Sonuçları inceleyin
Son aramaların listesini alın:
```bash
curl 'https://api.thunderphone.com/v1/calls?limit=5' \
-H "Authorization: Bearer sk_live_YOUR_API_KEY"
```
Transkripti alın:
```bash
curl https://api.thunderphone.com/v1/calls/{call_id}/transcript \
-H "Authorization: Bearer sk_live_YOUR_API_KEY"
```
Ve kayıt URL'sini alın (kısa ömürlü, imzalı):
```bash
curl https://api.thunderphone.com/v1/calls/{call_id}/audio \
-H "Authorization: Bearer sk_live_YOUR_API_KEY"
```
[`telephony.complete` webhook'una](/tr/webhooks/events)
abone olduysanız aynı verileri sunucunuza POST olarak alırsınız — bkz.
[call.complete](/tr/webhooks/call-complete).
Ajanınız için veri çıkarma alanları yapılandırıldıysa, tamamlanan arama yükü
yapılandırılmış çıkarılmış verileri de içerebilir.
---
## Sonraki adımlar
Telefon numarasına veya webhook'taki özel mantığa göre her arayan için farklı bir ajan seçin.
Ajanın görüşme sırasında API'lerinizi çağırmasını sağlayın.
Arayanları doğrudan yönlendirin veya bağlamadan önce hedefi değerlendirin.
Tamamlanan her aramayı CRM / analiz hattınıza aktarın.
Her aramayı otomatik olarak puanlayın ve işaretlenenleri incelemeye yönlendirin.