Widgets

Warning

Avant de commencer, assure-toi d'avoir créé au moins un agent, une collection, ou un workflow.

Un widget, c'est un composant que tu intègres sur ton propre site web. Tes visiteurs peuvent discuter avec ton IA, déclencher un workflow ou remplir un formulaire — sans quitter ton site.

Les 5 types de widgets

Choisis le widget adapté à ton besoin :

Chat collection

Un chatbot qui répond à partir des documents d'une collection. Idéal pour une FAQ ou un centre d'aide.

Exemple : un widget de support client sur ton site qui répond aux questions à partir de ta documentation.

Chat agent

Un chatbot qui utilise un agent personnalisé avec ses instructions, sa personnalité et ses collections.

Exemple : un assistant commercial qui répond dans le ton de ta marque.

Bouton workflow

Un bouton qui déclenche un workflow en un clic. Le résultat s'affiche directement dans le widget.

Exemple : un bouton "Générer un résumé" qui lance un workflow de résumé automatique.

Formulaire workflow

Un formulaire dynamique généré à partir du schéma d'entrée de ton workflow. L'utilisateur remplit les champs, et le workflow s'exécute.

Exemple : un formulaire "Poser une question" avec un champ texte, qui déclenche un workflow RAG.

Moniteur webhook

Un moniteur en temps réel qui affiche les résultats d'un workflow déclenché par webhook externe.

Exemple : un tableau de bord qui affiche les résultats d'un workflow de traitement de données déclenché par une API externe.

Configurer un widget

Va dans Widgets dans le menu à gauche.
Clique sur Nouveau widget.
Choisis le type de widget (chat collection, chat agent, bouton, formulaire, moniteur).
Sélectionne la ressource liée (collection, agent ou workflow).
Donne un nom à ton widget.
Clique sur Créer.

Intégrer sur ton site

Une fois ton widget créé, copie le code d'intégration et colle-le dans ton site.

Ouvre ton widget dans le dashboard.
Clique sur Code d'intégration.
Copie le snippet (balise script).
Colle-le dans le HTML de ta page, juste avant la balise </body>.

Le code ressemble à ça :

<script src="https://widget.ignitionrag.com/embed.js" data-widget-key="pk_xxx" data-theme="dark"></script>

Tip

Le widget s'affiche automatiquement sur ta page. Tu peux le personnaliser avec les paramètres data-*.

Sécurité

Protège ton widget contre les abus :

Domaines autorisés

Définis les domaines qui ont le droit d'afficher ton widget. Par exemple : monsite.com, app.monsite.com. Les requêtes depuis d'autres domaines seront bloquées.

Limite de requêtes

Configure le nombre maximum de requêtes par session pour éviter les abus. Par défaut, une limite raisonnable est appliquée.

Clé widget

Chaque widget a une clé publique (préfixée pk_). Cette clé identifie ton widget mais ne donne pas accès à tes données. Elle est conçue pour être visible dans le code source de ta page.

Note

Certains types de widgets sont réservés aux plans payants. Les widgets chat (collection et agent) sont disponibles dès le plan Free. Les widgets workflow (bouton, formulaire, moniteur) nécessitent un plan Starter ou supérieur.

Ton widget est en place ? Apprends maintenant à tester ton workflow avant de le mettre en production. →