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. E-posta veya userId ile, kullanıcı sohbeti hiç açmasa bile kişiyi hemen oluşturur. signedUpAt (Date, Unix saniyesi veya ISO 8601 dizesi) kullanıcının ürününüze kaydolduğu zamandır; verilmezse kişinin kayıt tarihi boş kalır.
Respondo.identify({
email: 'user@example.com',
name: 'John Doe',
userId: 'usr_123',
signedUpAt: '2024-05-31T10:00:00Z',
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.
Olaylar, onları bekleyen açılır anketleri de açar (When and where): eşleşen bir sayfadaysa hemen, 30 dakika içinde böyle bir sayfaya gelindiğinde ise varışta — örneğin bir yönlendirmeden sonra.
Respondo.track('purchase_completed', {
plan: 'pro',
amount: 49
});Respondo.startSurvey(surveyId)
Yayındaki bir açılır anketi şimdi, herhangi bir sayfada açar; Show on, sayfa kurallarını, sayfada geçen süreyi, tetikleyici olayı ve hedef kitleyi atlar. Kimliği anket düzenleyicisinden kopyalayın (Additional ways to share). Ziyaretçinin zaten yanıtladığı anket yeniden gösterilmez. Widget yüklenmeden önce çağrılabilir.
Respondo.startSurvey('<survey-id>');Respondo.open(message?) / Respondo.close()
Messenger’ı kendi düğmelerinizden açar veya kapatır. Mesaj alanının önceden doldurulmuş olarak açılması için open çağrısına bir dize geçirin. Respondo.init() sonrasında çağırın; başlatıcı hâlâ belirirken yapılan bir çağrı, başlatıcı göründüğü anda uygulanır.
Respondo.open();
Respondo.open('I have a question about my invoice');
Respondo.close();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ığı |