API JavaScript

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().

Les événements ouvrent aussi les enquêtes pop-up qui les attendent (When and where) : immédiatement sur une page correspondante, ou à l’arrivée sur une telle page dans les 30 minutes, par exemple après une redirection.

Respondo.track('purchase_completed', {
  plan: 'pro',
  amount: 49
});

Respondo.startSurvey(surveyId)#

Ouvre immédiatement une enquête pop-up active, sur n’importe quelle page, en ignorant Show on, les règles de page, le temps passé sur la page, l’événement déclencheur et l’audience. Copiez l’identifiant dans l’éditeur d’enquête (Additional ways to share). Une enquête déjà répondue n’est plus affichée. Peut être appelé avant la fin du chargement du widget.

Respondo.startSurvey('<survey-id>');

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();