Wespoke
Dokümantasyon

Asistan Oluştur

Yeni bir ses asistanı oluşturun

Endpoint

POST/assistants

Yeni bir asistan oluşturur ve taslak olarak kaydeder

İstek Parametreleri

Temel Bilgiler

namezorunlu

Asistan adı (1-100 karakter)

systemPromptzorunlu

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 (varsayılan: "tr")

Dil Modeli (LLM) Ayarları

llmModelopsiyonel

LLM model ID'si (örn: "google/gemini-2.5-flash")

temperatureopsiyonel

LLM temperature (0-2, varsayılan: 0.1)

maxOutputTokensopsiyonel

Maksimum token sayısı (1-2000, varsayılan: 500)

Metinden Sese (TTS) Ayarları

ttsProvideropsiyonel

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

ttsModelopsiyonel

TTS model ID'si

voicezorunlu

Ses ID'si (örn: "Fahco4VZzobUeiPqni1S")

ttsSpeedopsiyonel

Konuşma hızı (0.8-1.2, varsayılan: 1.0)

ttsPitchopsiyonel

Ses tonu (-20 ile 20 arası, varsayılan: 0)

backgroundAudioEnabledopsiyonel

Arka plan sesi aktif mi (varsayılan: true)

backgroundAudioVolumeopsiyonel

Arka plan ses seviyesi (0.0-1.0, varsayılan: 0.3)

Sessizlik Zaman Aşımı

inactivityTimeoutEnabledopsiyonel

Sessizlik zaman aşımı aktif mi (varsayılan: true)

inactivityTimeoutSecondsopsiyonel

Kullanıcı sessiz kalırsa aramayı sonlandırma süresi (5-30 saniye, varsayılan: 10)

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 (Minimal)

cURL
curl -X POST https://api.wespoke.ai/api/v1/assistants \
  -H "Authorization: Bearer YOUR_API_KEY" \
  -H "Content-Type: application/json" \
  -d '{
    "name": "Müşteri Destek Asistanı",
    "systemPrompt": "Sen yardımsever bir müşteri destek asistanısın...",
    "voice": "Fahco4VZzobUeiPqni1S"
  }'

Örnek İstek (Tüm Alanlar)

cURL
curl -X POST https://api.wespoke.ai/api/v1/assistants \
  -H "Authorization: Bearer YOUR_API_KEY" \
  -H "Content-Type: application/json" \
  -d '{
    "name": "Gelişmiş Müşteri Destek Asistanı",
    "systemPrompt": "Sen yardımsever bir müşteri destek asistanısın...",
    "greetingMessage": "Merhaba! Size nasıl yardımcı olabilirim?",
    "sttProvider": "deepgram",
    "sttModel": "nova-2",
    "language": "tr",
    "llmModel": "google/gemini-2.5-flash",
    "temperature": 0.7,
    "maxOutputTokens": 500,
    "ttsProvider": "elevenlabs",
    "ttsModel": "eleven_turbo_v2_5",
    "voice": "Fahco4VZzobUeiPqni1S",
    "ttsSpeed": 1.0,
    "ttsPitch": 0,
    "backgroundAudioEnabled": true,
    "backgroundAudioVolume": 0.3,
    "inactivityTimeoutEnabled": true,
    "inactivityTimeoutSeconds": 10,
    "crmLookupMode": "pre-call",
    "crmToolId": "tool_abc123",
    "requireVerification": false,
    "testPhoneNumber": "+905001234567",
    "toolIds": ["tool_123", "tool_456"],
    "knowledgeBaseIds": ["kb_789", "kb_012"]
  }'

Yanıt

201 Created
{
  "success": true,
  "data": {
    "id": "cm1234567890",
    "name": "Müşteri Destek Asistanı",
    "userId": "user_123",
    "currentVersion": 0,
    "lastPublishedAt": null,
    "testPhoneNumber": null,
    "draftSystemPrompt": "Sen yardımsever bir müşteri destek asistanısın...",
    "draftGreetingMessage": "Merhaba! Size nasıl yardımcı olabilirim?",
    "draftVoice": "Fahco4VZzobUeiPqni1S",
    "draftLanguage": "tr",
    "draftTemperature": 0.7,
    "draftMaxOutputTokens": 500,
    "draftBackgroundAudioEnabled": true,
    "draftBackgroundAudioVolume": 0.3,
    "draftInactivityTimeoutEnabled": true,
    "draftInactivityTimeoutSeconds": 10,
    "draftToolIds": [],
    "draftKnowledgeBaseIds": [],
    "createdAt": "2025-01-18T15:30:00Z",
    "updatedAt": "2025-01-18T15:30:00Z"
  }
}
Asistan DetayıAsistan Güncelle