Wespoke
Dokümantasyon

Kampanyayı Başlat

Kampanyayı başlatın veya duraklatılmış kampanyayı devam ettirin

Endpoint

POST/api/v1/campaigns/:id/start

PENDING durumundaki kampanyayı başlatır veya PAUSED durumundaki kampanyayı devam ettirir.

Path Parameters

idzorunlu

Kampanya ID'si

Örnek İstek

cURL
curl -X POST "https://api.wespoke.ai/api/v1/campaigns/camp_abc123/start" \
  -H "Authorization: Bearer YOUR_API_KEY" \
  -H "Content-Type: application/json"

Örnek Yanıt

200 OK
{
  "success": true,
  "data": {
    "campaign": {
      "id": "camp_abc123",
      "name": "Yaz Kampanyası 2025",
      "status": "RUNNING",
      "phoneNumberId": "phone_123abc",
      "assistantId": "asst_456def",
      "userId": "user_xyz",
      "totalContacts": 1000,
      "successfulCalls": 0,
      "failedCalls": 0,
      "pendingCalls": 1000,
      "metadata": {
        "department": "sales",
        "region": "istanbul"
      },
      "createdAt": "2025-01-20T10:00:00Z",
      "updatedAt": "2025-01-20T14:30:00Z",
      "startedAt": "2025-01-20T14:30:00Z",
      "completedAt": null
    },
    "message": "Campaign started successfully"
  }
}

Hata Yanıtları

404 Not Found

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

400 Bad Request - Geçersiz Durum

{
  "success": false,
  "error": {
    "message": "Campaign cannot be started. Current status: COMPLETED",
    "code": "INVALID_STATUS"
  }
}

400 Bad Request - Yetersiz Kredi

{
  "success": false,
  "error": {
    "message": "Insufficient credits to start campaign",
    "code": "INSUFFICIENT_CREDITS",
    "details": {
      "required": 75.0,
      "available": 25.0
    }
  }
}

💡Önemli Notlar

  • Kampanya PENDING veya PAUSED durumunda olmalı
  • COMPLETED veya CANCELLED kampanyalar başlatılamaz
  • startedAt alanı otomatik olarak güncellenir
  • Kampanya başlatılmadan önce yeterli kredi kontrolü yapılır
  • Başlatıldıktan sonra aramalar otomatik olarak planlanır
Kampanya AramalarıKampanyayı Duraklat