Ana içeriğe atla
Connect360 API’leri, güvenilir bir arka ucun konuşmalar oluşturmasına, mesaj göndermesine, ekleri yüklemesine ve AI yanıtlarını tetiklemesine olanak tanır. Bunları şunlar için kullanın:
  • Web sitesi sohbet widget’ları.
  • Müşteri destek portalları.
  • Destek deneyimleri sipariş edin.
  • Connect360 konuşmalarını oluşturması veya güncellemesi gereken harici uygulamalar.

Konuşmalar

Müşteri konuşmaları oluşturun veya yeniden kullanın ve destek konularını düzenleyin.

Mesajlar

Mesaj gönderin, konu geçmişini listeleyin ve konuşma içeriğiyle çalışın.

Ekler

Dosyaları yükleyin ve iletilerdeki ek öğelerini kullanın.

AI Akışı

Desteklenen sohbet deneyimleri için AI destekli yanıtları tetikleyin.

Misafir Konuşmaları

Harici web sitesi ziyaretçilerinin güvenli bir şekilde sohbet başlatmasına veya devam etmesine izin verin.

Kimlik doğrulama

Connect360’yi çağırmadan önce güvenilir bir arka uçtan API anahtarlarını gönderin.

​
API Stilleri

Connect360, hem yazılan SDK hem de REST uç noktalarını kullanır. Konuşmalar ve mesajlar için SDK’yi kullanın: 
plato.v1.connect.getOrCreateConversation.mutate(...)
plato.v1.connect.send.mutate(...)
plato.v1.connect.listMessages.query(...)
Tarayıcı dostu ek yüklemek ve AI yanıtlarını yayınlamak için REST’i kullanın: 
POST /api/v1/connect/attachments
GET  /api/v1/connect/assets/[...key]
POST /api/v1/connect/ai-stream

​
Gerekli İzinler

Aksiyonİzin
Konuşmaları ve mesajları okuyunconnect360:conversation:read
Konuşmalar oluşturun, mesaj gönderin, ekleri yükleyin, AI’yi tetikleyinconnect360:conversation:engage
Konuşmaları silconnect360:conversation:delete
API anahtarı bir çalışma alanı üyesine ait olmalıdır.

​
Konuşma Modeli

Connect360 konuşmaları bir hiyerarşi içinde düzenlenebilir. Üst düzey görüşmeler, bir müşteri veya grupla yapılan ana konudur. Alt görüşmeler, üst düzey bir görüşmenin altındaki alt ileti dizileridir. Proje konuları, sipariş destek konuları veya konuya özel tartışmalar için kullanışlıdırlar. Mesajlar her zaman bir conversationId’ye gönderilir; bu, üst düzey bir görüşme veya bir alt görüşme olabilir.

​
Müşteri Kimliği

Web sitesi veya harici kullanıcılar için bir customer nesnesini veya mevcut bir customerId’yi iletin. Web sitesi ziyaretçilerini çalışma alanı üyeleri olarak oluşturmayın. 
customer: {
  externalId: "website_user_123",
  name: "Jane Customer",
  email: "[email protected]",
  phone: "+971500000000",
}
Plato, müşterileri harici kimlik, e-posta veya telefon yoluyla eşleştirebilir.

​
Web Sitesi Kanalları

Web sitesi entegrasyonları channelIdentifier’yi geçebilir. 
channelIdentifier: "example.com"
Plato tanımlayıcıyı normalleştirir, bir web sitesi kanalı oluşturur veya yeniden kullanır ve bunu konuşmaya ekler. example.com veya shop.example.com gibi mevcut web sitesi ana bilgisayarını kullanın.