> ## Documentation Index
> Fetch the complete documentation index at: https://docs.thunderphone.com/llms.txt
> Use this file to discover all available pages before exploring further.

# Gelen aramaları yönetin (API)

> 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.

<Note>
  İlk yapay zeka ajanınızı elle mi oluşturuyorsunuz? Kontrol paneli bu akışın
  tam olarak 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.
</Note>

Terminalinizden, standart "bir telefonu yapay zekayla yanıtlama" akışı.
Şunları yapacaksınız:

1. İstem ve ses içeren bir 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 az.

## 1. Bir ajan oluşturun

Bir ajan; aramayı yönlendirecek istemi, sesi ve ürün katmanını bir araya getirir.
Tüm yapılandırma alanları için [Ajanlar](/api-reference/agents) bölümüne bakın; gereken minimum yapılandırma:

```bash theme={null}
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.

<Tip>
  En düşük maliyetle basit soru-cevap için `spark`, hızın en önemli olduğu
  durumlarda `bolt` seçin. İsteminiz daha derin muhakeme gerektiriyorsa ve
  model düşünürken yarım saniyelik bir bekleme ifadesini tolere edebiliyorsa
  `storm-base-with-ack` katmanına yükseltin.
  [Ürün katmanları](/api-reference/agents#product-tiers-at-a-glance) bölümüne bakın.
</Tip>

## 2. Bir telefon numarası alın

Yalnızca arayabileceğiniz bir numaraya ihtiyacınız varsa ThunderPhone havuzundan
bir demo numarası sağlayın:

```bash theme={null}
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. Demo numaraları
`status="provisioning"` durumunda başlar ve birkaç saniye içinde `active`
olur — ilgileniyorsanız 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.

<Note>
  Üretim için demo numaralarını atlayın ve
  [VoIP üzerinden kendi numaralarınızı getirin](/tr/guides/bring-your-own-numbers).
  Demo numaraları yalnızca gelen aramalar içindir ve hacim sınırına sahiptir.
</Note>

## 3. Ajanı atayın

1. adımdaki ajanı numaranın gelen arama yönüyle ilişkilendirin:

```bash theme={null}
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. Numaranın giden aramalar yapmaya da hazır olması için
aynı PATCH isteğinde `outbound_agent_id` değerini de ayarlayabilirsiniz.

## 4. Bir arama alın

Numarayı telefonunuzdan 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 notunu içerecek şekilde güncellenir.

## 5. Sonuçları inceleyin

Son aramaların listesini getirin:

```bash theme={null}
curl 'https://api.thunderphone.com/v1/calls?limit=5' \
  -H "Authorization: Bearer sk_live_YOUR_API_KEY"
```

Transkripti alın:

```bash theme={null}
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 theme={null}
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 —
[call.complete](/tr/webhooks/call-complete) bölümüne bakın.

***

## Sonraki adımlar

<CardGroup cols={2}>
  <Card title="Çağrı başına dinamik yapılandırma" icon="bolt" href="/tr/guides/dynamic-call-config">
    Telefon numarasına veya bir webhook'taki özel mantığa göre her arayan için farklı bir ajan seçin.
  </Card>

  <Card title="Araç entegrasyonları ekleyin" icon="screwdriver-wrench" href="/tr/guides/build-tool-integration">
    Ajanın görüşme sırasında API'lerinizi çağırmasını sağlayın.
  </Card>

  <Card title="call.complete webhook'larını alın" icon="bolt" href="/tr/webhooks/call-complete">
    Tamamlanan her çağrıyı CRM / analiz işlem hattınıza aktarın.
  </Card>

  <Card title="Yapay zeka derecelendirmesi ve sorun raporları" icon="chart-line" href="/api-reference/calls#ai-call-grading">
    Her çağrıyı otomatik olarak puanlayın ve işaretlenenleri incelemeye yönlendirin.
  </Card>
</CardGroup>