Configuration WhatsApp
FRENZY.BOT inclut une intégration WhatsApp en un clic propulsée par WAHA (WhatsApp HTTP API). Une fois activé, votre assistant IA peut recevoir et répondre aux messages WhatsApp automatiquement — avec capture de leads, support de transfert (handoff) et suivi des conversations.
Prérequis
- Canal WhatsApp activé dans Channels
- Un numéro de téléphone compatible avec WhatsApp
- Service WhatsApp activé sur votre serveur (géré automatiquement lors de la configuration)
Configuration étape par étape
Étape 1 : Ajouter le canal WhatsApp
- Allez dans Channels dans la barre latérale du tableau de bord.
- Dans la section Catalog (navigation de gauche), cliquez sur WhatsApp.
- Basculez le canal sur Active.
Installation automatique
Le service WhatsApp est pré-installé et prêt à l'emploi lors du provisionnement de votre serveur. Aucune configuration supplémentaire n'est requise au-delà de l'activation.
Étape 2 : Démarrer le service WhatsApp
- Une fois activé, vous verrez le panneau Service Status.
- Le tableau de bord affiche l'état du service :
- Running (vert) : Le service est actif et prêt.
- Starting (orange) : Le service démarre. Attendez 10 à 30 secondes.
- Stopped (rouge) : Cliquez sur Start pour lancer le service.
- Utilisez les boutons Start / Stop / Restart pour contrôler le service.
Étape 3 : Connecter votre compte WhatsApp
- Une fois que le service affiche Running et que l'API est accessible, la section WhatsApp se déverrouille.
- Cliquez sur Connect WhatsApp.
- Un code QR apparaît à l'écran.
- Ouvrez WhatsApp sur votre téléphone → Paramètres → Appareils connectés → Connecter un appareil.
- Scannez le code QR.
- Attendez que le statut de connexion affiche Connected.
Expiration du code QR
Le code QR s'actualise toutes les 30 secondes. S'il expire, cliquez sur Refresh QR pour en générer un nouveau. Gardez votre téléphone à proximité pendant la configuration.
Étape 4 : Tester la connexion
- Envoyez un message à votre numéro WhatsApp depuis un autre téléphone.
- Le bot devrait répondre en utilisant votre base de connaissances et votre modèle d'IA.
- Vérifiez la page Conversations dans le tableau de bord pour confirmer que le message est apparu.
Fonctionnement
Une fois connecté, FRENZY.BOT gère les messages WhatsApp de bout en bout :
- Message entrant → WAHA le reçoit et le transmet à FRENZY.BOT via webhook.
- Traitement IA → Le bot récupère le contenu pertinent de la base de connaissances et génère une réponse.
- Réponse envoyée → La réponse est renvoyée à l'utilisateur via WhatsApp.
- Capture de leads → Si l'utilisateur fournit des coordonnées, un lead est créé automatiquement.
- Transfert → Si l'utilisateur demande un humain, la conversation est transmise à vos agents de chat en direct.
Style de réponse du canal
Les réponses WhatsApp sont automatiquement adaptées au format de messagerie :
- Réponses plus courtes et plus conversationnelles (moins de 2 phrases par défaut).
- Ton amical adapté à la messagerie mobile.
- Vous pouvez personnaliser le style de réponse WhatsApp dans Settings → Channels.
Gestion du service WhatsApp
Commandes du service
Le tableau de bord propose des contrôles directs pour le service WhatsApp :
| Action | Description |
|---|---|
| Start | Lance le service s'il est arrêté |
| Stop | Arrête proprement le service |
| Restart | Arrête et redémarre (utile après des modifications de config) |
| Status | Affiche l'état actuel + test de santé de l'API |
Déconnecter WhatsApp
Pour déconnecter votre compte WhatsApp sans supprimer le module :
- Allez dans Settings → WhatsApp.
- Cliquez sur Disconnect.
- Le bot cesse immédiatement de recevoir les messages WhatsApp.
- Les conversations historiques et les leads sont conservés.
Pour vous reconnecter plus tard, scannez simplement un nouveau code QR.
Sécurité
- Le service WhatsApp est protégé par un pare-feu et n'est accessible que depuis votre serveur.
- Les clés API sont générées automatiquement et stockées de manière sécurisée.
- Les messages WhatsApp sont traités sur votre serveur privé — ils ne passent jamais par des services cloud tiers.
FAQ
Q : Le code QR ne se scanne pas.
- Assurez-vous que le service WAHA affiche Running et que le test de santé de l'API est au vert.
- Essayez d'actualiser le code QR.
- Vérifiez que votre téléphone dispose d'une connexion internet stable.
Q : Les messages ne sont pas reçus.
- Vérifiez que le statut de la session WhatsApp affiche Connected.
- Vérifiez que l'URL du webhook est correctement configurée (c'est automatique dans la plupart des installations).
- Contactez votre gestionnaire de compte si le problème persiste.
Q : Puis-je utiliser l'API WhatsApp Business à la place ?
- FRENZY.BOT utilise actuellement WAHA (WhatsApp basé sur l'appareil). Le support de l'API WhatsApp Business (basé sur le cloud) est prévu dans la feuille de route.
Q : Combien de conversations WhatsApp peut-il gérer ?
- Le moteur NOWEB est léger et gère efficacement les volumes commerciaux standards. Pour des volumes très élevés (plus de 1000 chats simultanés), contactez votre gestionnaire de compte pour les options de mise à l'échelle.
Q : Vais-je perdre l'historique de mes chats WhatsApp si je redémarre le service ?
- Non. Le redémarrage du service préserve la session WhatsApp. Vous n'avez besoin de rescanner le code QR que si vous vous déconnectez explicitement.