Wespoke
Dokümantasyon

Aktarım Bağlantıları

Asistanlar arası aktarım (handoff) bağlantılarını yönetin

Aktarım Nedir?

Aktarım (handoff), bir asistanın görüşmeyi başka bir asistana devretmesini sağlar. Örneğin, karşılama asistanı teknik sorunları tespit ettiğinde görüşmeyi teknik destek asistanına aktarabilir.

Aktarım Ekle

Endpoint

POST/api/v1/squads/:id/handoffs

İki üye arasında yeni bir aktarım bağlantısı oluşturur

İstek Gövdesi

fromMemberIdzorunlu

Aktarımı başlatan üye ID'si

toMemberIdzorunlu

Aktarımın hedef üye ID'si

descriptionzorunlu

Aktarımın ne zaman yapılacağını açıklayan metin. LLM bu açıklamayı kullanarak aktarım kararı verir.

contextModeopsiyonel

Bağlam aktarım modu: ALL (tüm geçmiş), LAST_N (son N mesaj), NONE (bağlam yok). Varsayılan: ALL

contextLastNopsiyonel

contextMode=LAST_N olduğunda aktarılacak mesaj sayısı

transferMessageopsiyonel

Aktarım sırasında kullanıcıya söylenecek mesaj

variableExtractionPlanopsiyonel

Aktarım öncesi çıkarılacak değişkenler planı (JSON)

asyncopsiyonel

Asenkron aktarım mı? (varsayılan: false)

Örnek İstek

cURL
curl -X POST https://api.wespoke.ai/api/v1/squads/sqd_123/handoffs \
  -H "Authorization: Bearer YOUR_API_KEY" \
  -H "Content-Type: application/json" \
  -d '{
    "fromMemberId": "mbr_111",
    "toMemberId": "mbr_222",
    "description": "Müşteri teknik bir sorun bildirdiğinde veya teknik destek istediğinde",
    "contextMode": "ALL",
    "transferMessage": "Sizi teknik destek ekibimize aktarıyorum, lütfen bekleyin."
  }'

Aktarım Güncelle

Endpoint

PATCH/api/v1/squads/:id/handoffs/:handoffId

Mevcut bir aktarım bağlantısını günceller

İstek Gövdesi

descriptionopsiyonel

Aktarım açıklaması

contextModeopsiyonel

Bağlam aktarım modu

contextLastNopsiyonel

Son N mesaj sayısı

transferMessageopsiyonel

Aktarım mesajı (null ile temizlenebilir)

variableExtractionPlanopsiyonel

Değişken çıkarım planı (null ile temizlenebilir)

asyncopsiyonel

Asenkron aktarım durumu

Örnek İstek

cURL
curl -X PATCH https://api.wespoke.ai/api/v1/squads/sqd_123/handoffs/hnd_999 \
  -H "Authorization: Bearer YOUR_API_KEY" \
  -H "Content-Type: application/json" \
  -d '{
    "contextMode": "LAST_N",
    "contextLastN": 10,
    "transferMessage": "Sizi ilgili departmana yönlendiriyorum."
  }'

Aktarım Sil

Endpoint

DELETE/api/v1/squads/:id/handoffs/:handoffId

Bir aktarım bağlantısını siler

Örnek İstek

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

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

200/201 OK
{
  "success": true,
  "data": {
    "id": "sqd_123",
    "name": "Müşteri Destek Ekibi",
    "members": [...],
    "handoffs": [
      {
        "id": "hnd_999",
        "fromMemberId": "mbr_111",
        "toMemberId": "mbr_222",
        "description": "Müşteri teknik bir sorun bildirdiğinde",
        "contextMode": "ALL",
        "contextLastN": null,
        "transferMessage": "Sizi teknik destek ekibimize aktarıyorum",
        "variableExtractionPlan": null,
        "async": false
      }
    ]
  }
}

Hata Yanıtları

400 - Geçersiz Üyeler
{
  "success": false,
  "error": {
    "message": "Both members must belong to this squad",
    "code": "INVALID_MEMBERS"
  }
}
404 - Aktarım Bulunamadı
{
  "success": false,
  "error": {
    "message": "Handoff not found in this squad",
    "code": "HANDOFF_NOT_FOUND"
  }
}

Bağlam Modları

ALL

Tüm konuşma geçmişi hedef asistana aktarılır. Tam bağlam için kullanışlıdır.

LAST_N

Sadece son N mesaj aktarılır. contextLastN ile birlikte kullanılır.

NONE

Bağlam aktarılmaz. Hedef asistan temiz bir sayfa ile başlar.

ÜyelerEkipler