Entegrasyon: geliştiriciler için teknik başvuru

Bu başvuru, reactive.chat hizmetini web sitesine, uygulamaya veya arka uca entegre eden geliştiriciler içindir. Arayüzleri ve akışları kodda uygulandıkları biçimde, adları, türleri, varsayılanları ve hata durumlarıyla açıklar.

Görünüm, metinler, ana ekran, kurallar, turlar, A/B testleri ve YZ kişiliğinin ayarlanması Özelleştirme altında açıklanır. Hesabın ve temsilci panelinin kullanımı El kitabında anlatılır.

Genel bakış

Your visitors' browser                      reactive.chat                         your server
----------------------                      -------------                         -----------
loader.js  --(trigger)-->   core.<hash>.js  cdn.reactive.chat
   window.ReactiveChat (API, events)
   WebSocket rc.v1  <------------------->   ws.reactive.chat/rc_wss/
   HTTP fallback (SSE/Poll) <----------->   ws.reactive.chat/rc_wss/h/
                                            chat server  --- POST (signed) ---->  customer data endpoint
                                                         --- POST (signed) ---->  webhook receiver
                                            reactive.chat/v1  <--- Bearer -----  REST API / MCP
identify(userHash)  <-------------------------------------- HMAC-SHA256 ------  identity secret

İstemci tarafında script etiketi yerleştirir ve isteğe bağlı olarak widget’ı window.ReactiveChat üzerinden kontrol edersiniz. Sunucu tarafında oturum açmış kullanıcıların kimliğini imzalar, gerekirse müşteri verisi isteklerini yanıtlar, webhook’ları alır ve REST API kullanırsınız.

Bölümler

Temel bilgiler

• Mimari ve akış – parçalar, birlikte çalışmaları, sürümler ve dağıtım
• Hızlı başlangıç – yerleştirme, alan adınızı girme, CSP, kontrol

Tarayıcıda

• Script etiketi başvurusu – tüm data-rc-* öznitelikleri ve yapılandırma kaynakları
• JavaScript API’si – tüm ReactiveChat(…) komutları
• Olaylar – on/off ve DOM olayları
• Ziyaretçileri tanımlama ve bağlam iletme – identify, userHash, exp, track
• Tek sayfalı uygulamalar ve sayfa değişiklikleri
• Güvenlik ve Content Security Policy

Bağlantı ve dağıtım

• Özel alan adı ve birinci taraf proxy – nginx, Apache, Caddy
• Taşıma: WebSocket, HTTP yedeği, yeniden bağlanma – protokol, hata ve kapanış kodları

Sunucunuzda

• Müşteri verisi uç noktası – siparişleri alma ve içe aktarma
• Webhook’lar – olaylar, imza, yeniden denemeler, REST hook’ları
• Sunucu API’si (REST v1) ve MCP
• Entegrasyonlar ve kanallar – WhatsApp, Messenger, Instagram, Telegram, SMS, e-posta

Diğer entegrasyon yerleri

• Mobil uygulamalar – WebView içinde sohbet
• Smart Answer – web sitenizin aramasında YZ yanıtı

İşletim

• Gizlilik entegrasyonu – onay, saklama, gizlilik metni
• Sınırlar ve kotalar
• Sorun giderme ve kontrol listesi

Konuyla ilgili diğer sayfalar

• Widget’ı yerleştirme – kısa sürüm
• Teknik ayrıntılar – boyut, erişilebilirlik ve kontrast ölçümleri
• Sohbeti kendi bağlantınızdan veya düğmenizden açma
• Sohbette tanıtım kartı
• Sohbette müşteri verileri
• Özel alan adı (birinci taraf)
• HTTP yedeği
• Gizlilik metnini otomatik yerleştirme

Terimler

• Site anahtarı – projenin herkese açık anahtarı (24 karakter); yerleştirme kodunda bulunur. Gizli değildir.
• Proje – kendi ayarları olan web sitesi veya uygulama; birden fazla proje çalışma alanı oluşturur.
• Temsilci paneli – ekibinizin yanıt verdiği arayüz.
• Doğrulanmış kullanıcı – kimliği sunucunuz tarafından userHash ile imzalanmış ziyaretçi.
• Yükleyici / çekirdek – küçük yükleme parçası loader.js ve ardından yüklenen ana parça core.<hash>.js.

Dokümantasyonun tüm bölümlerine genel bakış: Dokümantasyon.