🤖 AGENT IA WHATSAPP & CRM DOCKERISÉ — FICHE TECHNIQUE GLOBALE

01🏛️ 1. Les Forces Majeures du Système (Our Strengths)

* **Zéro-Friction & Intégration Native** : L'agent interagit directement sur WhatsApp sans API Cloud payante (basé sur `whatsapp-web.js` + Chromium headless), permettant des économies d'échelle massives. * **Extraction Sémantique Active** : Propulsé par Google Gemini Flash Lite, le système ne se contente pas de répondre ; il extrait automatiquement et discrètement les informations clés (Nom, Niche, Budget, Potentiel, Besoins) et met à jour le profil. * **Double Mode Cognitif** : * *Mode Acquisition (Prospects)* : Qualifie, présente l'agence, négocie les prix et ferme la vente par virement. * *Mode Customer Success (Clients Actifs)* : Suit les livrables, rassure, et planifie les relances (`[SET_FOLLOWUP]`). * **Isolation Zero-Trust (Docker)** : Microservices cloisonnés par réseaux internes étanches, avec reverse-proxy Traefik gérant le routage SSL automatique pour `panel.ettaoulyabdelali.com` et `whatsapp.ettaoulyabdelali.com`.

---

02🚀 2. Les Avantages Business pour l'Agence

1. **Closing Augmenté & Qualification BANT** : Plus aucun prospect n'est laissé sans réponse. L'IA filtre les curieux et concentre l'attention d'Abdelali uniquement sur les leads qualifiés à haut potentiel. 2. **Pas d'Effet "Low-Cost" (Price Power)** : Grâce aux règles de ciblage par calibre, l'IA adapte ses offres. Elle propose des packs d'entrée à 700 DH aux artisans locaux, mais pitche des architectures à 5 000 DH - 15 000 DH (SaaS Next.js, Programmatic SEO Nuke™, Swarms d'agents) aux entreprises établies. 3. **Facturation Instantanée (Billing Automatisé)** : Envoi propre des coordonnées bancaires (RIB CIH Bank / Cash Plus) dès acceptation du devis, avec mise à jour immédiate du statut de facturation dans le CRM. 4. **Relances Chirurgicales en Darija** : Réduction du taux d'abandon grâce au bouton "Relancer via IA". L'IA étudie l'historique et rédige un message de relance marquant et concis (1-2 phrases) en Darija marocaine raffinée avec des termes business.

---

03🎭 3. Les Rôles Clés de l'Agent IA

* **Le Qualificateur** : Détecte si le prospect possède déjà : * 🗺️ Une fiche Google Maps (GMB) * 🏷️ Un logo ou une identité visuelle * 🌐 Un site internet ou une landing page * **Le Commercial / Négociateur** : Présente le catalogue de services (Développement Next.js, SEO de Guerre, IPTV, AI call centers) et applique une négociation psychologique basée sur les techniques de Chris Voss (miroirs, étiquettes). * **Le Secrétaire / Trésorier** : Partage les RIBs et met à jour les indicateurs de paiement (`unpaid` ➔ `pending` ➔ `paid`). * **L'Agent Spécial RH (Filtrage Candidats)** : Détecte immédiatement les demandes de stage ou d'emploi, les redirige poliment vers `[email protected]`, et baisse leur priorité dans le CRM pour ne pas polluer le pipeline client.

---

04Phase 1 : Fondation & Connectivité WhatsApp (Début)

* Initialisation du service Node.js indépendant (`whatsapp-neural-agent`). * Connexion réussie à l'application WhatsApp Web via Puppeteer en mode Headless Chromium. * Mise en place de la persistance locale des sessions (`.wwebjs_auth`) et de la base de données brute dans `data/crm_db.json`.

05Phase 2 : Intégration de l'Intelligence Sémantique (Gemini)

* Connexion du bot à l'API Gemini Flash Lite avec un prompt système de 43 000 caractères intégrant toute l'expertise d'Ettaouly Digital. * Création de la fonction d'extraction sémantique (`extractInfoWithGemini`) pour analyser l'historique et remplir les fiches contacts (Nom, Secteur, Budget, Notes). * Implémentation d'une API d'analyse à la demande et d'une tâche de traitement par lot (Batch Processing) pour analyser 100+ profils vides en arrière-plan.

06Phase 3 : Création du CRM Dashboard & Design Premium Carbon

* Développement du panneau d'administration Next.js (`/agent`). * Design UX Bento Premium en mode sombre : division 70/30 (Tableau principal à gauche, 3 Widgets opérationnels à droite : Appels Urgents, Négociations du Jour, Situation & Objectifs). * Résolution des problèmes d'affichage CSS (implémentation de Sticky Headers 100% fonctionnels lors du défilement des leads).

07Phase 4 : Sécurisation & Communication Inter-Services

* Mise en place d'un pont API Gateway dans Next.js. * Sécurisation renforcée : validation des requêtes administratives par jeton JWT (`admin_session`) et authentification inter-conteneurs par clé secrète partagée (`INTERNAL_WORKER_SECRET`).

08Phase 5 : Grille Tarifaire Flex, Billing RIB & Relance Darija

* Ajout de 4 nouveaux critères graphiques d'évaluation marketing (`hasMaps`, `hasBrand`, `hasWebsite`, `paymentStatus`) sous forme d'icônes compactes (🗺️, 🏷️, 🌐, 💳) dans le CRM. * Ajout de sélecteurs de filtres interactifs dans les en-têtes de colonnes. * Implémentation de la saisie manuelle et de la sauvegarde des indicateurs dans le Contact Drawer. * Ajout du bouton de relance personnalisée en Darija marocaine persuasive. * Résolution du bug critique de démarrage Chromium (`SingletonLock` Code 21) sur le VPS.

09Phase 6 : Moteur de Mutil-Mise à Niveau & Synchronisation Massive (Aujourd'hui)

* Mise à niveau de l'initialisation : scan et enregistrement instantanés de **tous les JIDs de la boîte (1,134 chats détectés)** dans le CRM au lieu des 100 premiers. * Implémentation d'un synchroniseur en arrière-plan (`startBacklogSync`) qui traite les 1034 contacts restants de manière asynchrone (1.5s d'intervalle) pour récupérer leurs avatars, historiques de messages, et données de profils professionnels (adresse, site web). * Intégration de l'argumentaire de vente haut de gamme (Programmatic SEO Nuke™, ERPs Next.js/Laravel, IPTV infrastructures en Go, Twilio Call Centers) pour cibler les prospects à forte valeur de 5 000 DH à 35 000 DH sans dévaluer l'agence.

--- *Fiche technique établie et mise à jour pour Ettaouly Digital - Juin 2026.*