API JavaScript
Metodi globali disponibili dopo il caricamento dello script del widget.
Respondo.init(config)#
Inizializza e monta il widget. Deve essere chiamato una sola volta. Restituisce l’istanza del widget.
const widget = Respondo.init({
agentId: 'YOUR_AGENT_ID'
});Respondo.identify(identity)#
Associa l’identità dell’utente alla sessione corrente. Chiamalo dopo l’accesso.
Respondo.identify({
email: 'user@example.com',
name: 'John Doe',
userId: 'usr_123',
userHash: 'hmac_sha256_signature', // facoltativo, per la verifica dell'identità
metadata: { plan: 'pro' },
properties: { // proprietà di contatto personalizzate
account_type: 'enterprise', // chiavi definite in Agent Settings
region: 'eu-west'
}
});Respondo.track(name, properties?)#
Registra un evento lato client per il visitatore corrente (es. acquisto, upgrade del piano). Gli eventi possono avviare Tour attivati da eventi e contare per gli obiettivi dei tour. Consegna best-effort con keepalive, quindi gli eventi emessi subito prima di una navigazione (redirect al checkout) arrivano comunque. Chiamalo dopo init().
Respondo.track('purchase_completed', {
plan: 'pro',
amount: 49
});Respondo.destroy()#
Rimuove il widget dalla pagina. Utile per le SPA quando si naviga verso pagine in cui il widget non deve apparire. Non cancella l’identità del visitatore né la conversazione memorizzata — per il logout usa Respondo.reset().
// Rimuovi il widget dalla pagina
Respondo.destroy();
// Reinizializza più tardi se necessario (riprende la stessa conversazione)
Respondo.init({ agentId: 'YOUR_AGENT_ID' });Respondo.reset()#
Logout / passaggio su dispositivo condiviso. Cancella dal browser il visitor id anonimo, la conversazione memorizzata e il token di sessione, revoca il token di sessione lato server così le sue copie smettono di funzionare, e rimonta un widget anonimo nuovo. Chiamalo dall’hook di logout della tua app.
// Al logout — cancella identità, conversazione e sessione, riparti da zero
Respondo.reset();Raccolta automatica dei dati
Il widget acquisisce e memorizza automaticamente quanto segue con ogni conversazione:
| Dato | Origine |
|---|---|
| IP del client | Header HTTP |
| Browser / OS | Header User-Agent |
| Lingua | Header Accept-Language |
| Fuso orario | Intl API (JavaScript) |
| URL della pagina | window.location |
| Referrer | Header Referer |