Developer cookbook

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.

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 bölümüne bakın; gereken minimum yapılandırma:

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.

2. Bir telefon numarası alın#

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

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} isteğini düzenli olarak sorgulayın.

3. Ajanı atayın#

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

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

curl 'https://api.thunderphone.com/v1/calls?limit=5' \
  -H "Authorization: Bearer sk_live_YOUR_API_KEY"

Transkripti alın:

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ı):

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

telephony.complete webhook'una abone olduysanız, aynı verileri sunucunuza POST olarak alırsınız — call.complete bölümüne bakın.

Sonraki adımlar#