Wespoke
Dokümantasyon

Asistan Güncelle

Mevcut bir asistanı güncelleyin (taslak olarak kaydedilir)

Endpoint

PATCH/api/v1/assistants/:id

Asistanı günceller ve taslak olarak kaydeder. Yayınlamak için publish endpoint'ini kullanın.

URL Parametreleri

idzorunlu

Güncellenecek asistan ID'si

İstek Parametreleri

Tüm alanlar opsiyoneldir. Sadece güncellemek istediğiniz alanları gönderin.

Temel Bilgiler

nameopsiyonel

Asistan adı (1-100 karakter)

systemPromptopsiyonel

Asistan sistem promptu

greetingMessageopsiyonel

İlk karşılama mesajı

Konuşmadan Metne (STT) Ayarları

sttProvideropsiyonel

STT sağlayıcı: "deepgram", "gladia", "google"

sttModelopsiyonel

STT model ID'si

languageopsiyonel

Dil kodu

Dil Modeli (LLM) Ayarları

llmModelopsiyonel

LLM model ID'si

temperatureopsiyonel

LLM temperature (0-2)

maxOutputTokensopsiyonel

Maksimum token sayısı (1-2000)

Metinden Sese (TTS) Ayarları

ttsProvideropsiyonel

TTS sağlayıcı: "elevenlabs", "azure", "cartesia"

ttsModelopsiyonel

TTS model ID'si

voiceopsiyonel

Ses ID'si

ttsSpeedopsiyonel

Konuşma hızı (0.8-1.2)

ttsPitchopsiyonel

Ses tonu (-20 ile 20 arası)

backgroundAudioEnabledopsiyonel

Arka plan sesi aktif mi

backgroundAudioVolumeopsiyonel

Arka plan ses seviyesi (0.0-1.0)

Sessizlik Zaman Aşımı

inactivityTimeoutEnabledopsiyonel

Sessizlik zaman aşımı aktif mi

inactivityTimeoutSecondsopsiyonel

Kullanıcı sessiz kalırsa aramayı sonlandırma süresi (5-30 saniye)

CRM Ayarları

crmLookupModeopsiyonel

CRM sorgulama modu: "disabled", "pre-call"

crmToolIdopsiyonel

CRM aracı ID'si

requireVerificationopsiyonel

Kimlik doğrulama gerekli mi

testPhoneNumberopsiyonel

Test telefon numarası

İlişkilendirmeler

toolIdsopsiyonel

Araç ID'leri dizisi

knowledgeBaseIdsopsiyonel

Bilgi bankası ID'leri dizisi

Örnek İstek (Kısmi Güncelleme)

cURL
curl -X PATCH https://api.wespoke.ai/api/v1/assistants/cm1234567890 \
  -H "Authorization: Bearer YOUR_API_KEY" \
  -H "Content-Type: application/json" \
  -d '{
    "name": "Gelişmiş Müşteri Destek Asistanı",
    "temperature": 0.8,
    "ttsSpeed": 1.1
  }'

Örnek İstek (Çoklu Alan Güncelleme)

cURL
curl -X PATCH https://api.wespoke.ai/api/v1/assistants/cm1234567890 \
  -H "Authorization: Bearer YOUR_API_KEY" \
  -H "Content-Type: application/json" \
  -d '{
    "systemPrompt": "Sen çok yardımsever ve bilgili bir müşteri destek asistanısın...",
    "llmModel": "google/gemini-2.5-flash",
    "temperature": 0.8,
    "ttsSpeed": 1.1,
    "backgroundAudioVolume": 0.5,
    "crmLookupMode": "pre-call",
    "toolIds": ["tool_123", "tool_456", "tool_789"]
  }'

Yanıt

200 OK
{
  "success": true,
  "data": {
    "id": "cm1234567890",
    "name": "Gelişmiş Müşteri Destek Asistanı",
    "userId": "user_123",
    "currentVersion": 0,
    "lastPublishedAt": null,
    "testPhoneNumber": null,
    "draftSystemPrompt": "Sen çok yardımsever ve bilgili bir müşteri destek asistanısın...",
    "draftGreetingMessage": "Merhaba! Size nasıl yardımcı olabilirim?",
    "draftVoice": "Fahco4VZzobUeiPqni1S",
    "draftLanguage": "tr",
    "draftTemperature": 0.8,
    "draftMaxOutputTokens": 500,
    "draftBackgroundAudioEnabled": true,
    "draftBackgroundAudioVolume": 0.3,
    "createdAt": "2025-01-18T15:30:00Z",
    "updatedAt": "2025-01-18T15:45:00Z"
  }
}

ℹ️Taslak vs Yayınlama

Güncelleme işlemi asistanı taslak olarak kaydeder. Test aramalarında taslak değerler kullanılır.

Değişikliklerin gerçek aramalarda kullanılması için yayınlamanız gerekir:

Publish Endpoint
curl -X POST https://api.wespoke.ai/api/v1/assistants/cm1234567890/publish \
  -H "Authorization: Bearer YOUR_API_KEY"

Yayınlama işlemi yeni bir versiyon oluşturur ve currentVersion numarasını artırır.

Asistan OluşturAramalar