Arama Filtreleme

Aramaları filtrelemek için kullanabileceğiniz parametreler ve örnekler

Genel Bakış

Arama listesi API'si, aramaları çeşitli kriterlere göre filtrelemenize olanak tanır. Tüm filtre parametreleri opsiyoneldir ve birlikte kullanılabilir.

Endpoint:

GET /api/v1/calls?[filters]

Tarih Filtreleri

startDateISO 8601

Belirtilen tarihten sonraki aramaları getirir

# Son 7 günün aramalarını getir
curl "https://api.wespoke.ai/api/v1/calls?startDate=2025-01-08T00:00:00Z" \
  -H "Authorization: Bearer YOUR_API_KEY"

endDateISO 8601

Belirtilen tarihten önceki aramaları getirir

# Belirli bir tarih aralığındaki aramaları getir
curl "https://api.wespoke.ai/api/v1/calls?startDate=2025-01-01T00:00:00Z&endDate=2025-01-08T23:59:59Z" \
  -H "Authorization: Bearer YOUR_API_KEY"

Asistan ve Numara Filtreleri

assistantIdstring

Belirli bir asistana ait aramaları filtreler

# Belirli bir asistanın aramalarını getir
curl "https://api.wespoke.ai/api/v1/calls?assistantId=asst_456" \
  -H "Authorization: Bearer YOUR_API_KEY"

phoneNumberIdstring

Belirli bir telefon numarasına ait aramaları filtreler

# Belirli bir numaranın aramalarını getir
curl "https://api.wespoke.ai/api/v1/calls?phoneNumberId=phone_789" \
  -H "Authorization: Bearer YOUR_API_KEY"

callerNumberstring

Belirli bir arayan numarasından gelen aramaları filtreler

# Belirli bir arayan numarasından gelen aramaları getir
curl "https://api.wespoke.ai/api/v1/calls?callerNumber=%2B905559876543" \
  -H "Authorization: Bearer YOUR_API_KEY"

Durum Filtreleri

statusenum

Arama durumuna göre filtreler. Değerler: queued, ringing,in-progress, completed, failed, busy, no-answer

# Tamamlanmış aramaları getir
curl "https://api.wespoke.ai/api/v1/calls?status=completed" \
  -H "Authorization: Bearer YOUR_API_KEY"

# Başarısız aramaları getir
curl "https://api.wespoke.ai/api/v1/calls?status=failed" \
  -H "Authorization: Bearer YOUR_API_KEY"

endReasonenum

Arama bitiş nedenine göre filtreler. Değerler: user_hangup, assistant_hangup,error, timeout, voicemail_detected

# Sesli mesaja düşen aramaları getir
curl "https://api.wespoke.ai/api/v1/calls?endReason=voicemail_detected" \
  -H "Authorization: Bearer YOUR_API_KEY"

directionenum

Arama yönüne göre filtreler. Değerler: inbound (gelen), outbound (giden)

# Sadece giden aramaları getir
curl "https://api.wespoke.ai/api/v1/calls?direction=outbound" \
  -H "Authorization: Bearer YOUR_API_KEY"

Süre Filtreleri

minDurationnumber

Minimum arama süresi (saniye cinsinden)

# 60 saniyeden uzun aramaları getir
curl "https://api.wespoke.ai/api/v1/calls?minDuration=60" \
  -H "Authorization: Bearer YOUR_API_KEY"

maxDurationnumber

Maksimum arama süresi (saniye cinsinden)

# 30 saniyeden kısa aramaları getir (muhtemelen yanıtsız aramalar)
curl "https://api.wespoke.ai/api/v1/calls?maxDuration=30" \
  -H "Authorization: Bearer YOUR_API_KEY"

Belirli bir süre aralığındaki aramaları getir:

# 1-5 dakika arası aramaları getir
curl "https://api.wespoke.ai/api/v1/calls?minDuration=60&maxDuration=300" \
  -H "Authorization: Bearer YOUR_API_KEY"

Maliyet Filtreleri

minCostnumber

Minimum arama maliyeti (TL cinsinden)

# 1 TL'den pahalı aramaları getir
curl "https://api.wespoke.ai/api/v1/calls?minCost=1.0" \
  -H "Authorization: Bearer YOUR_API_KEY"

maxCostnumber

Maksimum arama maliyeti (TL cinsinden)

# 0.50 TL'den ucuz aramaları getir
curl "https://api.wespoke.ai/api/v1/calls?maxCost=0.50" \
  -H "Authorization: Bearer YOUR_API_KEY"

Sıralama ve Sayfalama

sortByenum

Sıralama alanı. Değerler: startTime, duration, cost (varsayılan: startTime)

sortOrderenum

Sıralama yönü. Değerler: asc (artan), desc (azalan, varsayılan)

Örnek: En pahalı aramaları getir

curl "https://api.wespoke.ai/api/v1/calls?sortBy=cost&sortOrder=desc&limit=10" \
  -H "Authorization: Bearer YOUR_API_KEY"

Örnek: En uzun aramaları getir

curl "https://api.wespoke.ai/api/v1/calls?sortBy=duration&sortOrder=desc&limit=10" \
  -H "Authorization: Bearer YOUR_API_KEY"

Gelişmiş Filtreleme Örnekleri

Örnek 1: Başarısız giden aramaları bul

curl "https://api.wespoke.ai/api/v1/calls?direction=outbound&status=failed&startDate=2025-01-01T00:00:00Z" \
  -H "Authorization: Bearer YOUR_API_KEY"

Örnek 2: Belirli bir asistanın uzun ve pahalı aramalarını bul

curl "https://api.wespoke.ai/api/v1/calls?assistantId=asst_456&minDuration=300&minCost=2.0&sortBy=cost&sortOrder=desc" \
  -H "Authorization: Bearer YOUR_API_KEY"

Örnek 3: Bu ay sesli mesaja düşen tüm aramaları bul

curl "https://api.wespoke.ai/api/v1/calls?endReason=voicemail_detected&startDate=2025-01-01T00:00:00Z&endDate=2025-01-31T23:59:59Z" \
  -H "Authorization: Bearer YOUR_API_KEY"

Örnek 4: Belirli bir müşteriden gelen tüm aramaları bul

curl "https://api.wespoke.ai/api/v1/calls?callerNumber=%2B905559876543&sortBy=startTime&sortOrder=desc" \
  -H "Authorization: Bearer YOUR_API_KEY"

İpucu

Tüm filtre parametreleri birlikte kullanılabilir. API otomatik olarak tüm kriterleri karşılayan aramaları getirecektir (AND mantığı). Daha karmaşık sorgular için (OR mantığı), birden fazla API çağrısı yapıp sonuçları birleştirmeniz gerekebilir.

Giden Arama Başlat Telefon Numaraları

İçindekiler