WACB – Contacts commerciaux WhatsApp pour WooCommerce

1. Présentation

WACB est conçu pour les boutiques WooCommerce où un client peut avoir besoin d’échanger avec un commercial avant de finaliser un achat. Il convient aux catalogues avec vente assistée, distributeurs, grossistes, fournisseurs de matériaux de construction, catalogues immobiliers, vendeurs automobiles, boutiques d’électronique et sites WooCommerce avec plusieurs commerciaux.

2. Prérequis & compatibilité

WACB utilise des icônes SVG intégrées et n’ajoute aucune dépendance Font Awesome ni CDN externe d’icônes. Son fonctionnement côté public n’ajoute pas de dépendance jQuery propre à WACB.

3. Installation

1. Sauvegardez votre site WordPress avant d’installer ou de mettre à jour un plugin en production.
2. Dans l’administration WordPress, allez dans Extensions → Ajouter une extension → Téléverser une extension.
3. Sélectionnez le fichier ZIP installable de WACB fourni avec votre achat.
4. Cliquez sur Installer maintenant, puis Activer.
5. Vérifiez que WooCommerce est actif.
6. Ouvrez WACB Pro → Dashboard.

4. Démarrage rapide

1. Créez ou choisissez vos commerciaux. Utilisez des utilisateurs WordPress existants ou créez ceux qui doivent servir de contacts commerciaux publics.
2. Complétez leurs profils WACB. Ajoutez WhatsApp, téléphone, société, fonction, e-mail public, site web et autres champs publics utiles.
3. Autorisez la publication. Le profil d’un utilisateur doit être autorisé pour l’usage public avant d’alimenter les actions visibles par les clients.
4. Définissez un contact par défaut. Allez dans WACB Pro → Buttons & WhatsApp et choisissez l’utilisateur utilisé lorsqu’un produit n’a pas d’affectation spécifique.
5. Assignez les produits. Affectez un contact commercial public produit par produit ou via les outils de mise à jour en masse.
6. Activez les actions souhaitées. WhatsApp, Appeler, E-mail, Demander un devis, Partager, bloc produit et CTA flottant optionnel peuvent être configurés indépendamment.
7. Testez sur le site. Ouvrez un produit et vérifiez que chaque action utilise bien les coordonnées et le message attendus.

5. Utilisateurs WordPress comme contacts commerciaux

Les profils utilisateurs WordPress sont la source recommandée pour les contacts commerciaux visibles par les clients. Un utilisateur configuré dans WACB peut contenir des informations publiques telles que :

• Numéro WhatsApp
• Numéros de téléphone
• Société
• Fonction / rôle
• E-mail public
• Site web
• Liens sociaux pris en charge
• Message WhatsApp personnalisé
• Autorisation de publication

Si un produit hérite ses coordonnées d’un profil utilisateur, la mise à jour de ce profil permet au produit d’utiliser les nouvelles informations sans modifier le produit individuellement.

Les administrateurs peuvent gérer les réglages et affectations WACB. Les utilisateurs non administrateurs peuvent uniquement modifier leurs propres informations de profil WACB.

6. Affectation aux produits

Chaque produit WooCommerce peut utiliser un contact commercial public spécifique. Si aucun contact spécifique n’est affecté, WACB peut utiliser le contact global/par défaut configuré dans Buttons & WhatsApp.

Les champs au niveau du produit peuvent aussi remplacer certaines informations publiques héritées lorsqu’ils sont pris en charge.

Source / partenaire interne

Un produit peut aussi être relié à une fiche de relation privée pour le suivi interne. Cela reste séparé du contact commercial public. Exemple :

Contact commercial public : Équipe commerciale
Source interne : Fournisseur A

La relation interne n’est pas destinée à être affichée publiquement.

7. Boutons & WhatsApp

Allez dans WACB Pro → Buttons & WhatsApp pour contrôler les actions visibles par les clients.

Emplacements disponibles

• Boutons sur les cartes produits / boucles WooCommerce
• Bloc de contact sur la fiche produit
• Bouton flottant optionnel sur la fiche produit

Actions disponibles

• WhatsApp
• Appeler
• E-mail
• Demander un devis
• Partager

Les libellés peuvent être personnalisés dans les réglages.

Variables de message produit

Exemple :

Bonjour, je souhaite un devis pour {product_name} – {product_url}

8. Commande du panier WooCommerce via WhatsApp

La fonction de commande du panier est optionnelle et désactivée par défaut. Lorsqu’elle est activée, WACB ajoute une action WhatsApp qui transforme le panier en message prérempli contenant les articles, les quantités et le total.

Elle prend en charge :

• Le panier WooCommerce classique
• Le bloc Panier WooCommerce moderne
• L’état en direct des quantités et du total du bloc avant l’ouverture de WhatsApp
• Les attributs de variation sélectionnés dans les messages du panier classique et du bloc Panier lorsqu’ils sont disponibles (ex. : Couleur : Rouge, Taille : L)

