Documentation KSIDol > Modules KSIDol > WhatsApp (KsiWhatsapp)
Notice du module WhatsApp (KsiWhatsapp)
Guide d'utilisation non technique : à quoi sert le module, comment l'utiliser et comment il s'articule avec Dolibarr.
Objets couvertsDevis, commandes, factures
CanalWhatsApp Web
Formulaire d'envoi100 % natif Dolibarr
CompatibilitéDolibarr 24.0
1. Presentation du module
Le module WhatsApp ajoute un bouton « Envoyer par WhatsApp » sur les fiches des devis, des commandes clients et des factures validées. Il réutilise exactement le formulaire natif « Envoyer par mail » de Dolibarr : les destinataires, les modèles d'e-mail et les pièces jointes restent ceux de Dolibarr, rien n'est réimplémenté. Un second bouton, ajouté dans ce formulaire, transforme le message composé — sujet, corps converti en texte brut et lien de téléchargement public du PDF — en lien WhatsApp Web ouvert dans un nouvel onglet. L'envoi reste entièrement manuel et ne repose sur aucun service externe : pas d'API WhatsApp Business, pas de compte tiers, pas de clé.
- Un bouton « Envoyer par WhatsApp » apparaît à côté des boutons d'action natifs des devis, commandes clients et factures.
- Le formulaire d'envoi est 100 % natif Dolibarr : le module n'y modifie rien, il y ajoute seulement un bouton supplémentaire.
- Le message WhatsApp reprend le sujet et le corps composés dans le formulaire (modèles d'e-mail natifs compris), convertis en texte brut, suivis d'un lien de téléchargement du document PDF.
- WhatsApp Web s'ouvre dans un nouvel onglet avec le message prérempli : c'est l'utilisateur qui déclenche l'envoi, rien n'est automatique.
- Aucune API WhatsApp Business, aucun compte tiers, aucune clé : zéro service externe.
2. Installation et activation
L'installation suit le circuit habituel des modules Dolibarr ; l'activation prépare automatiquement tout ce qui est nécessaire au fonctionnement du lien de téléchargement.
- Dézipper l'archive du module dans le répertoire htdocs/custom/ de Dolibarr.
- Activer le module « KsiWhatsapp » dans Configuration → Modules/Applications.
- Le module natif « Réseaux sociaux » est activé automatiquement : c'est lui qui porte le champ WhatsApp de la fiche tiers.
- L'entrée « whatsapp » du dictionnaire des réseaux sociaux est créée ou réactivée si nécessaire.
- À l'activation, les trois autorisations de téléchargement externe (factures, propositions commerciales, commandes) sont posées : elles sont nécessaires au lien public joint au message.
- Le module ne crée aucun menu : la configuration s'ouvre par l'engrenage de la ligne du module, dans la liste des modules (accès administrateur).
3. Paramétrage
La page de configuration regroupe quatre réglages, tous préremplis à l'activation du module.
- URL de WhatsApp Web : l'adresse utilisée pour composer le message (par défaut https://web.whatsapp.com/send?).
- Autoriser le téléchargement externe des factures : nécessaire pour que le lien envoyé par WhatsApp permette de télécharger la facture.
- Autoriser le téléchargement externe des propositions : nécessaire pour que le lien envoyé par WhatsApp permette de télécharger le devis.
- Autoriser le téléchargement externe des commandes : nécessaire pour que le lien envoyé par WhatsApp permette de télécharger la commande.
4. Utilisation au quotidien
Le bouton « Envoyer par WhatsApp » apparaît sur la fiche de l'objet dans les mêmes conditions que le bouton natif d'envoi par e-mail : statut adapté et droits d'envoi respectés.
- Factures : bouton affiché sur une facture validée ou payée ; les avoirs sont exclus.
- Devis : bouton affiché sur un devis validé ou signé.
- Commandes clients : bouton affiché sur une commande validée ou acceptée.
- Les droits d'envoi natifs de Dolibarr sont respectés : un utilisateur qui ne peut pas envoyer l'objet par e-mail ne peut pas non plus l'envoyer par WhatsApp.
- Si aucun numéro exploitable n'est trouvé, le bouton s'affiche grisé, comme le bouton natif quand le tiers n'a pas d'adresse e-mail.
- Déroulé : cliquer sur « Envoyer par WhatsApp » ouvre le formulaire d'envoi natif ; choisir éventuellement un modèle d'e-mail, ajuster le sujet et le message, puis cliquer sur le second bouton « Envoyer par WhatsApp » : WhatsApp Web s'ouvre dans un nouvel onglet avec le message et le lien de téléchargement.
- Le bouton reste présent après l'application d'un modèle d'e-mail ou l'ajout d'une pièce jointe dans le formulaire.
5. Numéro de destination
Le module recherche le meilleur numéro disponible puis le normalise avant de composer le lien WhatsApp.
- Ordre de recherche : champ WhatsApp de l'onglet Réseaux sociaux du tiers, puis téléphones du tiers (mobile, fixe, personnel), puis téléphones portés par le document lui-même.
- Le numéro retenu est normalisé en chiffres : seuls les numéros de 8 à 15 chiffres sont acceptés.
- Recommandation : saisir les numéros au format international (+33…) ; sans le module KSI SendSMS, aucun indicatif n'est ajouté automatiquement.
- Si le module KSI SendSMS est installé, l'indicatif international est complété automatiquement.
6. Lien de téléchargement du document
Le message WhatsApp se termine par un lien qui permet au destinataire de télécharger le PDF du document.
- Le lien réutilise le lien de partage public du PDF déjà généré, tel qu'il existe dans la GED de Dolibarr.
- Si le PDF n'existe pas encore ou n'a pas de lien de partage, le message part sans lien : générer le document avant l'envoi.
- Les trois autorisations de téléchargement externe posées à l'activation permettent au destinataire de télécharger le document depuis ce lien.
7. Questions fréquentes
Les réponses aux questions les plus courantes sur le fonctionnement du module.
- L'envoi est-il automatique ? Non : le module prépare le message et ouvre WhatsApp Web ; l'envoi se fait toujours manuellement.
- Le PDF est-il joint au message ? Non : le message contient un lien de téléchargement du document.
- Pourquoi le bouton est-il grisé ou absent ? Grisé : aucun numéro exploitable n'a été trouvé sur le tiers ou le document. Absent : le statut du document ne permet pas l'envoi, ou l'utilisateur n'a pas le droit d'envoyer.
- Les avoirs sont-ils couverts ? Non, les avoirs sont exclus.
- Le module modifie-t-il le formulaire d'envoi natif ? Non : il y ajoute seulement un bouton ; destinataires, modèles d'e-mail et pièces jointes restent gérés par Dolibarr.
8. Prérequis
Les éléments nécessaires au fonctionnement du module.
- Dolibarr 24.0.
- PHP 8.1.
- Module natif « Réseaux sociaux » (activé automatiquement avec le module).
- Modules Factures, Devis et/ou Commandes selon l'usage souhaité.
- JavaScript activé dans le navigateur (le bouton ajouté au formulaire d'envoi en dépend).
9. Liaisons avec Dolibarr
Le module ne fonctionne pas en vase clos : il s'articule avec les briques natives de Dolibarr.
- Tiers (réseaux sociaux et téléphones) : Le numéro de destination provient en priorité du champ WhatsApp de l'onglet Réseaux sociaux de la fiche tiers, puis des téléphones du tiers (mobile, fixe, personnel), et enfin de ceux portés par le document.
- Factures, devis et commandes clients : Le bouton « Envoyer par WhatsApp » s'ajoute sur les fiches de ces trois objets, dans les mêmes conditions de statut et de droits que le bouton natif d'envoi par e-mail ; les avoirs sont exclus.
- Formulaire d'envoi par e-mail et modèles : Le module réutilise le formulaire natif « Envoyer par mail » de Dolibarr, avec ses destinataires, ses modèles d'e-mail et ses pièces jointes, sans le modifier : il y ajoute uniquement un bouton supplémentaire.
- Documents (GED) : Le lien de téléchargement du message s'appuie sur le lien de partage public du PDF déjà généré et enregistré dans la GED de Dolibarr.
- Module Réseaux sociaux : Dépendance native du module, activée automatiquement : il porte le champ WhatsApp de la fiche tiers et le dictionnaire des réseaux sociaux, dont l'entrée « whatsapp » est garantie à l'activation.
- Multi-entités : Le cloisonnement multi-entités est respecté : le bouton n'agit que sur les documents de l'entité courante et le lien de téléchargement est construit à partir du répertoire de documents de l'entité de l'objet.
