JavaScript API
Widget betiği yüklendikten sonra kullanılabilen global yöntemler.
Respondo.init(config)#
Widget’ı başlatır ve monte eder. Bir kez çağrılmalıdır. Widget örneğini döndürür.
const widget = Respondo.init({
agentId: 'YOUR_AGENT_ID'
});Respondo.identify(identity)#
Geçerli oturuma kullanıcı kimliğini ekler. Girişten sonra çağırın.
Respondo.identify({
email: 'user@example.com',
name: 'John Doe',
userId: 'usr_123',
userHash: 'hmac_sha256_signature', // isteğe bağlı, kimlik doğrulama için
metadata: { plan: 'pro' },
properties: { // özel kişi özellikleri
account_type: 'enterprise', // Ajan Ayarları’nda tanımlanan anahtarlar
region: 'eu-west'
}
});Respondo.track(name, properties?)#
Geçerli ziyaretçi için istemci tarafı bir olay kaydeder (ör. satın alma, plan yükseltme). Olaylar, olayla tetiklenen Tour’ları başlatabilir ve tur hedeflerine sayılabilir. keepalive ile elden gelen en iyi (best-effort) teslimat sağlanır; böylece gezinmeden hemen önce (ödeme yönlendirmesi) tetiklenen olaylar yine ulaşır. init() sonrasında çağırın.
Respondo.track('purchase_completed', {
plan: 'pro',
amount: 49
});Respondo.destroy()#
Widget’ı sayfadan kaldırır. Widget’ın görünmemesi gereken sayfalara geçerken SPA’lar için kullanışlıdır. Ziyaretçinin kimliğini veya saklanan konuşmayı temizlemez — çıkış için Respondo.reset() kullanın.
// Widget’ı sayfadan kaldır
Respondo.destroy();
// Gerekirse daha sonra yeniden başlat (aynı konuşmayı sürdürür)
Respondo.init({ agentId: 'YOUR_AGENT_ID' });Respondo.reset()#
Çıkış / ortak cihaz devri. Anonim ziyaretçi kimliğini, saklanan konuşmayı ve oturum belirtecini tarayıcıdan temizler, oturum belirtecini sunucu tarafında iptal eder (kopyaları çalışmaz olur) ve taze, anonim bir widget’ı yeniden monte eder. Bunu uygulamanızın çıkış (logout) kancasından çağırın.
// Çıkışta — kimliği, konuşmayı ve oturumu sil, sıfırdan başla
Respondo.reset();Otomatik Veri Toplama
Widget, her konuşmayla birlikte aşağıdakileri otomatik olarak yakalar ve saklar:
| Veri | Kaynak |
|---|---|
| İstemci IP’si | HTTP başlıkları |
| Tarayıcı / İşletim Sistemi | User-Agent başlığı |
| Dil | Accept-Language başlığı |
| Saat dilimi | Intl API (JavaScript) |
| Sayfa URL’si | window.location |
| Yönlendiren (Referrer) | Referer başlığı |