Skip to main content
Sesvia Tool’ları, herhangi bir herkese açık HTTP API’yi çağırabilir. Doğru yapılandırıldığında asistanınız, görüşme sırasında gerçek zamanlı veri alıp müşteriye sözlü olarak aktarabilir.

​
Uyumlu bir API endpoint’inin gereksinimleri

Sesvia yalnızca HTTPS üzerinden erişilebilen endpoint’lere istek gönderebilir. HTTP endpoint’leri desteklenmez.
Sesvia Tool’larıyla kullanacağınız API endpoint’i şu koşulları karşılamalıdır:
GereksinimAçıklama
HTTPSEndpoint https:// ile başlamalıdır
JSON isteğiPOST isteklerinde JSON gövdesi kabul etmeli; GET isteklerinde sorgu parametresi desteklemeli
JSON yanıtıYanıt JSON formatında dönmelidir
Kısa yanıtAI yanıtı sesli olarak okuyacağından, yanıt içeriği özlü ve insanın anlayabileceği dilde olmalıdır

​
Tool yapılandırma örneği

Aşağıda bir sipariş durumu sorgulayan Tool’un tam yapılandırması verilmiştir: 
{
  "name": "siparis_durumu",
  "description": "Müşterinin sipariş durumunu öğrenir",
  "method": "GET",
  "url": "https://api.yourbusiness.com/orders/status",
  "headers": {
    "Authorization": "Bearer YOUR_API_KEY"
  },
  "parameters": {
    "order_id": {
      "type": "string",
      "description": "Müşterinin sipariş numarası"
    }
  }
}

​
Kimlik doğrulama yapılandırması

API’nize güvenli erişim sağlamak için Tool’un Başlıklar (Headers) alanını kullanın.
1

Bearer token ile kimlik doğrulama

Authorization başlığını aşağıdaki formatta ekleyin:
{
  "Authorization": "Bearer YOUR_API_TOKEN"
}
2

Özel başlık ile API anahtarı

API’niz özel bir başlık bekliyorsa aynı şekilde tanımlayın:
{
  "X-Api-Key": "YOUR_API_KEY"
}
3

Basic Auth ile kimlik doğrulama

Kullanıcı adı ve şifreyi kullanici_adi:sifre biçiminde Base64 ile kodlayın, ardından Authorization başlığına ekleyin:
{
  "Authorization": "Basic dXNlcm5hbWU6cGFzc3dvcmQ="
}

​
Sesli kullanım için API yanıtı tasarlama

Asistanınız, API’den dönen yanıtı yorumlayarak müşteriye sesli olarak aktarır. Yanıtınızı buna göre tasarlayın.
Yanıtınıza message veya result gibi insan dilinde yazılmış bir alan ekleyin. Asistan bu alanı doğrudan okuyabilir ve müşteriye doğal bir yanıt verebilir.
İyi tasarlanmış bir yanıt örneği: 
{
  "message": "Siparişiniz kargoya verildi, tahmini teslimat 3 iş günü."
}
Kaçınılması gereken yanıt yapısı: 
{
  "order_id": "ORD-9921",
  "status_code": 4,
  "updated_at": "2024-01-15T08:22:11.443Z",
  "carrier_id": 7
}
İkinci örnekteki gibi ham veri döndürmek yerine, asistanın müşteriye aktarabileceği anlamlı bir metin hazırlayın.

​
Tool’u canlıya almadan önce test etme

1

Tool'u kaydedin

Tool yapılandırmanızı tamamlayıp Kaydet düğmesine tıklayın.
2

Test Et düğmesini kullanın

Tool listesinde ilgili Tool’un yanındaki Test Et seçeneğine tıklayın. Gerekli parametreleri girin ve isteği gönderin.
3

Yanıtı doğrulayın

Dönen yanıtın beklediğiniz formatta ve içerikte olduğunu kontrol edin. Hata alırsanız URL, başlık veya parametre yapılandırmanızı gözden geçirin.
4

Asistanı test çağrısıyla deneyin

Bir test görüşmesi başlatın ve asistanın doğru bağlamda Tool’u tetikleyip müşteriye anlamlı bir yanıt verdiğini onaylayın.