Wespoke
Dokümantasyon

Araçlar (Tools)

Asistanlarınızı API çağrıları, veritabanı sorguları ve özel iş akışlarıyla güçlendirin

Araç Nedir?

Araçlar, AI asistanınızın konuşma sırasında gerçekleştirebileceği özel eylemlerdir. Araçlar sayesinde asistanınız harici API'lere istek gönderebilir, veritabanlarını sorgulayabilir, bilgi alabilir ve işlemler gerçekleştirebilir. Bu, asistanınızı basit bir sohbet botundan güçlü bir iş otomasyonu aracına dönüştürür.

Araç Türleri

API İstekleri

Harici REST API'lere HTTP istekleri gönderin. CRM sistemlerinizden müşteri bilgilerini alın, rezervasyon sistemlerinize erişin veya üçüncü parti hizmetlerle entegre olun.

Veritabanı Sorguları

Kendi veritabanlarınıza doğrudan SQL sorguları gönderin. Müşteri kayıtlarını arayın, stok durumunu kontrol edin veya sipariş bilgilerini getirin.

Workflow URL

Make.com, Zapier veya n8n gibi iş akışı platformlarındaki özel akışlarınızı tetikleyin. Karmaşık çok adımlı süreçleri otomatikleştirin.

Araç Oluşturma

Yeni bir araç oluşturmak için:

  1. 1

    Araçlar Sayfasına Gidin

    Kontrol panelinde "Araçlar" bölümüne gidin

  2. 2

    "Yeni Araç" Butonuna Tıklayın

    Sağ üst köşedeki "Yeni Araç" butonuna tıklayın

  3. 3

    Temel Bilgileri Doldurun

    Aracınıza bir isim verin ve açıklama ekleyin

  4. 4

    Araç Türünü Seçin

    API isteği, veritabanı sorgusu veya workflow URL seçin

  5. 5

    Yapılandırmayı Tamamlayın

    Seçtiğiniz araç türüne göre gerekli ayarları yapın

API İsteği Aracı Yapılandırması

URL

İstek gönderilecek API endpoint'i

https://api.example.com/customers/search

HTTP Metodu

GET, POST, PUT, DELETE veya PATCH seçeneklerinden birini seçin

Headers (Başlıklar)

Authorization, Content-Type ve özel başlıklar ekleyin

Authorization: Bearer your-api-keyContent-Type: application/json

Parametreler

AI'ın konuşma sırasında doldurması gereken parametreleri tanımlayın. Her parametre için isim, tip (string, number, boolean) ve açıklama belirtin.

Request Body (İstek Gövdesi)

POST/PUT istekleri için JSON formatında body template'i

{
  "query": "{{searchTerm}}",
  "limit": 10
}

Veritabanı Sorgusu Aracı

Veritabanı Bağlantısı

PostgreSQL, MySQL veya diğer desteklenen veritabanlarına bağlanın. Connection string'inizi güvenli bir şekilde saklayın.

SQL Sorgusu

Çalıştırılacak SQL sorgusunu yazın. Parametreler için placeholder'lar kullanın.

SELECT * FROM customers
WHERE phone = {{phoneNumber}}
LIMIT 1

⚠️ Güvenlik Uyarısı

Sadece okuma (SELECT) sorguları kullanmanız önerilir. INSERT, UPDATE, DELETE gibi yazma işlemleri için API endpoint'leri kullanın.

Workflow URL Aracı

Workflow URL araçları, Make.com, Zapier veya n8n gibi platformlarda oluşturduğunuz otomasyonları tetiklemenize olanak tanır.

Webhook URL

İş akışı platformunuzdan aldığınız webhook URL'ini girin

https://hook.make.com/xxxxxxxxxxxxx

Parametreler

Workflow'a gönderilecek parametreleri tanımlayın. Bu parametreler AI tarafından konuşmadan çıkarılacak ve webhook'a JSON olarak gönderilecektir.

💡 İpucu

Workflow platformunuzda test verileri ile webhook'u test edin. Ardından Wespoke'ta aracı test ederek parametrelerin doğru gönderildiğinden emin olun.

Araçları Asistanlara Ekleme

Oluşturduğunuz araçları asistanlarınıza eklemek için:

  1. 1.Asistan düzenleme sayfasına gidin
  2. 2."Araçlar" bölümünde kullanılabilir araçları görün
  3. 3.Eklemek istediğiniz araçları seçin
  4. 4.Değişiklikleri kaydedin ve yayınlayın

Araç Testi

Araçlarınızı canlıya almadan önce test etmeniz önerilir:

Araç Test Arayüzü

Her aracın detay sayfasında "Test Et" butonu bulunur. Parametreleri manuel olarak girerek aracı test edebilirsiniz.

Asistan Test Modu

Asistanınızı test ederken araçlarınız da otomatik olarak test edilir. Konuşma sırasında aracın nasıl tetiklendiğini görebilirsiniz.

Kullanım Senaryoları

🏥 Randevu Yönetimi

Müsait randevu saatlerini sorgula, randevu oluştur, iptal et veya güncelle

🛒 E-ticaret Destek

Sipariş durumunu sorgula, ürün stok bilgisini kontrol et, fiyat bilgisi ver

👤 CRM Entegrasyonu

Müşteri bilgilerini getir, notlar ekle, ticket oluştur

🏨 Otel Rezervasyon

Oda müsaitliği kontrol et, fiyat hesapla, rezervasyon yap

📧 Bildirim Gönderimi

E-posta gönder, SMS at, bildirim oluştur

Araçlarınızı Oluşturmaya Başlayın

Asistanlarınızı güçlü araçlarla donatın ve gerçek iş değeri yaratın.

Araçlarınızı YönetinAPI Dokümantasyonu