JavaScript API
Metode global yang tersedia setelah memuat skrip widget.
Respondo.init(config)
Menginisialisasi dan memasang widget. Harus dipanggil sekali. Mengembalikan instans widget.
const widget = Respondo.init({
agentId: 'YOUR_AGENT_ID'
});Respondo.identify(identity)
Melampirkan identitas pengguna ke sesi saat ini. Panggil setelah login. Dengan email atau userId, kontak langsung dibuat, meski pengguna tidak pernah membuka chat. signedUpAt (Date, detik Unix, atau string ISO 8601) adalah waktu pengguna mendaftar di produk Anda; tanpanya, tanggal pendaftaran kontak tetap kosong.
Respondo.identify({
email: 'user@example.com',
name: 'John Doe',
userId: 'usr_123',
signedUpAt: '2024-05-31T10:00:00Z',
userHash: 'hmac_sha256_signature', // opsional, untuk verifikasi identitas
metadata: { plan: 'pro' },
properties: { // properti kontak khusus
account_type: 'enterprise', // key didefinisikan di Agent Settings
region: 'eu-west'
}
});Respondo.track(name, properties?)
Merekam event sisi klien untuk pengunjung saat ini (mis. pembelian, upgrade paket). Event dapat memulai Tur yang dipicu event dan dihitung untuk goal tur. Pengiriman best-effort dengan keepalive, sehingga event yang dikirim tepat sebelum navigasi (redirect checkout) tetap sampai. Panggil setelah init().
Event juga membuka survei pop-up yang menunggunya (When and where): langsung di halaman yang cocok, atau saat tiba di halaman seperti itu dalam 30 menit, misalnya setelah pengalihan.
Respondo.track('purchase_completed', {
plan: 'pro',
amount: 49
});Respondo.startSurvey(surveyId)
Membuka survei pop-up yang aktif sekarang, di halaman mana pun, tanpa memperhatikan Show on, aturan halaman, waktu di halaman, event pemicu, dan audiens. Salin id dari editor survei (Additional ways to share). Survei yang sudah dijawab pengunjung tidak ditampilkan lagi. Aman dipanggil sebelum widget selesai dimuat.
Respondo.startSurvey('<survey-id>');Respondo.open(message?) / Respondo.close()
Membuka atau menutup messenger dari tombol Anda sendiri. Berikan string ke open agar kolom pesan langsung terisi. Panggil setelah Respondo.init(); panggilan yang dibuat saat launcher masih muncul akan diterapkan begitu launcher tampil.
Respondo.open();
Respondo.open('I have a question about my invoice');
Respondo.close();Respondo.destroy()
Menghapus widget dari halaman. Berguna untuk SPA saat menavigasi ke halaman di mana widget tidak boleh muncul. Metode ini tidak menghapus identitas pengunjung atau percakapan tersimpan — untuk logout, gunakan Respondo.reset().
// Hapus widget dari halaman
Respondo.destroy();
// Inisialisasi ulang nanti jika diperlukan (melanjutkan percakapan yang sama)
Respondo.init({ agentId: 'YOUR_AGENT_ID' });Respondo.reset()
Logout / serah terima perangkat bersama. Menghapus visitor id anonim, percakapan tersimpan, dan token sesi dari browser, mencabut token sesi di sisi server sehingga salinannya berhenti bekerja, dan memasang ulang widget anonim yang baru. Panggil ini dari hook logout aplikasi Anda.
// Saat logout — hapus identitas, percakapan, dan sesi, mulai dari awal
Respondo.reset();Pengumpulan Data Otomatis
Widget secara otomatis menangkap dan menyimpan hal-hal berikut pada setiap percakapan:
| Data | Sumber |
|---|---|
| IP Klien | Header HTTP |
| Browser / OS | Header User-Agent |
| Bahasa | Header Accept-Language |
| Zona waktu | Intl API (JavaScript) |
| URL Halaman | window.location |
| Perujuk | Header Referer |