Wespoke
Dökümantasyon

Emergency Stop

Telefon numarasını acil olarak devre dışı bırakın veya yeniden etkinleştirin

🚨Emergency Stop Nedir?

Emergency Stop, bir telefon numarasını hızlı bir şekilde devre dışı bırakmanızı sağlar.Bu özellik acil durumlarda kullanılır ve şu durumlarda faydalıdır:

  • • Asistan hatalı davranıyor ve hemen durdurulması gerekiyor
  • • Beklenmeyen yüksek arama hacmi ile karşılaşıldı
  • • Geçici olarak tüm aramaları durdurmak istiyorsunuz
  • • Bakım/güncelleme yapılacak

Önemli: Emergency Stop geri alınabilir!Kalıcı silme işleminden farklıdır.

Endpoint

POST/phone-numbers/:id/emergency-stop

Telefon numarasını acil olarak devre dışı bırakır veya yeniden etkinleştirir.

Yol Parametreleri

idstring (required)

Telefon numarasının kimliği

İstek Gövdesi

enabledboolean (optional)

<code>false</code>: Emergency stop aktif et (varsayılan)<br/> <code>true</code>: Emergency stop'u kaldır, numarayı yeniden etkinleştir

reasonstring (optional)

Durdurma sebebi (log için)

İstek Örnekleri

Emergency Stop Aktifleştir
curl -X POST https://api.wespoke.ai/api/v1/phone-numbers/ph_1234567890/emergency-stop \
  -H "Authorization: Bearer YOUR_API_KEY" \
  -H "Content-Type: application/json" \
  -d '{
    "enabled": false,
    "reason": "Assistant is behaving unexpectedly"
  }'
Emergency Stop Kaldır (Yeniden Etkinleştir)
curl -X POST https://api.wespoke.ai/api/v1/phone-numbers/ph_1234567890/emergency-stop \
  -H "Authorization: Bearer YOUR_API_KEY" \
  -H "Content-Type: application/json" \
  -d '{
    "enabled": true,
    "reason": "Issue resolved, number reactivated"
  }'
Hızlı Emergency Stop (Gövde Olmadan)
# Disables the number by default
curl -X POST https://api.wespoke.ai/api/v1/phone-numbers/ph_1234567890/emergency-stop \
  -H "Authorization: Bearer YOUR_API_KEY"

Yanıt Örnekleri

200 OK - Emergency Stop Aktif
{
  "id": "ph_1234567890",
  "number": "+905551234567",
  "displayName": "Customer Service Line",
  "provider": "verimor",
  "status": "emergency_stop",
  "assignedAssistantId": "ast_9876543210",
  "assignedAssistantName": "Customer Support Assistant",
  "sipConfig": {
    "username": "user123",
    "domain": "sip.verimor.com.tr",
    "enabled": false,
    "registrationStatus": "unregistered"
  },
  "emergencyStop": {
    "active": true,
    "reason": "Assistant is behaving unexpectedly",
    "activatedAt": "2025-02-15T17:30:00Z",
    "activatedBy": "user_api_key_123"
  },
  "updatedAt": "2025-02-15T17:30:00Z"
}
200 OK - Emergency Stop Kaldırıldı
{
  "id": "ph_1234567890",
  "number": "+905551234567",
  "displayName": "Customer Service Line",
  "provider": "verimor",
  "status": "active",
  "assignedAssistantId": "ast_9876543210",
  "assignedAssistantName": "Customer Support Assistant",
  "sipConfig": {
    "username": "user123",
    "domain": "sip.verimor.com.tr",
    "enabled": true,
    "registrationStatus": "registered"
  },
  "emergencyStop": {
    "active": false,
    "reason": "Issue resolved, number reactivated",
    "deactivatedAt": "2025-02-15T18:00:00Z",
    "deactivatedBy": "user_api_key_123"
  },
  "updatedAt": "2025-02-15T18:00:00Z"
}

Emergency Stop Aktifken Ne Olur?

•
SIP Kaydı: Otomatik olarak iptal edilir
•
Gelen Aramalar: Yanıt verilmez, arayan meşgul tonu duyar
•
Aktif Aramalar: Devam eden aramalar sonlandırılır
•
Asistan Ataması: Korunur, ancak çağrılmaz
•
Numara Durumu: <code>emergency_stop</code> olarak işaretlenir

Hata Yanıtları

404 Not Found
{
  "error": "Phone number not found",
  "message": "The requested phone number does not exist"
}
400 Bad Request
{
  "error": "Invalid request",
  "message": "enabled field must be a boolean value"
}

💡Kullanım Senaryoları

Senaryo 1: Hatalı Asistan

Asistan müşterilere yanlış bilgi veriyor → Emergency stop aktif →Asistanı düzelt → Emergency stop kaldır

Senaryo 2: Yüksek Arama Hacmi

Beklenmedik şekilde çok fazla arama geliyor → Emergency stop aktif →Durumu analiz et → Kapasite artır → Emergency stop kaldır

Senaryo 3: Planlı Bakım

Sistem güncellemesi yapılacak → Emergency stop aktif →Güncelleme yap → Test et → Emergency stop kaldır

✓En İyi Pratikler

  • • Her zaman reason parametresi ile sebep belirtin
  • • Emergency stop'u uzun süre aktif bırakmayın
  • • Yeniden etkinleştirmeden önce sorunu çözdüğünüzden emin olun
  • • Emergency stop loglarını düzenli inceleyin
  • • Kritik numaralar için izleme ve uyarı sistemleri kurun
Numara SilmeWebhooks