6-) Entegrasyonlar ve Geliştirici Araçları
Supsis AI platformunun harici sistemlerle, web sitenizle, CRM/veritabanı araçlarıyla ve modern yapay zekâ asistanlarıyla (AI Agent / MCP) çift yönlü haberleşmesini sağlayan geliştirici ve entegrasyon yönetimidir.
Bu menü üzerinden REST API kimlik doğrulama anahtarlarınızı (token) yönetebilir, geliştirici dokümantasyonlarına ve SDK referanslarına tek noktadan erişebilir ve Model Context Protocol (MCP) Server altyapısını yapılandırabilirsiniz.
1-) Geliştirici Merkezi
Geliştirici Merkezi, Supsis REST API uç noktalarına erişmek, SDK bağlantılarını kurmak ve yetkilendirme (authorization) anahtarlarınızı yönetmek için kullanılan merkezi yönetim panelidir.
1.a – Dokümantasyon
Güncel referanslar Supsis dokümantasyon sitesinde tutulur. Aşağıdaki başlıklar yeni sekmede açılır:
| Dokümantasyon Kaynağı | Açıklama ve Kapsam | Bağlantı |
|---|---|---|
| REST API Referansı | Kişiler, mesajlar, kanallar, WhatsApp şablonları, toplu mesaj, e-posta ve tablo kayıtları için tüm uç noktalar. | API Referansı ↗ |
| JS SDK (Web Widget) | Sohbet balonunu web sitenize ekleyin; ziyaretçi verilerini ve sohbet durumunu tarayıcıdan yönetin. | JS SDK Rehberi ↗ |
| Otomasyon SDK Fonksiyonları | Otomasyon JS kod bloklarında kullanabileceğiniz supsis.* fonksiyonları; parametre ve yanıt örnekleriyle. |
Otomasyon SDK ↗ |
| Postman Koleksiyonu | Hazır istekleri Postman'e aktarın ve API'yi kod yazmadan hemen deneyin. | Postman Koleksiyonu ↗ |
Postman ile Test
Entegrasyonunuza başlamadan önce Postman Koleksiyonu'nu içe aktararak tüm uç noktaları canlı parametrelerle hızlıca test edebilirsiniz.
1.b – Erişim Bilgileri
REST API isteklerinde kullanacağınız sunucu adresi ve yetkilendirme bilgileri bu bölümde yer alır:
| Parametre Alanı | Değer / Format | Açıklama |
|---|---|---|
| Sunucu Adresi | https://socket.supsis.live/api/customer/v1 |
Tüm REST API HTTP isteklerinin iletileceği temel sunucu kök adresidir. |
| Yetkilendirme (Header) | Authorization: <access_token> |
API isteklerinde HTTP başlığına eklenmesi zorunlu parametredir. Bearer ön eki de kabul edilir (Bearer <access_token>). |
| Erişim Token'ı | eyJhbGci... |
Hesabınıza ait güvenli kimlik doğrulama anahtarıdır. Göz simgesiyle görüntülenebilir veya kopyalanabilir. |
- Yeni Token Üret: Mevcut token'ınızın geçerliliğini sonlandırarak anında yeni bir API anahtarı üretir.
Token Yenileme Uyarısı
Yeni Token Üret butonuna tıkladığınızda mevcut token derhal geçersiz olacaktır. Canlıda çalışan API entegrasyonlarınızın kesintiye uğramaması için yeni token'ı sistemlerinizde hemen güncellemeniz gerekir.
2-) Model Context Protocol (MCP) Server Entegrasyonu
Model Context Protocol (MCP), Supsis hesabınızdaki veritabanı tablolarını, müşteri kayıtlarını ve iş akışlarınızı Cursor, Antigravity IDE, Claude Desktop ve ChatGPT gibi modern yapay zekâ asistanlarına (AI Agent) doğrudan bağlamanızı sağlayan yeni nesil açık protokol standardıdır.
2.a – MCP Server Kabiliyetleri ve Güvenlik
- Doğal Dil ile Canlı Veri Yönetimi: AI asistanınıza "Bugünkü yeni müşteri kayıtlarını listele" veya "VIP müşteriler tablosuna yeni sipariş notu ekle" diyerek doğrudan işlem yaptırabilirsiniz.
- Kapsam (Scope) Kısıtlaması: AI asistanına yalnızca belirlediğiniz modüllere veya tablolara okuma/yazma izni verebilirsiniz.
- Geçerlilik Süresi (Expiration): Güvenlik gereksinimlerinize uygun olarak 1 gün ile 365 gün arasında otomatik süresi dolan geçici erişim anahtarları oluşturabilirsiniz.
- Çoklu İstemci Desteği: Cursor IDE, Antigravity IDE, Claude Desktop ve özel HTTP/SSE agent'lar için hazır bağlantı JSON yapılandırmaları sunulur.
2.b – Kurulum ve Kapsamlı Dokümantasyon Rehberi
Supsis panelinde MCP Server bağlantısı oluşturmak, erişim kapsamını belirlemek, mcp.json dosyasını yapılandırmak ve canlı geliştirme ortamında test senaryolarını çalıştırmak için hazırlanan detaylı uygulama rehberimizi inceleyebilirsiniz:
👉 Supsis MCP Server Entegrasyonu ve Canlı Yapılandırma Rehberi