# Ajan API

> Waslo ajanını kendi kodunuzdan çalıştırın: yanıtlar için tek bir REST uç noktası, ayrıca bilgi tabanı, katalog, hafıza ve takvim — kontrol paneli gerekmez.

Source: https://waslo.io/tr/docs/agent-api · Last updated: 2026-10-12

Ajanın yanıt motorunun yaptığı her şeyi kodunuz da yapabilir — bilgi tabanı, hafıza, katalog, takvim, yapılandırma ve kullanım dâhil. 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](/developers).

## 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](/docs/connecting-channels) ü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.

```bash
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](/developers) 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 `tenants` (tenants yalnızca White-label anahtarları için) — 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 (görsel, ses, video veya PDF) | 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

Kiracılar yalnızca White-label planında bulunur. Bu planda 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](/docs/integrations) dâhil.

## Sonraki adımlar

- [Geliştirici portalı](/developers) — anahtar oluşturun, tam referansı okuyun, plan seçin
- [Bilgi tabanı](/docs/knowledge-base) — ajan yanıtlamadan önce ne okur
- [Ürün kataloğu](/docs/product-catalog) — neyden satabilir
- [Bu yanıt neden](/docs/why-this-reply) — her cevabın arkasındaki akıl yürütme izi

## Konular

Kuruluşunuz konu etiketleri (2–8) tanımladığında, `POST /v1/agent/reply` ve `POST /v1/agent/classify` bir `topic` alanı içerir; `GET/PUT /v1/config` ise `topicLabels` okur ve yazar — white-label dahil tamamen headless. Bkz. [Konular ve Ekip Yönlendirmesi](/docs/team-routing).

`GET/PUT /v1/config` ayrıca `replyLanguage` okur ve yazar: `"auto"` her son kullanıcıya kendi dilinde yanıt verir, bir dil kodu (`"es"`, `"ar"`, `"zh-Hans"`…) her zaman o dilde yanıt verir, `null` ise organizasyonun paneldeki ayarını izler (sabit bir dil yoksa son kullanıcının dili).
