API JavaScript
Méthodes globales disponibles après le chargement du script du widget.
Respondo.init(config)#
Initialise et monte le widget. Doit être appelée une seule fois. Renvoie l’instance du widget.
const widget = Respondo.init({
agentId: 'YOUR_AGENT_ID'
});Respondo.identify(identity)#
Rattache l’identité de l’utilisateur à la session courante. À appeler après la connexion.
Respondo.identify({
email: 'user@example.com',
name: 'John Doe',
userId: 'usr_123',
userHash: 'hmac_sha256_signature', // facultatif, pour la vérification d’identité
metadata: { plan: 'pro' },
properties: { // propriétés de contact personnalisées
account_type: 'enterprise', // clés définies dans les Paramètres de l’agent
region: 'eu-west'
}
});Respondo.track(name, properties?)#
Enregistre un événement côté client pour le visiteur courant (par ex. achat, montée en gamme). Les événements peuvent déclencher des visites guidées (Tours) et compter pour leurs objectifs. Remise best-effort avec keepalive, de sorte que les événements émis juste avant une navigation (redirection de paiement) arrivent quand même. À appeler après init().
Respondo.track('purchase_completed', {
plan: 'pro',
amount: 49
});Respondo.destroy()#
Supprime le widget de la page. Utile pour les SPA lors de la navigation vers des pages où le widget ne doit pas apparaître. Cela n’efface ni l’identité du visiteur ni la conversation stockée — pour la déconnexion, utilisez Respondo.reset().
// Supprime le widget de la page
Respondo.destroy();
// Réinitialisez plus tard si nécessaire (reprend la même conversation)
Respondo.init({ agentId: 'YOUR_AGENT_ID' });Respondo.reset()#
Déconnexion / passage de relais sur appareil partagé. Efface l’ID de visiteur anonyme, la conversation stockée et le jeton de session du navigateur, révoque le jeton de session côté serveur afin que ses copies cessent de fonctionner, puis remonte un widget anonyme vierge. À appeler depuis le hook de déconnexion de votre application.
// À la déconnexion — efface l'identité, la conversation et la session, repart de zéro
Respondo.reset();Collecte automatique de données
Le widget capture et stocke automatiquement les éléments suivants avec chaque conversation :
| Données | Source |
|---|---|
| IP du client | En-têtes HTTP |
| Navigateur / OS | En-tête User-Agent |
| Langue | En-tête Accept-Language |
| Fuseau horaire | API Intl (JavaScript) |
| URL de la page | window.location |
| Référent | En-tête Referer |