Guide d'intégration

1

Obtenir une clé API Gemini

Va sur aistudio.google.com/apikey et crée une clé API. C'est gratuit, pas besoin de carte bancaire.

Copie la clé, tu en auras besoin à l'étape suivante.

2

Créer ton bot

Depuis le dashboard, remplis le formulaire :

Nom du bot — le nom affiché dans le widget
Message d'accueil — le premier message que voit l'utilisateur
Message de fallback — affiché si le bot ne peut pas répondre
Clé API Gemini — la clé obtenue à l'étape 1
System prompt — les instructions pour le comportement du bot
Base de connaissance — tes Q/R au format question | réponse | mots-clés

3

Rédiger un bon system prompt

Le system prompt définit la personnalité et les règles du bot. Exemple :

Tu es un assistant pour [Nom de l'entreprise].
Règles :
- Réponds de façon claire et concise (2-5 phrases max)
- Utilise un ton amical et professionnel
- Si la réponse est dans la base de connaissance, utilise-la
- Sinon, utilise tes connaissances générales
- Ne donne jamais d'informations fausses
- Si tu ne sais pas, dis-le honnêtement

4

Construire la base de connaissance

Chaque ligne suit le format : question | réponse | mots-clés

Quels sont vos horaires ? | Lundi-vendredi 9h-18h. | horaires,ouverture
Comment vous contacter ? | contact@exemple.fr ou 01 23 45 67 89. | contact,email
Livrez-vous à l'international ? | Oui, toute l'Europe sous 5-7 jours. | livraison

Les mots-clés sont optionnels mais améliorent la précision du matching sémantique.

5

Intégrer le widget

Copie le snippet depuis le dashboard et colle-le avant </body> :

<script
  src="https://ton-domaine.com/widget.js"
  data-api-base="https://ton-api-url.com"
  data-bot-id="ton-bot-id"
  data-style="bubble">
</script>

Options :

data-position="left" — positionne le widget à gauche
data-style — style d'affichage (voir ci-dessous)

6

Choisir le style du widget

4 styles disponibles via data-style :

bubble (défaut) — bouton flottant + popup
sidebar — panneau latéral pleine hauteur
fullscreen — prend tout l'écran
inline — embarqué dans un conteneur

Exemple inline (nécessite un conteneur) :

<div id="chat-container"></div>
<script
  src="https://ton-domaine.com/widget.js"
  data-api-base="https://ton-api-url.com"
  data-bot-id="ton-bot-id"
  data-style="inline"
  data-container="chat-container">
</script>

7

Tester et itérer

Utilise le playground pour essayer ton bot en live. Tu peux modifier le bot à tout moment depuis le dashboard — la KB et les embeddings sont regénérés automatiquement.