Wespoke
Dokümantasyon

Ekip Üyeleri

Ekibe asistan ekleme, güncelleme veya çıkarma işlemleri

Üye Ekle

Endpoint

POST/api/v1/squads/:id/members

Ekibe yeni bir asistan üye ekler

İstek Gövdesi

assistantIdzorunlu

Eklenecek asistan ID'si

descriptionopsiyonel

Üye açıklaması/rolü

isStartMemberopsiyonel

Başlangıç üyesi mi? (varsayılan: false)

overridesopsiyonel

Üye düzeyinde geçersiz kılmalar (llmModel, voice vb.)

positionopsiyonel

Sıra numarası (varsayılan: son sıra)

Örnek İstek

cURL
curl -X POST https://api.wespoke.ai/api/v1/squads/sqd_123/members \
  -H "Authorization: Bearer YOUR_API_KEY" \
  -H "Content-Type: application/json" \
  -d '{
    "assistantId": "ast_456",
    "description": "Satış asistanı",
    "isStartMember": false,
    "overrides": {
      "temperature": 0.8
    }
  }'

Üye Güncelle

Endpoint

PATCH/api/v1/squads/:id/members/:memberId

Mevcut bir üyenin bilgilerini günceller

İstek Gövdesi

descriptionopsiyonel

Üye açıklaması (null ile temizlenebilir)

isStartMemberopsiyonel

Başlangıç üyesi durumu

overridesopsiyonel

Üye düzeyinde geçersiz kılmalar (null ile temizlenebilir)

positionopsiyonel

Sıra numarası

Örnek İstek

cURL
curl -X PATCH https://api.wespoke.ai/api/v1/squads/sqd_123/members/mbr_789 \
  -H "Authorization: Bearer YOUR_API_KEY" \
  -H "Content-Type: application/json" \
  -d '{
    "isStartMember": true,
    "description": "Ana karşılama asistanı"
  }'

Üye Sil

Endpoint

DELETE/api/v1/squads/:id/members/:memberId

Bir üyeyi ekipten çıkarır

Örnek İstek

cURL
curl -X DELETE https://api.wespoke.ai/api/v1/squads/sqd_123/members/mbr_789 \
  -H "Authorization: Bearer YOUR_API_KEY"

Notlar

  • Üye silindiğinde, bu üyeyle ilişkili aktarım bağlantıları da silinir
  • Asistanın kendisi silinmez, sadece ekipten çıkarılır
  • Tüm endpoint'ler güncellenmiş ekip verisini döndürür

Yanıt Örneği (Tüm Endpoint'ler)

200/201 OK
{
  "success": true,
  "data": {
    "id": "sqd_123",
    "name": "Müşteri Destek Ekibi",
    "members": [
      {
        "id": "mbr_111",
        "assistantId": "ast_aaa",
        "position": 0,
        "description": "Ana karşılama asistanı",
        "isStartMember": true,
        "overrides": null,
        "assistant": {
          "id": "ast_aaa",
          "name": "Karşılama Botu"
        }
      }
    ],
    "handoffs": [...]
  }
}

Hata Yanıtları

404 - Üye Bulunamadı
{
  "success": false,
  "error": {
    "message": "Member not found in this squad",
    "code": "MEMBER_NOT_FOUND"
  }
}
404 - Ekip Bulunamadı
{
  "success": false,
  "error": {
    "message": "Squad not found",
    "code": "NOT_FOUND"
  }
}
SilAktarımlar