Wespoke
Dökü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: <code>ALL</code> (tüm geçmiş), <code>LAST_N</code> (son N mesaj), <code>NONE</code> (bağlam yok). Varsayılan: <code>ALL</code>

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": "When the customer reports a technical issue or requests technical support",
    "contextMode": "ALL",
    "transferMessage": "Transferring you to our technical support team, please hold."
  }'

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": "Redirecting you to the relevant department."
  }'

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&apos;ler)

200/201 OK
{
  "success": true,
  "data": {
    "id": "sqd_123",
    "name": "Customer Support Squad",
    "members": [...],
    "handoffs": [
      {
        "id": "hnd_999",
        "fromMemberId": "mbr_111",
        "toMemberId": "mbr_222",
        "description": "When the customer reports a technical issue",
        "contextMode": "ALL",
        "contextLastN": null,
        "transferMessage": "Transferring you to our technical support team",
        "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. <code>contextLastN</code> ile birlikte kullanılır.

NONE

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

ÜyelerEkipler