Docs

Démarrage rapide

Ajoutez le widget de chat Respondo à votre site web en moins de 2 minutes.

1

Ajoutez le script

Collez cet extrait avant </body> sur chaque page où vous souhaitez afficher le widget :

HTMLhtml
<script>
  window.Respondo = window.Respondo || {};
  Respondo.init = Respondo.init || function(c) { window.RespondoAIConfig = c; };
  Respondo.q = Respondo.q || [];
  Respondo.identify = Respondo.identify || function(d) { Respondo.q.push(['identify', d]); };
  Respondo.init({
    agentId: 'YOUR_AGENT_ID',
    channelId: 'YOUR_CHANNEL_ID'
  });
</script>
<script src="https://api.respondo.ai/widget/widget.js" async></script>
Remplacez YOUR_AGENT_ID et YOUR_CHANNEL_ID par l’Agent ID et le Channel ID issus des paramètres de votre canal (ou copiez l’extrait prérempli depuis la page du canal). Le widget se charge de manière asynchrone et n’affecte pas les performances de la page.

Vous utilisez un framework ?#

Le même widget, intégré à votre stack — choisissez un onglet :

Affichez ce composant une fois, près de la racine de votre application :

Reacttsx
// respondo-widget.tsx — render once, near the root of your app
import { useEffect } from 'react';

export function RespondoWidget() {
  useEffect(() => {
    const w = window as any;
    w.Respondo = w.Respondo || {};
    w.Respondo.init = w.Respondo.init || function (c) { w.RespondoAIConfig = c; };
    w.Respondo.q = w.Respondo.q || [];
    w.Respondo.identify = w.Respondo.identify || function (d) { w.Respondo.q.push(['identify', d]); };
    if (!document.querySelector('script[data-respondo]')) {
      w.Respondo.init({
        agentId: 'YOUR_AGENT_ID',
        channelId: 'YOUR_CHANNEL_ID'
      });
      const s = document.createElement('script');
      s.src = 'https://api.respondo.ai/widget/widget.js';
      s.async = true;
      s.dataset.respondo = '1';
      document.body.appendChild(s);
    }
  }, []);

  return null;
}
Remplacez YOUR_AGENT_ID / YOUR_CHANNEL_ID par les valeurs des paramètres de votre canal — ou copiez l'extrait prêt à l'emploi depuis la page du canal, où ils sont déjà renseignés.
2

Identifiez les utilisateurs (recommandé)

Une fois l’utilisateur connecté, appelez identify() pour lier les sessions de chat à son profil :

JavaScriptjavascript
Respondo.identify({
  email: 'user@example.com',
  name: 'John Doe',
  userId: 'usr_12345',       // votre ID utilisateur interne
  metadata: {                // tout champ personnalisé
    plan: 'premium',
    company: 'Acme Inc'
  },
  properties: {              // propriétés de contact personnalisées (définies dans les Paramètres de l’agent)
    account_type: 'enterprise',
    region: 'eu-west'
  }
});

Terminé !

Le widget apparaît dans le coin inférieur droit. Toutes les conversations arrivent automatiquement dans votre tableau de bord Conversations.