Guide

Installer le widget sur votre site

Installation, domaines autorisés, clé pk_live et snippet avant </body>.

12 min3 captures prévues

Le widget est le chemin recommandé. L’agent reste dans KODIVA ; votre page charge seulement le script public (jamais de sk_live).

Checklist d’installation

Publiez au moins un agent (souvent Accueil).
Canaux → Intégrations / widget.
Créez une installation (nom + domaines autorisés exacts).
Liez l’agent à l’installation.
Générez une clé pk_live — copiez-la immédiatement, elle n’est plus affichée en clair.
Collez le snippet avant la balise </body> de votre site.

Intégrations / widget : étapes 01–04, liste des installations, domaines autorisés et agent Accueil lié — Installation active, domaines autorisés, et agent Accueil lié — le parcours se termine à « Coller le script ».

Apparence

Dans le panneau Apparence : nom affiché, message d’accueil, avatar, couleurs, dimensions. Enregistrez pour pousser le thème sur l’installation.

Identité, avatar, couleurs — l’aperçu en direct reflète le thème avant enregistrement.

Clé pk_live et snippet

Générez une pk_live (affichée une seule fois en clair), puis copiez le script à coller avant </body>.

<script
  src="https://cdn.sdcreativ.com/kodiva/widget.js"
  data-agent="agt_xxx"
  data-key="pk_live_xxx"
  data-api="https://api.ai.sdcreativ.com"
  async
></script>

Dimensions du widget, gestion pk_live et snippet HTML à copier avant </body> — Dimensions / typographie, clé pk_live (révoquer si besoin), et snippet prêt à coller.

Révoquer ou supprimer

Révoquer une pk_live si elle a fuité — le script qui l’utilise s’arrête.
Supprimer une installation retire aussi ses clés liées.
Ne mettez jamais sk_live dans le navigateur (API headless serveur uniquement).

Dépannage rapide

Pas de bulle : domaine hors liste, script mal placé, ou adblock.
403 : origine refusée ou agent non lié.
Réponses vides : agent DRAFT/PAUSED ou base non indexée.