Variables du message panier

Vous pouvez choisir un utilisateur destinataire spécifique pour les commandes du panier ou laisser la fonction utiliser le contact commercial par défaut.

9. Promotions & statuts commerciaux

Les badges promotionnels WACB sont des éléments de merchandising. Ils sont séparés du calcul des prix WooCommerce.

Pour chaque produit, vous pouvez configurer :

• Texte de promotion affiché publiquement dans le badge
• Couleur de promotion, avec la couleur globale en secours
• Style de promotion : carré, légèrement arrondi ou pilule/arrondi
• Date de début de promotion (facultative)
• Date de fin de promotion (facultative)
• Texte, couleur et style de statut commercial séparés
• Note interne privée

Lorsque des dates de début/fin sont définies, le badge n’est affiché que pendant la période configurée. Les badges WACB sont des libellés commerciaux et ne modifient pas les prix WooCommerce.

10. Mises à jour en masse

Le module de mise à jour en masse permet de modifier certains champs WACB sur plusieurs produits WooCommerce.

1. Filtrez les produits à modifier.
2. Prévisualisez le nombre de produits ciblés.
3. Sélectionnez uniquement les champs WACB à remplacer.
4. Lancez la mise à jour par lots raisonnables.
5. Contrôlez quelques produits après l’opération.

Les opérations en masse peuvent inclure l’affectation d’un utilisateur public, certaines relations internes, des coordonnées produit, les champs de promotion et les champs de statut.

Depuis la version 1.0.4, l’outil de masse ne charge ni ne stocke la liste complète des identifiants produits. Il conserve une définition de requête compacte et traite les produits correspondants par lots de 50 avec curseur, ce qui réduit la consommation mémoire sur les gros catalogues.

11. Répertoire privé de relations

WACB contient un répertoire séparé, réservé aux administrateurs, pour le suivi interne des relations commerciales. Les types pris en charge incluent notamment fournisseur, propriétaire, partenaire/apporteur, commercial externe, client, prospect, prestataire et autre.

Selon le type de relation, les fiches peuvent contenir des coordonnées et informations métier telles que responsable interne, source, informations de suivi, valeur estimée, liens vers catalogue/documents, conditions commerciales, paiement/logistique, commissions, commentaires/historique et notes.

Ces fiches ne servent pas de contacts publics des produits.

12. Apparence

Allez dans WACB Pro → Appearance pour adapter les contrôles WACB à votre boutique.

• Couleur du CTA WhatsApp
• Couleur du CTA téléphone
• Couleur du CTA devis
• Couleur du badge promotionnel
• Style du badge : légèrement arrondi, pilule ou angles carrés
• Option d’affichage du nom et de la société du commercial sur les fiches produits

WACB inclut des styles défensifs pour ses icônes et boutons afin de réduire les conflits avec les thèmes et modules produits générés dynamiquement par les constructeurs de pages.

13. Intégrations & événements analytics

WACB n’installe ni Google Analytics ni Meta Pixel. Il peut émettre des événements dataLayer qu’une configuration existante d’analytics ou de gestionnaire de balises peut écouter.

Les scripts de suivi restent ainsi sous le contrôle du propriétaire du site.

14. Shortcodes

WACB inclut les shortcodes suivants :

[wacb_user_card id="12"]
[wacb_user_products user="12" limit="12"]

Remplacez 12 par l’identifiant utilisateur WordPress approprié. Ajustez limit pour contrôler le nombre de produits retournés par le shortcode des produits d’un utilisateur.

15. Langues & traduction

• L’anglais est la langue source.
• Les fichiers de traduction française (fr_FR) sont inclus.
• Un fichier wacb-pro.pot est fourni pour les flux de traduction WordPress gettext standards.
• Des outils comme Loco Translate ou Poedit peuvent être utilisés pour créer d’autres traductions.
• L’interface d’administration suit la langue de WordPress.
• Les libellés et messages personnalisés enregistrés dans les réglages WACB sont du contenu saisi par l’utilisateur et ne se traduisent pas automatiquement lorsque la langue du site change.

16. Import ancien, mises à jour & désinstallation

Import des anciennes données

Si des métadonnées compatibles issues d’une ancienne/version privée de WACB sont détectées, allez dans WACB Pro → Tools & diagnostics. L’import ancien est manuel. Il copie les valeurs prises en charge vers des métadonnées préfixées WACB et laisse les métadonnées d’origine inchangées.

Les anciennes métadonnées ne sont pas utilisées automatiquement sur le site public.

Mise à jour

Sauvegardez le site avant une mise à jour. La distribution WPBay utilise le SDK officiel WPBay pour les mises à jour automatiques. WACB 1.0.4 déplace aussi la migration de l’ancien modèle de contacts privés hors de la requête d’activation/mise à jour : la conversion est effectuée par lots planifiés de 100 afin de réduire le risque de dépassement mémoire ou de timeout sur les gros sites.

Désinstallation

