2people.chat dokümanları

#Platform nedir?

2people.chat, oyunculardan gelen destek taleplerini tek bir gelen kutusunda toplar. Sitenize eklediğiniz widget üzerinden başlayan her konuşmayı önce yapay zekâ asistanı karşılar; bilgi tabanınızdan ve (bağladıysanız) operatör API’nizden aldığı doğrulanmış verilerle yanıt verir. Asistanın çözemediği ya da belirlediğiniz devir kurallarına uyan konuşmalar, temsilci paneline veya Telegram’a devredilir.

İki web uygulaması vardır:

• Yönetim paneli: web siteleri ve widget, yapay zekâ asistanları, entegrasyonlar, ekip ve roller, analitik, webhook’lar, gizlilik ve kullanım.
• Temsilci paneli: gelen kutusu, konuşmalar, hazır cevaplar, ziyaretçiler ve kişisel profil (müsaitlik, çalışma saatleri, Telegram bağlantısı).

#Temel kavramlar

Tenant (hesap)

Kuruluşunuzun yalıtılmış çalışma alanı. Konuşmalar, ekip, ayarlar ve veriler tenant’a aittir; başka bir tenant bunlara erişemez. API çağrılarında tenant, X-Tenant-Id başlığıyla belirtilir.

Marka ve web sitesi

Bir tenant birden fazla marka barındırabilir; her web sitesi bir markaya bağlıdır. Web sitesi bir alan adı (ve isteğe bağlı ek kökenler), bir widget anahtarı (wk_ ile başlar) ve oyuncu kimliği için bir imzalama sırrı taşır.

Ziyaretçi ve oyuncu

Widget’ı açan herkes ziyaretçidir. Sunucunuzda imzalanan kimlik token’ı ile doğrulanan ziyaretçi, operatör sisteminizdeki oyuncuya bağlanır; oyuncu kimliği hiçbir zaman tarayıcıdan doğrudan kabul edilmez.

Konuşma

Bir ziyaretçiyle yürütülen sohbet. Konuşma yapay zekâda, temsilci beklerken, bir temsilcide veya kapalı olabilir; mesajlar, iç notlar, etiketler ve memnuniyet puanı konuşmaya bağlıdır.

Yapay zekâ asistanı

Yapay Zekâ Stüdyosu’nda tanımlanan, sürümlenen ve web sitelerine yayınlanan asistan. Bilgi tabanlarını ve izin verilen araçları kullanır; belirlediğiniz koşullarda temsilciye devreder.

Temsilci

Konuşmaları devralan ekip üyesi. Neler yapabileceği rolüne (ör. Agent, Supervisor) bağlıdır; konuşmalar müsait temsilcilere teklif edilir.

Entegrasyonlar

Operatör API bağlantısı (oyuncu, cüzdan, yatırım, bonus verileri ve bonus tanımlama), Telegram köprüsü, webhook’lar ve sunucudan sunucuya API anahtarları.

#Parçalar nasıl birleşir?

1. Widget sitenizde açılır ve ziyaretçi için bir oturum başlatır.
2. Oyuncu giriş yapmışsa sayfanız, sunucunuzun imzaladığı kimlik token’ını widget’a iletir; ziyaretçi doğrulanmış oyuncuya bağlanır.
3. Yapay zekâ asistanı soruyu yanıtlar. Hesaba özel bilgiler (bakiye, yatırımlar, bonus geçmişi) yalnızca doğrulanmış oyuncular için operatör API’nizden okunur.
4. Gerektiğinde konuşma temsilciye devredilir; temsilci panelden ya da Telegram’dan yanıt verir.
5. Olaylar webhook’larla sistemlerinize iletilir; raporlar analitik ekranlarında ve REST API’de yer alır.

#Hızlı bağlantılar