Wespoke
Dokümantasyon

Bütçe Tahmini

Kampanya maliyetini önceden tahmin edin ve bütçe planlayın

Endpoint

GET/api/v1/campaigns/:id/budget

Kampanya için tahmini maliyet hesaplaması yapın.

Path Parameters

idzorunlu

Kampanya ID'si

Query Parameters

avgDurationopsiyonel

Tahmini ortalama arama süresi (saniye, varsayılan: 120)

Örnek İstek

cURL
curl -X GET "https://api.wespoke.ai/api/v1/campaigns/camp_abc123/budget?avgDuration=180" \
  -H "Authorization: Bearer YOUR_API_KEY"

Örnek Yanıt

200 OK
{
  "success": true,
  "data": {
    "pendingContacts": 500,
    "totalContacts": 1000,
    "estimatedCostPerCall": 0.5,
    "estimatedBudget": 250.0,
    "creditBalance": 300.0,
    "isSufficient": true,
    "shortfall": 0
  }
}

Yanıt Alanları

pendingContacts

Aranacak bekleyen kişi sayısı (PENDING + tekrar denenecek başarısızlar)

totalContacts

Kampanyadaki toplam kişi sayısı

estimatedCostPerCall

Arama başına tahmini maliyet ($0.50 per call)

estimatedBudget

Bekleyen aramalar için toplam tahmini bütçe

creditBalance

Kullanıcının mevcut kredi bakiyesi

isSufficient

Mevcut kredinin kampanyayı tamamlamak için yeterli olup olmadığı

shortfall

Eksik kredi miktarı (yeterli ise 0)

Hata Yanıtları

404 Not Found

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

💡Önemli Notlar

  • Maliyet tahmini arama başına $0.50 sabit değeri kullanır
  • pendingContacts bekleyen + tekrar denenecek başarısız aramaları içerir
  • isSufficient alanı kredi yeterlilik kontrolü için kullanılır
  • shortfall eksik kredi miktarını gösterir (yeterli ise 0)
  • Kampanya başlamadan önce bütçe kontrolü için kullanın
Kampanya İstatistikleriKampanya Aramaları