Gelen aramaları yönetin (API)

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

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

İstem ve ses içeren bir ajan oluşturun.
Bir telefon numarası sağlayın (veya mevcut numaranızı getirin) ve ajanı bu numaranın gelen arama işleyicisi olarak atayın.
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.

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ı bölümüne bakın.

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.

Üretim için demo numaralarını atlayın ve VoIP üzerinden kendi numaralarınızı getirin. Demo numaraları yalnızca gelen aramalar içindir ve hacim sınırına sahiptir.

3. Ajanı atayın

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

Çağrı başına dinamik yapılandırma

Telefon numarasına veya bir webhook’taki özel mantığa göre her arayan için farklı bir ajan seçin.

Araç entegrasyonları ekleyin

Ajanın görüşme sırasında API’lerinizi çağırmasını sağlayın.

call.complete webhook'larını alın

Tamamlanan her çağrıyı CRM / analiz işlem hattınıza aktarın.

Yapay zeka derecelendirmesi ve sorun raporları

Her çağrıyı otomatik olarak puanlayın ve işaretlenenleri incelemeye yönlendirin.

Getting Started

Using the dashboard

Connect tools & data

Analyze & improve

Team & account

Developer cookbook

Operations

Gelen aramaları yönetin (API)

1. Bir ajan oluşturun

2. Bir telefon numarası alın

3. Ajanı atayın

4. Bir arama alın

5. Sonuçları inceleyin

Sonraki adımlar

Çağrı başına dinamik yapılandırma

Araç entegrasyonları ekleyin

call.complete webhook'larını alın

Yapay zeka derecelendirmesi ve sorun raporları

​1. Bir ajan oluşturun

​2. Bir telefon numarası alın

​3. Ajanı atayın

​4. Bir arama alın

​5. Sonuçları inceleyin

​Sonraki adımlar

Çağrı başına dinamik yapılandırma

Araç entegrasyonları ekleyin

call.complete webhook'larını alın

Yapay zeka derecelendirmesi ve sorun raporları

1. Bir ajan oluşturun

2. Bir telefon numarası alın

3. Ajanı atayın

4. Bir arama alın

5. Sonuçları inceleyin

Sonraki adımlar