Wespoke
Documentation

Asistan Oluştur

Yeni bir ses asistanı oluşturun

Endpoint

POST/assistants

Yeni bir asistan oluşturur ve taslak olarak kaydeder

İstek Parametreleri

Basic Information

namerequired

Asistan adı (1-100 karakter)

systemPromptrequired

Assistant system prompt

greetingMessageoptional

İlk karşılama mesajı

Konuşmadan Metne (STT) Ayarları

sttProvideroptional

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

sttModeloptional

STT model ID

languageoptional

Dil kodu (varsayılan: "tr")

Dil Modeli (LLM) Ayarları

llmModeloptional

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

temperatureoptional

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

maxOutputTokensoptional

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

Metinden Sese (TTS) Ayarları

ttsProvideroptional

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

ttsModeloptional

TTS model ID

voicerequired

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

ttsSpeedoptional

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

ttsPitchoptional

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

backgroundAudioEnabledoptional

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

backgroundAudioVolumeoptional

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

Sessizlik Zaman Aşımı

inactivityTimeoutEnabledoptional

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

inactivityTimeoutSecondsoptional

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

CRM Ayarları

crmLookupModeoptional

CRM lookup mode: "disabled", "pre-call"

crmToolIdoptional

CRM aracı ID'si

requireVerificationoptional

Kimlik doğrulama gerekli mi

testPhoneNumberoptional

Test telefon numarası

İlişkilendirmeler

toolIdsoptional

Araç ID'leri dizisi

knowledgeBaseIdsoptional

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": "Customer Support Assistant",
    "systemPrompt": "You are a helpful customer support assistant...",
    "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": "Advanced Customer Support Assistant",
    "systemPrompt": "You are a helpful customer support assistant...",
    "greetingMessage": "Hello! How can I help you?",
    "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": "Customer Support Assistant",
    "userId": "user_123",
    "currentVersion": 0,
    "lastPublishedAt": null,
    "testPhoneNumber": null,
    "draftSystemPrompt": "You are a helpful customer support assistant...",
    "draftGreetingMessage": "Hello! How can I help you?",
    "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