Module WhatsApp Notify

WhatsApp Notify est un module complémentaire pour Dolibarr ERP/CRM qui envoie les factures et les relances de paiement directement sur le WhatsApp des clients, depuis Dolibarr, via l'API Cloud officielle de Meta (messages template approuvés, envoi serveur, statuts de livraison). Il ne s'agit ni d'un lien « web.whatsapp » à ouvrir manuellement, ni d'une passerelle tierce payante.

Éditeur	arcchester
Licence	GPL v3
Compatibilité Dolibarr	18.0 à 23.x
PHP	7.4 minimum (extension cURL)
Dépendances	Aucune (cURL pur : pas de Composer, pas de SDK)
Distribution	Fiche sur le Dolistore

Fonctionnalités

Bouton « Envoyer sur WhatsApp » sur la fiche facture, avec badge d'état coloré.
Envoi automatique optionnel dès la validation de la facture (déclencheur BILL_VALIDATE).
PDF de la facture en pièce jointe du message WhatsApp (template avec en-tête Document).
Suivi de livraison en temps réel : envoyé / livré / lu / échec — mis à jour par le webhook Meta (signature HMAC-SHA256 vérifiée).
Message template à 3 variables : nom du client, référence de la facture, montant TTC.
Numéros internationaux : normalisation automatique au format E.164, indicatif par défaut configurable pour les numéros locaux.
Traçabilité : chaque envoi est journalisé en base (identifiant de message Meta, statut, date).
Interface et documentation en français et en anglais.

Prérequis Meta (une seule fois, ~10 minutes)

Le module utilise l'API Cloud officielle — il faut donc un compte Meta :

Un compte Meta Business (gratuit) et une application de type « Business ».
Un numéro WhatsApp Business relié à l'API Cloud (un numéro de test est fourni gratuitement par Meta pour les essais).
Un jeton d'accès permanent (System User) — Meta > Business Settings > Users > System users.
Un template de message approuvé : le texte prêt à copier est fourni avec le module ; l'approbation Meta prend en général moins de 24 h.

Note : Meta facture à la conversation/au message (directement à Meta). L'ouverture du compte et le premier template sont gratuits.

Installation

Télécharger le zip module_whatsappnotify-x.y.z.zip depuis le Dolistore.
Dans Dolibarr : Accueil → Configuration → Modules/Applications → Déployer/installer un module externe et sélectionner le zip.
Activer le module WhatsApp Notify dans la liste des modules (famille « Interfaces avec des systèmes externes »).
Aucune dépendance à installer sur le serveur.

Configuration

Menu Configuration → Modules → WhatsApp Notify :

Identifiants Meta : jeton d'accès permanent, Phone Number ID, WhatsApp Business Account ID, version de l'API.
Webhook (suivi de livraison) : l'URL à déclarer dans Meta est affichée ; renseigner le verify token et l'app secret pour la vérification de signature.
Messages : nom du template, langue du template, pièce jointe PDF (oui/non), envoi automatique à la validation (oui/non), indicatif téléphonique par défaut.

Prérequis de données : le numéro de téléphone du tiers (fiche client) doit être renseigné — de préférence au format international (+33…, +212…) ; à défaut, l'indicatif par défaut est appliqué.

Utilisation

Sur la fiche d'une facture validée, un encart « Notification WhatsApp » propose le bouton d'envoi ; après envoi, il affiche le statut (envoyé / livré / lu) et le numéro du destinataire.
En mode automatique, le message part dès la validation de la facture, sans action de l'utilisateur.
Chaque message envoyé est visible en base avec son identifiant Meta (wamid) pour audit.

Historique des versions

Version	Apports principaux
1.0.0	Version initiale : envoi manuel + automatique, template Meta, PDF en pièce jointe, webhook de statut signé, normalisation E.164, FR/EN

Support

Contact : support@arcchester.com
Assistance : https://github.com/chakibarrama/Dolistore/issues