Kontrol panelinin yaptığı her şeyi kodunuz da yapabilir. Ajan API, WhatsApp ve Instagram'da yanıt veren motorun aynısını — aynı bilgi tabanı, aynı müşteri hafızası, aynı takvim ve katalog araçları — kendi ürününüzden çağırabileceğiniz bir REST API olarak sunar.

Tam referans ve anahtar yönetimi geliştirici portalında.

Ne zaman kullanılır

Zaten bir uygulamanız veya siteniz var ve Waslo'nun bir kanalda değil, orada yanıt vermesini istiyorsunuz.
Bir ajanssınız ve ajanı müşterileriniz için kendi markanız altında çalıştırmak istiyorsunuz.
Mesajlaşma katmanı olmadan yalnızca sınıflandırma, hafıza veya bilgi tabanı erişimini istiyorsunuz.

Sadece WhatsApp veya Instagram'da bir ajan istiyorsanız buna ihtiyacınız yok — kanalı Entegrasyonlar üzerinden bağlayın.

Tek çağrı

Bir mesaj ve bir kullanıcı kimliği gönderin; hafıza, bilgi tabanı alıntıları ve araç eylemleri uygulanmış bir yanıt alın.

curl https://api.waslo.io/v1/agent/reply \
  -H "Authorization: Bearer wsk_live_..." \
  -d '{
    "message": "Do you have a morning slot Thursday?",
    "userId": "customer_8842",
    "tools": ["calendar"]
  }'

userId sizin seçiminizdir; ajanın bir kişiyi çağrılar arasında hatırlamasını o sağlar. Aynısını kullanırsanız görüşme devam eder, değiştirirseniz yenisi başlar.

API başka neleri kapsıyor

Alan	Yapabilecekleriniz
Yanıtlar	Metin, medya (görsel, ses, video, PDF) ve sesli çıktı
Sınıflandırma	Bir mesajı tek başına HOT / WARM / COLD olarak puanlama
Hafıza	Ajanın bir kullanıcı hakkında hatırladıklarını okuma veya silme
Bilgi tabanı	Belge yükleme, listeleme, silme — panelle ortak
Katalog	Ürünler üzerinde tam CRUD — panelle ortak
Takvim	Google Calendar veya Cal.com'u panel açmadan bağlama
Yapılandırma	Sistem komutunu ve davranışı istek başına veya kalıcı ayarlama
Kullanım	Harcanan kredi, güncel bakiye, harcama tavanı

API üzerinden yüklediğiniz her şey panelde görünür, panelde eklediğiniz her şey API'den erişilebilir. İki değil, tek bir çalışma alanı.

API anahtarları

Anahtarlar geliştirici portalında oluşturulur ve bir kez gösterilir — hash'lenmiş saklandıkları için sizin adınıza kurtaramayız. Her anahtarın kapsamları vardır (agent, memory, kb, catalog, config, usage) ve anahtar yalnızca kapsamlarının izin verdiğini yapabilir. Kuruluş başına 10 etkin anahtar tutabilir, istediğiniz zaman iptal edebilirsiniz.

Anahtara parola gibi davranın: yalnızca sunucu tarafında, asla tarayıcı paketinde veya mobil uygulamada değil.

Krediler ve hız limitleri

API her planda krediyle ücretlendirilir — kanal aboneliğinizden ayrı bir üründür, dolayısıyla Growth aboneliği API çağrılarını ücretsiz yapmaz. Her çağrı daha fazla iş taşıdığı için oranlar kanal yanıtlarından yüksektir:

Olay	Kredi
Metin yanıtı	2
Araç kullanan yanıt	3
Medya okuyan yanıt	5
Sesli çıktı	+2
Sınıflandırma	1

Geliştirici planları hız limitinizi belirler ve satın aldığınızın üstüne aylık kredi tahsisi verir. Plansızsanız varsayılan dakika ve gün limitlerine düşersiniz. Kaçak bir döngünün bakiyenizi tüketmemesi için aylık harcama tavanı da koyabilirsiniz — tavana ulaşıldığında istekler spend_cap_reached ile reddedilir.

Hatalar

Her hata aynı zarfla döner ve destekle iletişimde belirtmeye değer bir request_id taşır.

Kod	Anlamı
400	İstek gövdesi doğrulamayı geçemedi
401	Eksik veya geçersiz API anahtarı
402	Yetersiz kredi ya da harcama tavanına ulaşıldı
403	Anahtarın kapsamları bu uç noktayı kapsamıyor
413	Yük çok büyük
429	Hız limiti — başlıktaki süreden sonra tekrar deneyin

Yanıtlarda Idempotency-Key başlığı gönderin; 24 saat içinde tekrarlanan çağrı iki kez ücretlendirmek yerine özgün yanıtı döndürür.

API kullanıcılarınız operatör kutusuna düşmez

API üzerinden oluşan görüşmeler, Waslo kutusunu izleyen kişiye değil, uygulamanızın kullanıcılarına aittir — bu yüzden Müşteriler ve Gelen Kutusu ekranlarında varsayılan olarak gizlidir. Görmek istediğinizde ?includeApi=true ekleyin.

White-label

White-label planında bir ana anahtar, her biri kendi anahtarı, bilgi tabanı ve kataloğu olan izole kiracı çalışma alanları oluşturabilir. Tüm kullanımı üst hesap öder ve yeniden faturalama için kiracı bazlı sayaç alır; kiracı üst hesabın bakiyesini asla görmez. Kiracıların tasarım gereği panel erişimi yoktur — API onların tüm yüzeyidir, takvim bağlama dâhil.

Sonraki adımlar

Geliştirici portalı — anahtar oluşturun, tam referansı okuyun, plan seçin
Bilgi tabanı — ajan yanıtlamadan önce ne okur
Ürün kataloğu — neyden satabilir
Bu yanıt neden — her cevabın arkasındaki akıl yürütme izi

Ajan API