WiB2B | Wikha Hi-Tech
WiB2B est une plateforme logicielle SaaS B2B multi-tenant qui agit comme un hub de communication centralisé via l'API officielle WhatsApp Business. Elle intègre un CRM dopé à l'Intelligence Artificielle pour automatiser les interactions clients. La solution se démarque par son interface premium à marque blanche et son système de micro-facturation à l'usage (Pay-As-You-Go), nativement compatible avec les cartes bancaires internationales et les systèmes de Mobile Money africains.
WiB2B
Description: WiB2B est une plateforme logicielle SaaS B2B multi-tenant qui agit comme un hub de communication centralisé via l'API officielle WhatsApp Business. Elle intègre un CRM dopé à l'Intelligence Artificielle pour automatiser les interactions clients. La solution se démarque par son interface premium à marque blanche et son système de micro-facturation à l'usage (Pay-As-You-Go), nativement compatible avec les cartes bancaires internationales et les systèmes de Mobile Money africains.
Contexte détaillé
**WiB2B** est une plateforme logicielle en mode **SaaS (Software as a Service) B2B multi-tenant** haut de gamme. Elle fusionne un **Hub de communication centralisé** exploitant l'infrastructure officielle de l'API WhatsApp Business avec un système **CRM (Customer Relationship Management)** augmenté par l'Intelligence Artificielle. ### Public Cible et Segment de Marché La plateforme est spécifiquement architecturée pour : * Les moyennes et grandes entreprises exigeant une gouvernance stricte de leurs interactions clients. * Les agences marketing gérant des campagnes de diffusion de masse à forte valeur ajoutée. * Les départements de support client nécessitant l'automatisation de premier niveau (Niveau 1) sans perte de qualité relationnelle. ### Proposition de Valeur Unique (UVP) WiB2B élimine la friction technique liée à l'adoption de l'API Meta WhatsApp Business en proposant un déploiement instantané, une interface utilisateur premium à marque blanche, et un moteur de micro-facturation à l'usage (**Pay-As-You-Go**) nativement compatible avec les infrastructures financières internationales (cartes de crédit) et locales (systèmes **Mobile Money africains**). --- ## 3. Matrice Fondamentale des Fonctionnalités (Core Features Deep Dive) ### 3.1 Inbox Omnicanal et CRM WhatsApp Collaboratif * **Centralisation Métier :** Permet la connexion d'un numéro d'entreprise unique WhatsApp Business officiel, distribué en temps réel vers une multitude d'agents humains simultanés. * **Synchronisation et Persistance :** Le moteur de persistance garantit une réplication des messages en temps réel avec un typage fort (texte, médias enrichis, documents, statuts de lecture `sent`, `delivered`, `read`). * **Qualification de Prospects :** Intégration de pipelines de gestion des leads à l'intérieur de la vue de chat (balisage dynamique, champs personnalisés par locataire, assignation automatique d'agents basée sur la charge de travail). ### 3.2 IA Orchestrator (Propulsé par Google Gemini) L'intelligence artificielle est intégrée de façon structurelle au niveau du traitement des flux de messages entrants via l'API Google Gemini (modèles optimisés **Gemini Pro** et **Gemini Flash**). * **Analyse d'Intention (Intent Parsing) :** Chaque message entrant subit une classification sémantique immédiate pour déterminer l'urgence, le sentiment et la catégorie de la demande. * **Contextualisation RAG :** Le système extrait l'historique récent du client et les métadonnées du locataire pour enrichir le prompt soumis au modèle. * **Génération de Brouillons RAG (Draft Generation) :** Au lieu d'envoyer des réponses autonomes non contrôlées, l'IA prépare des suggestions de réponses ultra-contextuelles au sein de la boîte de réception, prêtes à être validées ou éditées par l'agent humain, optimisant le temps de réponse de 70%. ### 3.3 API REST de Messagerie Programmatique La plateforme expose une API de production robuste et hautement sécurisée permettant l'interfaçage de systèmes tiers (ERP, plateformes E-Commerce, applications bancaires Core Banking). * **Authentification :** Sécurisée par des clés d'API opaques et révocables, préfixées structurellement par `wib2b_live_` pour la production et `wib2b_test_` pour les environnements de sandbox. * **Cas d'Usage Typiques :** Envoi automatique de notifications de livraison, authentification à deux facteurs (OTP WhatsApp), relevés de compte instantanés et alertes de sécurité système. ### 3.4 Moteur de Campagnes Massives (Bulk Marketing Engine) * **Orchestration des Volumes :** Capacité d'injecter des files d'attente massives de messages marketing sans risque de bannissement, grâce au respect strict des politiques de Meta et à l'utilisation exclusive de **Templates de Messages Officiels approuvés**. * **Segmentation Avancée :** Création dynamique de segments d'audience basés sur le comportement d'achat ou l'historique CRM. * **Prévision Algorithmique des Coûts :** Avant l'initialisation de toute campagne, un algorithme interne calcule le coût exact estimé de l'opération en croisant les grilles tarifaires Meta de la zone géographique cible avec le coût d'infrastructure WiB2B, évitant ainsi tout dépassement budgétaire. ### 3.5 Wallet Interne Bi-Devise (Real-Time Micro-Billing) Le cœur de la rentabilité et du contrôle des coûts repose sur un système transactionnel propriétaire. * **Architecture Bi-Devise :** Gestion unifiée des soldes en Dollars Américains (USD) et en Devises Locales (ex: Franc Congolais - CDF). * **Déduction Dynamique au Token :** Chaque interaction consomme une fraction de centime d'unité monétaire calculée en temps réel selon deux axes : 1. *Frais Meta :* Typologie de la conversation (Catégories *Utility*, *Authentication*, *Service*, *Marketing*). 2. *Frais IA :* Volume de tokens d'entrée/sortie consommés par les modèles Gemini. ### 3.6 Interface Marque Blanche Dynamique (White-Label UI) * **Abstraction de l'Identité Visuelle :** L'UI s'adapte en temps réel à l'identité de marque du client. * **Génération de Thème Avancée :** En exploitant le moteur **Material Design 3**, le chargement de l'espace de travail d'un locataire (*Tenant*) extrait ses couleurs primaires (via logo ou configuration) pour générer dynamiquement une palette de couleurs harmonieuse, incluant la gestion automatique des contrastes et des modes sombre/clair. --- ## 4. Architecture Système & Flux de Données (Architectural Blueprint) L'écosystème WiB2B est conçu sur une architecture découplée assurant une tolérance aux pannes maximale et des temps de latence minimaux. ### 4.1 La Pile Technologique (Technology Stack) * **Frontend (Multiplateforme) :** Développé avec le SDK **Flutter**, garantissant une exécution native fluide à 60 FPS sur le Web et les applications Mobiles, respectant les contraintes ergonomiques modernes. * **Backend (Serverless Scalable) :** Propulsé par la suite de services **Firebase**. * *Firestore :* Base de données NoSQL structurée orientée documents, configurée pour l'isolation stricte des données par identifiant de locataire (`tenantId`). * *Cloud Functions (TypeScript) :* Microservices backend isolés gérant l'intégration de l'API Meta, l'orchestration de l'IA, les webhooks entrants et la logique métier transactionnelle. ### 4.2 Schéma de Flux de Données (Data Flow Sequence) Le diagramme suivant modélise le cycle de traitement d'un message entrant, de sa réception sur les serveurs de Meta jusqu'à la notification de l'interface client WiB2B : ``` [Client Final] --(Message WhatsApp)--> [Serveurs Meta Cloud API] │ (HTTPS Webhook) ▼ [Firebase Cloud Functions] │ ┌─────────────────────────────┴─────────────────────────────┐ ▼ ▼ [Vérification du Solde Client] [Extraction Contexte CRM] │ │ (Solde OK : Déduction) (Historique + Données) │ │ └─────────────────────────────┬─────────────────────────────┘ ▼ [IA Orchestrator: Gemini] │ (Génération du Brouillon) ▼ [Firestore DB (Persistance)] │ (Stream Temps Réel) ▼ [App Application Flutter UI] ``` ### 4.3 Sous-système de Facturation : Intégration WikhaPay SDK Pour garantir une parfaite adéquation avec le marché de l'Afrique Subsaharienne (et particulièrement la République Démocratique du Congo), l'approvisionnement du Wallet s'effectue via le **SDK WikhaPay**. Ce module abstrait la complexité des passerelles bancaires et connecte directement la plateforme aux principaux opérateurs de monnaie mobile : * **M-Pesa** (Vodacom) * **Airtel Money** (Airtel) * **Orange Money** (Orange) * **Afrimoney** (Africell) --- ## 5. Spécifications Techniques de l'API REST de Messagerie Programmatique ### 5.1 Envoi de Message Transactionnel Baseline * **Endpoint :** `POST https://wib2b.wikha-hitech.com/v1/messages/send` * **Headers requis :** ```http Authorization: Bearer wib2b_live_7f82a1bc3d9e4a5eb62c810f293d84a1 Content-Type: application/json ``` #### Payload de Requête (JSON) ```json { "to": "+243810000000", "type": "text", "text": { "body": "Cher client, votre paiement pour la facture #SRH-2026-004 a été validé avec succès par le module SuperDRH. Merci pour votre confiance." }, "tenantId": "tenant_wikha_corporate_9921", "metadata": { "system_origin": "SuperDRH_Billing_Module", "external_reference_id": "inv_882910" } } ``` #### Réponse de Succès (2020 Accepted) ```json { "success": true, "messageId": "wib2b_msg_9a8b7c6d5e4f3a2b", "status": "queued", "timestamp": "2026-05-17T12:19:32Z", "billing": { "estimatedCostUSD": 0.014, "currencyUsed": "USD", "remainingWalletBalanceUSD": 245.82 } } ``` --- ## 6. Guide de Configuration & d'Intégration Opérationnelle (User & Developer Journey) Le déploiement et l'activation d'un environnement opérationnel WiB2B suivent un parcours séquentiel rigoureux de 4 étapes clés : ### Étape 1 : Initialisation et Isolation du Locataire (Tenant Creation) * L'entité administrative crée un compte maître sur la plateforme. * Renseignement des informations légales de l'organisation. * Téléversement des assets graphiques (logos, chartes). Le système Material Design 3 compile instantanément l'interface pour correspondre au branding de l'entreprise. ### Étape 2 : Couplage de l'Infrastructure Meta WhatsApp Business * L'utilisateur est redirigé vers le flux d'authentification officiel Meta for Developers. * Sélection ou création du compte WhatsApp Business (WABA). * Approbation des permissions d'acheminement des flux de messages vers les webhooks managés de WiB2B. Le numéro devient immédiatement actif et monitoré par le backend Firebase. ### Étape 3 : Approvisionnement Sécurisé du Portefeuille (Wallet Top-up) * Accès à la console financière de la plateforme. * Sélection du montant à charger (devises gérées : USD ou CDF). * Sélection de la méthode de paiement via l'interface unifiée du SDK WikhaPay. * Validation du paiement (via saisie du code PIN secret Mobile Money sur le terminal mobile de l'utilisateur ou via authentification 3D-Secure de la carte de crédit). Le solde est crédité de manière synchrone en moins de 10 secondes. ### Étape 4 : Activation des Interfaces de Consommation Le locataire répartit alors ses accès selon deux profils d'utilisation distincts : 1. **Usage Opérationnel Commercial :** Les agents se connectent à l'interface collaborative **Inbox** de Flutter. Ils engagent la conversation avec les clients finaux en s'appuyant sur les pré-générations contextuelles fournies en temps réel par les modèles de langage Google Gemini. 2. **Usage Technique Intégrateur :** L'équipe technique accède au panneau développeur, procède à la génération unique des clés secrètes `wib2b_live_***`, configure les adresses de callback pour la réception des webhooks de statut de message, et interconnecte les applications propriétaires avec les endpoints de l'API REST WiB2B. --- ## 7. Spécifications de l'Interface Utilisateur (Design System Matrix) Pour maintenir un standard esthétique très haut de gamme ("Ultra-Premium UI"), l'interface graphique de WiB2B obéit à des règles de rendu strictes, implémentées nativement dans le framework Flutter : * **Design Paradigm :** Combinaison poussée de **Liquid Design** (transitions organiques fluides basées sur des courbes d'animation de type *Emphasized Decelerate*) et de **Glassmorphism**. * **Règles d'Effet de Verre (Glassmorphic Rules) :** * *Backdrop Filter :* Flou gaussien arrière-plan fixé impérativement entre `15.0` et `25.0` pixels de rayon. * *Opacité de Surface :* Conteneurs blancs ou teintés appliqués avec une opacité variant strictement entre `0.65` et `0.80`. * *Bordures :* Micro-bordures de `1.0` point d'épaisseur avec un dégradé linéaire subtil simulant la réfraction de la lumière. * **Gestion des Fenêtres et de l'Espace :** Bannissement total des fenêtres modales classiques au centre de l'écran qui interrompent le flux de travail. Toutes les actions contextuelles secondaires, les formulaires de configuration et les vues de détails d'un contact s'ouvrent via des composants **Premium Bottom Sheets** (panneaux coulissants depuis le bas de l'écran), maintenant l'arrière-plan visible, flouté et dynamique.
