Agent API — Tam Kontrol Sizde | Replywise

Agent API Nedir?

Agent API, Replywise AI agent'larınızı herhangi bir uygulama, platform veya servise programatik olarak bağlamanızı sağlayan RESTful bir arayüzdür. Hazır kanallar (WhatsApp, Telegram, Webchat) dışında kendi özel chatbot deneyimlerinizi oluşturmak istediğinizde Agent API tam kontrolü size verir.

Mobil uygulamanıza in-app sohbet ekleyin, IoT cihazlarınıza sesli asistan entegre edin, dahili araçlarınıza AI copilot bağlayın veya SaaS ürününüze white-label chatbot sunun. Agent API ile sınır sadece hayal gücünüzdür. Standart HTTP request/response yapısıyla her dilde ve framework'te kullanılabilir.

Conversation API

Konuşma yönetimi için tam CRUD API. Yeni konuşma başlatın, mesaj gönderin, konuşma geçmişini sorgulayın, metadata ekleyin veya konuşmayı sonlandırın. Streaming yanıt desteği ile kullanıcıya real-time yazıyor efekti verin — tıpkı ChatGPT deneyimi gibi.

Her API çağrısında isteğe bağlı context (bağlam) parametresi geçirin. Kullanıcının o an baktığı sayfa, sepetindeki ürünler veya hesap bilgisi gibi ek verileri agent'a ileterek daha kişiselleştirilmiş yanıtlar alın. Function calling desteğiyle agent'ın dış sistemlerle etkileşimini programlayın.

Bilgi Tabanı Yönetimi

API üzerinden bilgi tabanınızı programatik olarak yönetin. Doküman ekleyin, güncelleyin veya silin. Web sayfası URL'si, PDF dosyası, düz metin veya yapılandırılmış veri (JSON/CSV) — tüm formatları destekler. Otomatik chunking ve embedding işlemi arka planda gerçekleşir.

CI/CD pipeline'ınıza entegre ederek dökümanlarınız her güncellendiğinde bilgi tabanını otomatik senkronize edin. Versiyon takibi ile hangi dokümanın ne zaman güncellendiğini izleyin. Bulk import desteğiyle binlerce dokümanı tek seferde yükleyin.

• PDF, HTML, TXT, JSON, CSV doküman desteği
• Otomatik chunking ve vektör embedding
• CI/CD pipeline entegrasyonu
• Versiyon takibi ve geçmiş yönetimi
• Bulk import/export (1000+ doküman)

Webhook ve Event Sistemi

Agent olaylarını gerçek zamanlı yakalayın. Yeni mesaj, konuşma başlangıcı, konuşma sonu, temsilci aktarımı, lead yakalama gibi olaylarda webhook endpoint'inize otomatik bildirim göndeririz. Her webhook imzalıdır (HMAC-SHA256) — kaynağın güvenilir olduğunu doğrulayın.

Event-driven mimariyle kendi iş mantığınızı oluşturun. Müşteri belirli bir niyet gösterdiğinde özel bir aksiyon tetikleyin — demo talebi geldiğinde Slack bildirimi, şikayet algılandığında öncelikli ticket oluşturma, satın alma niyeti tespit edildiğinde satış ekibini uyarma.

SDK ve Geliştirici Araçları

JavaScript/TypeScript, Python, PHP ve Go için resmi SDK'lar mevcuttur. Her SDK tam typed, async/await destekli ve comprehensive hata yönetimi içerir. npm, pip ve composer ile tek komutla kurulum yapın.

Interactive API playground ile tarayıcınızdan doğrudan API çağrıları test edin. Postman collection ve OpenAPI (Swagger) spec dosyaları ile entegrasyon sürecinizi hızlandırın. Kapsamlı dokümantasyon, kod örnekleri ve quickstart rehberleri ile dakikalar içinde ilk entegrasyonunuzu tamamlayın.

Rate Limiting ve Güvenlik

API anahtarlarınızı projeler ve ortamlar bazında yönetin. Her anahtar için ayrı rate limit, IP whitelist ve permission scope tanımlayın. Production ve development ortamları için farklı anahtarlar kullanarak güvenliği artırın.

Cömert rate limit'ler ile yüksek trafik senaryolarını destekleyin — standart planda 100 req/s, enterprise planda 1000 req/s. Rate limit aşımlarında retry-after header'ı ile otomatik backoff uygulayın. Tüm API çağrıları audit log'a kaydedilir ve dashboard üzerinden izlenebilir.