JavaScript API
Mga global na method na magagamit pagkatapos ma-load ang script ng widget.
Respondo.init(config)#
Ini-initialize at ini-mount ang widget. Kailangang tawagin nang isang beses. Ibinabalik nito ang instance ng widget.
const widget = Respondo.init({
agentId: 'YOUR_AGENT_ID'
});Respondo.identify(identity)#
Ikinakabit ang pagkakakilanlan ng user sa kasalukuyang sesyon. Tawagin ito pagkatapos mag-log in.
Respondo.identify({
email: 'user@example.com',
name: 'John Doe',
userId: 'usr_123',
userHash: 'hmac_sha256_signature', // opsyonal, para sa pagpapatunay ng pagkakakilanlan
metadata: { plan: 'pro' },
properties: { // custom na katangian ng contact
account_type: 'enterprise', // mga key na nakatakda sa Mga Setting ng Ahente
region: 'eu-west'
}
});Respondo.track(name, properties?)#
Nagtatala ng client-side na event para sa kasalukuyang bisita (hal. pagbili, pag-upgrade ng plano). Puwedeng magpasimula ang mga event ng mga Tour na naka-trigger sa event at mabilang sa mga layunin ng tour. Best-effort ang paghahatid gamit ang keepalive, kaya nakakarating pa rin ang mga event na pinaputok bago mag-navigate (redirect sa checkout). Tawagin pagkatapos ng init().
Respondo.track('purchase_completed', {
plan: 'pro',
amount: 49
});Respondo.destroy()#
Inaalis ang widget sa pahina. Kapaki-pakinabang sa mga SPA kapag lumilipat sa mga pahinang hindi dapat lumitaw ang widget. Hindi nito binubura ang identity ng bisita o ang nakaimbak na usapan — para sa pag-log out, gamitin ang Respondo.reset().
// Alisin ang widget sa pahina
Respondo.destroy();
// I-initialize muli mamaya kung kailangan (ipinagpapatuloy ang parehong usapan)
Respondo.init({ agentId: 'YOUR_AGENT_ID' });Respondo.reset()#
Pag-log out / paglilipat sa shared na device. Binubura nito ang anonymous na visitor id, ang nakaimbak na usapan, at ang session token sa browser, pinapawalang-bisa ang session token sa panig ng server para hindi na gumana ang mga kopya nito, at muling nagmo-mount ng sariwang anonymous na widget. Tawagin ito mula sa logout hook ng app ninyo.
// Kapag nag-log out — burahin ang identity, usapan at session, magsimulang muli
Respondo.reset();Awtomatikong pagkolekta ng datos
Awtomatikong kinukuha at iniimbak ng widget ang sumusunod sa bawat usapan:
| Datos | Pinagmulan |
|---|---|
| IP ng kliyente | Mga HTTP header |
| Browser / OS | Header na User-Agent |
| Wika | Header na Accept-Language |
| Time zone | Intl API (JavaScript) |
| URL ng pahina | window.location |
| Referrer | Header na Referer |