Désactiver WACB ne supprime pas ses données. La suppression complète des données WACB lors de la désinstallation est optionnelle et doit être explicitement activée sous Tools & diagnostics → Data on uninstall avant la désinstallation.

17. Licence WPBay & mises à jour automatiques

WACB utilise le SDK officiel WPBay pour l’activation par code d’achat, la vérification de licence, le contrôle du nombre d’activations et les mises à jour automatiques.

1. Après installation et activation de WACB, ouvrez WACB dans l’administration WordPress.
2. Saisissez le code d’achat WPBay associé à votre commande.
3. WPBay valide le code pour le site actuel et contrôle le nombre d’activations autorisées par la licence achetée.
4. Après activation réussie, toutes les fonctions d’administration et d’affichage de WACB deviennent disponibles.

Les licences invalides ou révoquées sont revérifiées périodiquement par le SDK officiel WPBay. Les mises à jour WACB sont ensuite proposées dans l’interface habituelle de mise à jour des extensions WordPress lorsqu’elles sont disponibles.

Conditions WPBay : wpbay.com/terms-and-conditions/
Politique de confidentialité WPBay : wpbay.com/privacy-policy/

18. Dépannage

Les boutons sont sans style ou les icônes sont très grandes

1. Vérifiez que vous utilisez la version actuelle de WACB.
2. Videz le cache WordPress.
3. Videz le cache CSS généré par le thème/constructeur de pages si nécessaire.
4. Effectuez un rafraîchissement forcé du navigateur.

WACB inclut un chargement défensif des ressources front-end et un dimensionnement protégé des icônes pour les modules produits dynamiques, notamment les mises en page WooCommerce de type Divi.

Le bouton WhatsApp n’apparaît pas

• Vérifiez que WhatsApp est activé dans Buttons & WhatsApp.
• Vérifiez que l’utilisateur commercial sélectionné possède un numéro WhatsApp valide.
• Vérifiez que son profil WACB est autorisé pour la publication.
• Si aucun contact n’est affecté au produit, vérifiez qu’un contact par défaut est configuré.

Le bouton panier WhatsApp n’apparaît pas

• Vérifiez que Order cart via WhatsApp est activé.
• Assurez-vous que le panier contient au moins un produit.
• Videz les caches de page/blocs après modification des réglages WACB.

Un badge promotionnel apparaît mais le prix du produit ne change pas

C’est normal. Les badges promotionnels WACB sont des libellés commerciaux/merchandising et ne modifient pas automatiquement les prix WooCommerce.

Les changements ne sont pas visibles après une mise à jour

Videz les caches/minifications, le cache CSS du constructeur de pages, le cache du navigateur et le cache CDN si vous en utilisez un.

19. Support

Pour les questions liées à l’installation, la configuration, la compatibilité ou les bugs du produit, utilisez le canal de support/contact disponible sur la page du produit dans la marketplace.

Lorsque vous demandez de l’aide, indiquez :

• Version de WACB
• Version de WordPress
• Version de WooCommerce
• Version de PHP
• Nom du thème/constructeur de pages si pertinent
• Étapes pour reproduire le problème
• Capture d’écran si le problème est visuel

Éditeur : VentureSage · URI du plugin : https://venturesages.com/

20. Journal des modifications

Version 1.0.4

• L’outil de mise à jour en masse découvre et traite désormais les produits par lots de 50 avec curseur, sans stocker toute la liste des identifiants.
• La migration des contacts privés lors d’une mise à jour fonctionne maintenant par lots planifiés de 100 au lieu de parcourir tout le catalogue pendant l’activation/mise à jour.
• L’import ancien, le chargement des options de contacts et le nettoyage à la désinstallation ont été rendus plus économes en mémoire.
• Les métadonnées de version du plugin, du readme, de la documentation et des traductions ont été synchronisées sur 1.0.4.

Version 1.0.3

• Correction de la redirection d’activation du SDK WPBay avec le chemin admin relatif attendu par le SDK 1.0.7.
• Ajout des attributs de variation sélectionnés aux messages WhatsApp du panier WooCommerce classique, comme pour le bloc Panier.

Version 1.0.2

• Introduction d’un seul texte public de promotion avec couleur, style, date de début et date de fin optionnels par produit.
• Conservation des anciennes métadonnées de promotion pour compatibilité.

Version 1.0.1

• Ajout des champs structurés de dates de promotion et amélioration de l’édition en masse.

Version 1.0.0

• Première version publique stable.
• Contacts commerciaux WooCommerce publics ; actions WhatsApp, téléphone, e-mail, devis et partage.
• Commande du panier via WhatsApp (classique et bloc), badges promotion/statut, outils de masse et répertoire de relations privées.
• Déclarations de compatibilité HPOS et blocs Panier/Paiement.
• Correctifs de compatibilité front-end Divi et constructeurs de pages dynamiques.
• Intégration du SDK officiel WPBay pour l’activation, les limites d’activation, la vérification et les mises à jour automatiques.