Documentation Pixbot
Tout ce que vous devez savoir pour configurer, personnaliser et déployer votre chatbot IA. De la première connexion au déploiement sur votre site.
Démarrage rapide
Votre chatbot est opérationnel en 5 étapes. L'assistant de configuration vous guide automatiquement à la première connexion.
- Connectez-vous à votre tableau de bord avec vos identifiants. Si vous n'avez pas encore de compte, contactez votre administrateur.
- Configurez votre fournisseur IA — Rendez-vous dans Configuration > Modèle IA et renseignez votre clé API (OpenAI, Mistral, Anthropic ou Grok).
- Personnalisez votre bot — Dans Paramètres Généraux, définissez le nom, le ton et la personnalité de votre assistant.
- Alimentez la base de connaissances — Ajoutez vos FAQ, uploadez vos documents (PDF, Word, Excel, TXT) dans Contenu > Base de Connaissances.
- Déployez le widget — Dans Configuration > Intégration > Widgets, créez un widget et copiez le code d'intégration sur votre site.
Fournisseurs IA
Pixbot est compatible avec 4 fournisseurs d'IA. Vous pouvez changer de fournisseur à tout moment depuis Configuration > Modèle IA.
OpenAI
GPT-4o, GPT-4, GPT-3.5 Turbo. Le choix le plus populaire. Obtenez votre clé sur platform.openai.com.
Mistral AI
Modèles européens performants. Disponible via API cloud ou en local sur votre serveur. Clé sur console.mistral.ai.
Anthropic (Claude)
Modèle sûr et précis, excellent pour les instructions complexes. Clé sur console.anthropic.com.
Grok (xAI)
Le modèle de xAI avec accès aux données en temps réel. Clé sur console.x.ai.
Après avoir renseigné votre clé, utilisez le bouton Tester la connexion pour vérifier qu'elle fonctionne correctement. Vous pouvez ensuite choisir le modèle spécifique (ex: gpt-4o, gpt-3.5-turbo) et ajuster les paramètres de température et de longueur de réponse.
Base de connaissances
La base de connaissances permet à votre bot de répondre avec précision en utilisant vos propres données plutôt que ses connaissances générales. Accédez-y depuis Contenu > Base de Connaissances.
FAQ
Créez des paires question/réponse organisées par catégories. Ajoutez des mots-clés pour améliorer la détection automatique.
Documents
Uploadez vos fichiers pour que le bot puisse y puiser ses réponses.
| Format | Extension | Taille max |
|---|---|---|
| 10 Mo | ||
| Word | .doc, .docx | 10 Mo |
| Excel | .xls, .xlsx | 10 Mo |
| Texte | .txt | 5 Mo |
Règles de réponse
Définissez des règles personnalisées pour contrôler comment le bot doit répondre dans certains cas spécifiques. Utile pour imposer un comportement précis sur des sujets sensibles.
Style de réponses
Configurez la personnalité et le ton de votre bot depuis Contenu > Configuration des Réponses.
Personnalité
Définissez le nom du bot, sa description, son rôle. Donnez-lui une identité qui correspond à votre marque.
Ton & style
Formel, décontracté, professionnel, amical... Ajustez le registre de langue de votre assistant.
Mode Persona
Activez le mode persona pour que le bot adopte une identité immersive (ex: un personnage, un expert métier).
Restrictions
Définissez les sujets interdits ou les limites du bot pour qu'il reste dans son périmètre.
Flux de conversation
Créez des scénarios de conversation guidés grâce à l'éditeur visuel drag-and-drop. Accédez-y depuis Contenu > Flux de Conversation.
Types de noeuds
| Noeud | Description |
|---|---|
| Message | Envoie un message au visiteur |
| Question | Pose une question et attend la réponse |
| Choix multiples | Propose des boutons de réponse |
| Condition | Branche la conversation selon une condition |
| API externe | Appelle une API tierce et utilise la réponse |
| Email / SMS | Envoie une notification par email ou SMS |
| Webhook | Envoie les données vers un service externe |
Exemple d'utilisation : un flux de qualification de leads qui demande le nom, l'email, le besoin, puis envoie les données à votre CRM via webhook.
Widgets
Les widgets permettent d'intégrer le chatbot sur votre site web. Gérez-les depuis Configuration > Intégration > Widgets.
Intégration sur votre site
Copiez le code d'intégration et collez-le juste avant la balise </body> de votre site :
<script>
PixbotWidget.init({
widgetId: 'VOTRE_WIDGET_ID'
});
</script>
Page de chat autonome
Vous n'avez pas de site web ? Pas de problème. Chaque widget dispose d'une page de chat dédiée accessible via un lien direct ou un QR code. Idéal pour les événements, salons, ou réseaux sociaux.
Personnalisation
Pour chaque widget, vous pouvez personnaliser :
Couleurs
Couleur principale, couleur du header, couleur des messages pour correspondre à votre charte graphique.
Avatar & logo
Uploadez le logo de votre bot et un avatar personnalisé.
Messages d'accueil
Personnalisez le message de bienvenue et le placeholder du champ de saisie.
Position & taille
Choisissez la position du bouton (bas-droite, bas-gauche) et la taille de la fenêtre.
Webhooks & APIs externes
Connectez Pixbot à vos outils existants grâce aux webhooks. Configurez-les depuis Configuration > Intégration > Webhooks.
Les webhooks envoient automatiquement les données collectées par le bot (contacts, réponses de flux, etc.) vers l'URL de votre choix au format JSON.
Cas d'usage courants
CRM
Envoyez les leads collectés directement dans votre CRM (HubSpot, Salesforce, Pipedrive...)
Notifications
Recevez des alertes sur Slack, Teams ou Discord quand un visiteur a besoin d'aide humaine.
Base de données
Stockez les conversations et données collectées dans votre propre base de données.
Automatisation
Connectez avec Zapier, Make (Integromat) ou n8n pour des workflows avancés.
Email & SMS
Pixbot peut envoyer des emails et des SMS automatiquement dans le cadre des flux de conversation ou des actions automatisées.
Email (SMTP)
Configurez vos paramètres SMTP dans Configuration > Intégration > Email > Paramètres SMTP. Créez ensuite des modèles d'emails réutilisables dans Modèles d'Emails.
SMS
Choisissez votre fournisseur SMS (Twilio ou Vonage) dans Configuration > Intégration > SMS. Créez des modèles de SMS et utilisez-les dans vos flux de conversation.
{nom}, {email}, etc., remplies automatiquement par les données du flux.Analytics
Suivez les performances de votre bot depuis Suivi et analyses > Analytics.
Métriques disponibles
| Métrique | Description |
|---|---|
| Conversations | Nombre total de conversations sur la période |
| Messages | Nombre de messages échangés |
| Contacts collectés | Leads récupérés via les flux |
| Requêtes non comprises | Questions auxquelles le bot n'a pas su répondre |
| Utilisation API | Nombre d'appels à l'API du fournisseur IA |
Utilisez les Requêtes non comprises (Suivi et analyses > Requêtes non comprises) pour identifier les lacunes et enrichir votre base de connaissances en conséquence.
Profils de bot
Créez plusieurs profils de bot depuis Configuration > Profils de Bot. Chaque profil peut avoir sa propre personnalité, son propre fournisseur IA, sa propre base de connaissances et ses propres widgets.
Cas d'usage typiques :
Multi-marques
Un bot par marque avec une identité visuelle et un ton différents.
Multi-langues
Un profil par langue pour servir un public international.
Multi-services
Un bot pour le support, un autre pour les ventes, un troisième pour les RH.
Test A/B
Testez différentes configurations et comparez les performances.
Sécurité
Pixbot intègre plusieurs couches de sécurité pour protéger vos données et celles de vos utilisateurs.
| Protection | Description |
|---|---|
| Chiffrement des clés API | Vos clés sont stockées chiffrées côté serveur et jamais exposées en clair |
| Isolation multi-tenant | Chaque utilisateur ne voit que ses propres données, sans exception |
| Protection CSRF | Tous les formulaires sont protégés contre les attaques CSRF |
| Anti brute-force | Verrouillage automatique après plusieurs tentatives de connexion échouées |
| Rate limiting | Limitation du nombre de requêtes API pour éviter les abus |
| Sessions sécurisées | Sessions serveur avec timeout automatique |