Concepts Fondamentaux

Comprendre ces piliers rendra chaque fonctionnalité de FRENZY.BOT plus facile à utiliser. Cette page explique le fonctionnement du système en termes simples.

Comment FRENZY.BOT fonctionne

┌─────────────┐     ┌──────────────┐     ┌─────────────┐
│ Vos Données │ ──→ │  Indexation  │ ──→ │   Qdrant    │
│Fichiers, URLs│     │ (Embeddings) │     │ (Vector DB) │
│    FAQs     │     └──────────────┘     └──────┬──────┘
└─────────────┘                                 │
                                                │ récupération
┌─────────────┐     ┌──────────────┐     ┌──────┴──────┐
│  Question   │ ──→ │  FRENZY.BOT  │ ──→ │ Modèle d'IA │
│ Utilisateur │     │ (Moteur RAG) │ ←── │(via OpenRouter)│
└─────────────┘     └──────┬───────┘     └─────────────┘
                           │
                    ┌──────┴──────┐
                    │  Réponse    │
                    │ + Données Lead│
                    │ + Analytics │
                    └─────────────┘

Vous téléchargez vos données — les fichiers, les URL de sites Web et les paires de FAQ sont intégrés à la Base de Connaissances.
Le système les indexe — le contenu est converti en "embeddings" numériques et stocké dans Qdrant (base de données vectorielle) afin de pouvoir être recherché par sens, et non seulement par mots-clés.
Un utilisateur pose une question — via le widget, WhatsApp, Telegram ou tout autre canal connecté.
FRENZY.BOT récupère le contenu pertinent — le système trouve les segments les plus pertinents de votre base de connaissances grâce à la recherche sémantique.
Le modèle d'IA génère une réponse — le contenu récupéré + la question de l'utilisateur sont envoyés au modèle d'IA (Claude, GPT, Gemini, etc.) via OpenRouter.
Tout est suivi — la conversation, le temps de réponse, l'utilisation des jetons (tokens) et toutes les données de prospects (leads) capturées sont stockés pour le reporting.

Bot

Votre bot est l'assistant IA que vous construisez. Chaque bot possède ses propres :

Base de connaissances — Les documents, URL et FAQ dont il tire son savoir.
Paramètres — Modèle d'IA, prompt système, température, branding, configuration du widget.
Conversations — Historique des chats avec les utilisateurs.
Leads — Contacts capturés pendant les conversations.
Analytics — Métriques d'utilisation et données de tunnel de conversion.
Widget — Son propre code d'intégration avec un data-bot-id unique.

Dans une configuration multi-bot, vous pouvez faire fonctionner plusieurs bots à partir d'une seule installation — chacun étant complètement isolé des autres.

Où gérer : Paramètres, Base de connaissances, Intégration, et le menu déroulant de l'espace de travail dans l'en-tête.

Base de Connaissances

La base de connaissances est la bibliothèque que votre bot consulte avant de répondre à toute question. C'est ce qui rend votre bot spécifique à votre entreprise au lieu d'une IA générique.

Trois sources de données :

Source	Idéal pour	Vitesse d'indexation
Fichiers (PDF, DOCX, TXT, CSV, etc.)	Documents internes, politiques, specs produits	Quelques minutes
URLs (toute page publique)	Contenu de site Web, articles d'aide, blog	Quelques minutes
FAQs (paires Q&R manuelles)	Réponses critiques que vous voulez contrôler exactement	Instantané

Principe clé : Si un sujet n'est pas dans la base de connaissances, le bot peut répondre de manière générique ou refuser de répondre. Plus vous ajoutez de contenu pertinent, plus le bot est performant.

Pour le guide complet, voir Base de Connaissances.

Canaux

Les Canaux sont les endroits où vos utilisateurs interagissent avec le bot.

Canal	Type	Configuration
Widget Web	Primaire	Script d'intégration sur votre site
WhatsApp	Messagerie	WAHA Docker + appairage QR code
Telegram	Messagerie	Token de bot via @BotFather
Discord	Communauté	Token de bot via le Portail Développeur
Instagram	Social	Page Access Token
Messenger	Social	Intégration de Page Facebook
Slack	Travail	Token d'application
Webhook	Personnalisé	N'importe quel endpoint HTTP

Chaque canal peut avoir son propre style de réponse — l'IA adapte son ton et la longueur de sa réponse pour correspondre à la plateforme (ex: plus court sur WhatsApp, plus détaillé sur le widget Web).

Pour plus de détails, voir Canaux.

Sessions & conversations

Une session est une conversation complète entre un utilisateur et votre bot. Chaque session suit :

Messages — Chaque question et réponse dans la conversation.
Tokens — Le nombre de jetons IA consommés (impacte le coût).
Durée — Combien de temps la conversation a duré.
Source — De quel canal provient la conversation.
Données Lead — Toutes les informations de contact capturées pendant le chat.

Les sessions sont la base de l'analyse, de la révision de qualité et de la capture de leads. Consultez-les dans Conversations.

Leads & intégrations

Un lead est un contact capturé lors d'un chat — nom, e-mail, téléphone, entreprise et tous les champs personnalisés que vous avez configurés.

Les leads passent par un pipeline :

Nouveau → Contacté → Qualifié → Converti (ou Perdu)

Les intégrations acheminent automatiquement les leads vers vos outils externes :

E-mail — Notifications SMTP à votre équipe.
Webhook — Payloads JSON vers vos propres endpoints.
Google Sheets — Ajout de lignes pour un CRM léger.
MailChimp — Ajout de contacts aux listes de marketing par e-mail.

Pour plus de détails, voir Gestion des Leads et Intégrations.

Modules

Les Modules sont des capacités optionnelles que vous pouvez activer ou désactiver sans affecter le système central :

Module	Ce qu'il fait
Accès Web en direct (Tavily)	Permet au bot de chercher sur le web quand les données internes ne suffisent pas
Transfert Humain	Transfère les conversations à des agents humains
Synthèse Vocale	Convertit les réponses de l'IA en lecture audio
Prise de Rendez-vous	Planification en chat via Calendly
Formulaire de Lead	Capture les informations de contact en cours de conversation
WhatsApp	Messagerie automatisée via WAHA

Parcourez et gérez les modules dans Modules.

Auto-vérification rapide

Utilisez cette liste pour vérifier que votre bot est pleinement opérationnel :

[ ] Base de connaissances alimentée — Au moins un fichier, une URL ou une FAQ ajoutée et affichant le statut Live.
[ ] OpenRouter connecté — Le moteur d'IA affiche un fournisseur connecté et un modèle sélectionné.
[ ] Widget déployé — Le script d'intégration est sur votre site et la bulle de chat apparaît.
[ ] Intégrations activées — Les leads sont acheminés vers votre CRM, e-mail ou webhook.

Si ces quatre points sont validés, votre système est pleinement fonctionnel et prêt pour le trafic de production.