Wespoke
Dokümantasyon

Kampanya Aramaları

Kampanyaya ait tüm aramaları detaylı olarak listeleyin

Endpoint

GET/api/v1/campaigns/:id/calls

Kampanyaya ait tüm aramaları sayfalama ile listeleyin.

Path Parameters

idzorunlu

Kampanya ID'si

Query Parameters

pageopsiyonel

Sayfa numarası (varsayılan: 1)

limitopsiyonel

Sayfa başına sonuç sayısı (varsayılan: 50, maksimum: 200)

Örnek İstek

cURL
curl -X GET "https://api.wespoke.ai/api/v1/campaigns/camp_abc123/calls?page=1&limit=50" \
  -H "Authorization: Bearer YOUR_API_KEY"

Örnek Yanıt

200 OK
{
  "success": true,
  "data": {
    "calls": [
      {
        "id": "call_abc123",
        "campaignId": "camp_abc123",
        "contactId": "contact_1",
        "phoneNumber": "+905551234567",
        "contactName": "Ahmet Yılmaz",
        "status": "completed",
        "duration": 185,
        "cost": 0.16,
        "endReason": "assistant-hangup",
        "startedAt": "2025-01-20T11:05:00Z",
        "endedAt": "2025-01-20T11:08:05Z",
        "recordingUrl": "https://storage.wespoke.ai/recordings/call_abc123.mp3",
        "transcript": "Kısa özet...",
        "assistantId": "asst_456def",
        "phoneNumberId": "phone_123abc"
      },
      {
        "id": "call_def456",
        "campaignId": "camp_abc123",
        "contactId": "contact_2",
        "phoneNumber": "+905559876543",
        "contactName": "Ayşe Demir",
        "status": "completed",
        "duration": 210,
        "cost": 0.18,
        "endReason": "client-hangup",
        "startedAt": "2025-01-20T11:10:00Z",
        "endedAt": "2025-01-20T11:13:30Z",
        "recordingUrl": "https://storage.wespoke.ai/recordings/call_def456.mp3",
        "transcript": "Kısa özet...",
        "assistantId": "asst_456def",
        "phoneNumberId": "phone_123abc"
      }
    ],
    "pagination": {
      "page": 1,
      "limit": 50,
      "totalPages": 10,
      "totalCalls": 450,
      "hasNextPage": true,
      "hasPreviousPage": false
    },
    "summary": {
      "totalCalls": 450,
      "totalDuration": 81000,
      "totalCost": 72.5,
      "averageDuration": 180,
      "averageCost": 0.16
    }
  }
}

Yanıt Alanları

calls

Kampanyaya ait aramalar listesi

duration

Arama süresi (saniye cinsinden)

endReason

Aramanın sonlanma nedeni (assistant-hangup, client-hangup, error, vb.)

summary

Tüm aramalar için toplam ve ortalama istatistikler

Hata Yanıtları

404 Not Found

{
  "success": false,
  "error": {
    "message": "Campaign not found",
    "code": "CAMPAIGN_NOT_FOUND"
  }
}

💡Önemli Notlar

  • Aramalar en yeni başlayandan en eskiye doğru sıralanır
  • recordingUrl alanı kayıt varsa döndürülür
  • transcript alanı tam transkripti içerir
  • summary tüm kampanya aramaları için toplam istatistikleri içerir
  • Maksimum sayfa boyutu 200 aramadır
Bütçe TahminiKampanyayı Başlat