Kampanyayı İptal Et

Kampanyayı kalıcı olarak iptal edin. Bu işlem geri alınamaz.

Endpoint

POST/api/v1/campaigns/:id/cancel

Kampanyayı kalıcı olarak iptal eder. Devam eden aramalar tamamlanır, bekleyen aramalar iptal edilir.

Path Parameters

idzorunlu

Kampanya ID'si

Örnek İstek

cURL
curl -X POST "https://api.wespoke.ai/api/v1/campaigns/camp_abc123/cancel" \
  -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": "CANCELLED",
      "phoneNumberId": "phone_123abc",
      "assistantId": "asst_456def",
      "userId": "user_xyz",
      "totalContacts": 1000,
      "successfulCalls": 450,
      "failedCalls": 50,
      "pendingCalls": 500,
      "metadata": {
        "department": "sales",
        "region": "istanbul"
      },
      "createdAt": "2025-01-20T10:00:00Z",
      "updatedAt": "2025-01-20T14:30:00Z",
      "startedAt": "2025-01-20T11:00:00Z",
      "completedAt": "2025-01-20T14:30:00Z"
    },
    "message": "Campaign cancelled successfully",
    "statistics": {
      "totalCalls": 500,
      "cancelledCalls": 500,
      "completedBeforeCancellation": 450
    }
  }
}

Hata Yanıtları

404 Not Found

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

400 Bad Request - Zaten İptal Edilmiş

{
  "success": false,
  "error": {
    "message": "Campaign is already cancelled",
    "code": "ALREADY_CANCELLED"
  }
}

400 Bad Request - Zaten Tamamlanmış

{
  "success": false,
  "error": {
    "message": "Campaign is already completed",
    "code": "ALREADY_COMPLETED"
  }
}

⚠️Dikkat

  • Bu işlem geri alınamaz!
  • İptal edilen kampanya tekrar başlatılamaz
  • Devam eden aramalar tamamlanır ancak yeni aramalar başlatılmaz
  • Bekleyen tüm aramalar iptal edilir
  • completedAt alanı iptal zamanını gösterir

💡Önemli Notlar

  • PENDING, RUNNING veya PAUSED kampanyalar iptal edilebilir
  • COMPLETED veya zaten CANCELLED kampanyalar iptal edilemez
  • İptal sonrası istatistikler ve kayıtlar korunur
  • Tamamlanan aramalar için ücretlendirme yapılmıştır
  • Geçici duraklatma için /pause endpoint'ini kullanın