Module SMS Avancé (multi-opérateurs): Difference between revisions

From Dolibarr ERP CRM Wiki
Jump to navigation Jump to search
VisualWikitext
(update)
Tag: 2017 source edit
(update)
 
Line 5: Line 5:
     Suggested page title: Module SMS Avance (multi-operator)
     Suggested page title: Module SMS Avance (multi-operator)
     ============================================================ -->
     ============================================================ -->
 
=Description=
   
   
= Description =
'''SMS Avancé''' transforme Dolibarr en véritable plateforme d'envoi et de réception de SMS professionnels<span> </span>: relances de factures automatiques, campagnes marketing avec test A/B, notifications sur événements métier, conversations bidirectionnelles avec les tiers, et conformité STOP/RGPD intégrée.
   
   
'''SMS Avancé''' transforme Dolibarr en véritable plateforme d'envoi et de réception de SMS professionnels : relances de factures automatiques, campagnes marketing avec test A/B, notifications sur événements métier, conversations bidirectionnelles avec les tiers, et conformité STOP/RGPD intégrée.
Le module s'appuie sur '''12 opérateurs SMS''' (africains et internationaux) plus une '''passerelle HTTP générique''' permettant de connecter n'importe quel opérateur local disposant d'une API HTTP. Un seul opérateur actif suffit pour démarrer.  
 
   
   
Le module s'appuie sur '''12 opérateurs SMS''' (africains et internationaux) plus une '''passerelle HTTP générique''' permettant de connecter n'importe quel opérateur local disposant d'une API HTTP. Un seul opérateur actif suffit pour démarrer.
[[File:Visuel multi operateurs 1280x720.png|thumb]]
 
=Fonctionnalités=
   
   
= Fonctionnalités =
==Envoi==
 
*Envoi manuel depuis la fiche d'un tiers, d'un contact, ou en saisie libre
*Envois programmés (date/heure différées) traités par le planificateur Dolibarr
*Envois en masse vers une sélection de tiers, une catégorie, ou une '''liste de diffusion'''
*Campagnes SMS avec circuit de validation<span> </span>: brouillon → validation explicite → envoi (rien ne part sans validation)
*'''Test A/B'''<span> </span>: deux variantes de message testées sur des échantillons (10 à 30 %), comparaison des taux de livraison et de clics, puis envoi de la variante gagnante au reste de l'audience
*Variables de personnalisation dans les messages (nom du tiers, référence de facture, montant, lien de désinscription…)
*Raccourcisseur de liens intégré avec comptage des clics
*Plafond de longueur de message configurable (défaut 1 000 caractères)
   
   
== Envoi ==
==Intégration Dolibarr==
* Envoi manuel depuis la fiche d'un tiers, d'un contact, ou en saisie libre
 
* Envois programmés (date/heure différées) traités par le planificateur Dolibarr
*Relances automatiques de factures impayées (paliers configurables avant/après échéance)
* Envois en masse vers une sélection de tiers, une catégorie, ou une '''liste de diffusion'''
*Notifications automatiques sur événements<span> </span>: validation de facture, expédition de commande, intervention…
* Campagnes SMS avec circuit de validation : brouillon → validation explicite → envoi (rien ne part sans validation)
*Onglet SMS sur les fiches tiers, contact, facture, commande, proposition, projet, ticket, contrat, expédition, intervention, adhérent, utilisateur et événement d'agenda
* '''Test A/B''' : deux variantes de message testées sur des échantillons (10 à 30 %), comparaison des taux de livraison et de clics, puis envoi de la variante gagnante au reste de l'audience
*Widget « activité récente » sur la page d'accueil
* Variables de personnalisation dans les messages (nom du tiers, référence de facture, montant, lien de désinscription…)
*Historique complet de chaque SMS rattaché au tiers concerné
* Raccourcisseur de liens intégré avec comptage des clics
* Plafond de longueur de message configurable (défaut 1 000 caractères)
   
   
== Intégration Dolibarr ==
==Multi-opérateurs==
* Relances automatiques de factures impayées (paliers configurables avant/après échéance)
 
* Notifications automatiques sur événements : validation de facture, expédition de commande, intervention…
*12 pilotes d'opérateurs fournis<span> </span>: Nexah (Cameroun), MboaSMS (Cameroun), SMS Partner Africa (Cameroun), Termii (Nigéria), Arkesel (Ghana), Beem Africa (Tanzanie), Africa's Talking (Afrique), BulkSMS, SMSAla, Unimatrix, Twilio et Vonage/Nexmo (international)
* Onglet SMS sur les fiches tiers, contact, facture, commande, proposition, projet, ticket, contrat, expédition, intervention, adhérent, utilisateur et événement d'agenda
*'''Passerelle HTTP générique''' configurable pour tout autre opérateur local
* Widget « activité récente » sur la page d'accueil
*Routage par préfixe de destination, ordre de priorité, bascule automatique en cas d'échec
* Historique complet de chaque SMS rattaché au tiers concerné
*Consultation du solde de crédits en temps réel (opérateurs le supportant)
*Identifiants opérateurs chiffrés en base
   
   
== Multi-opérateurs ==
==Réception et conformité==
* 12 pilotes d'opérateurs fournis : Nexah (Cameroun), MboaSMS (Cameroun), SMS Partner Africa (Cameroun), Termii (Nigéria), Arkesel (Ghana), Beem Africa (Tanzanie), Africa's Talking (Afrique), BulkSMS, SMSAla, Unimatrix, Twilio et Vonage/Nexmo (international)
 
* '''Passerelle HTTP générique''' configurable pour tout autre opérateur local
*Réception des SMS entrants par webhook, avec boîte de réception et '''fils de conversation''' par correspondant
* Routage par préfixe de destination, ordre de priorité, bascule automatique en cas d'échec
*Détection automatique des mots-clés STOP / ARRÊT / UNSUBSCRIBE dans les réponses
* Consultation du solde de crédits en temps réel (opérateurs le supportant)
*'''Lien de désinscription signé''' (variable <code>__LIEN_STOP__</code>) propre à chaque destinataire, avec page de confirmation
* Identifiants opérateurs chiffrés en base
*Liste d'opposition centralisée, contrôlée avant chaque mise en file d'attente
*Accusés de réception (DLR) par webhook sécurisé par jeton généré automatiquement
   
   
== Réception et conformité ==
==Pilotage==
* Réception des SMS entrants par webhook, avec boîte de réception et '''fils de conversation''' par correspondant
 
* Détection automatique des mots-clés STOP / ARRÊT / UNSUBSCRIBE dans les réponses
*'''Tableau de bord SMS'''<span> </span>: indicateurs de période avec comparaison à la période précédente, soldes opérateurs, graphique quotidien envois/échecs, top tiers destinataires, origines des envois, export CSV
* '''Lien de désinscription signé''' (variable <code>__LIEN_STOP__</code>) propre à chaque destinataire, avec page de confirmation
*'''Retombées des relances'''<span> </span>: corrélation entre SMS de relance et paiements de factures encaissés sous 7 jours
* Liste d'opposition centralisée, contrôlée avant chaque mise en file d'attente
*Journal complet des envois avec filtres (période, opérateur, tiers, campagne, statut)
* Accusés de réception (DLR) par webhook sécurisé par jeton généré automatiquement
*Visibilité à 3 niveaux par droits utilisateur<span> </span>: mes SMS / SMS de mes tiers / tous les SMS
   
   
== Pilotage ==
==Exploitation==
* '''Tableau de bord SMS''' : indicateurs de période avec comparaison à la période précédente, soldes opérateurs, graphique quotidien envois/échecs, top tiers destinataires, origines des envois, export CSV
 
* '''Retombées des relances''' : corrélation entre SMS de relance et paiements de factures encaissés sous 7 jours
*Page de diagnostic intégrée (état du schéma, jetons, tâches planifiées)
* Journal complet des envois avec filtres (période, opérateur, tiers, campagne, statut)
*Manuel d'utilisation complet intégré au module
* Visibilité à 3 niveaux par droits utilisateur : mes SMS / SMS de mes tiers / tous les SMS
*Migrations automatiques à chaque mise à jour — aucune réactivation ni intervention manuelle
== Exploitation ==
* Page de diagnostic intégrée (état du schéma, jetons, tâches planifiées)
* Manuel d'utilisation complet intégré au module
* Migrations automatiques à chaque mise à jour — aucune réactivation ni intervention manuelle
= Installation =
# Téléchargez le paquet <code>smsavance-x.y.z.zip</code> depuis le Dolistore.
# Dans Dolibarr, allez dans '''Accueil → Configuration → Modules/Applications''', onglet '''Déployer/Installer un module externe''', et sélectionnez le fichier zip.
#* Ou manuellement : décompressez le zip dans le répertoire <code>custom/</code> de votre Dolibarr (vous devez obtenir <code>custom/smsavance/</code>).
# Retournez dans la liste des modules, recherchez '''SMS Avancé''' et activez-le.
Lors de l'activation, le module crée automatiquement ses tables, menus, permissions et tâches planifiées. Les mises à jour se font en remplaçant simplement le répertoire : les migrations de schéma sont automatiques et idempotentes.
= Configuration =
== 1. Activer un opérateur ==
Menu '''SMS → Configuration → Opérateurs''' : cliquez sur l'icône « + », choisissez votre opérateur dans la liste, renseignez vos identifiants API (chiffrés en base) et l'identifiant d'expéditeur (sender ID). Un seul opérateur actif suffit.
Pour un opérateur local absent de la liste, utilisez la '''Passerelle HTTP générique''' : URL, méthode, paramètres et interprétation de la réponse sont entièrement configurables.
== 2. Paramètres généraux ==
Menu '''SMS → Configuration → Paramètres''' : expéditeur par défaut, plafond de longueur (<code>SMS_MAX_MESSAGE_LENGTH</code>), raccourcisseur de liens, relances automatiques et leurs paliers.
== 3. Webhooks (réception et accusés) ==
La page de configuration affiche, pour chaque opérateur actif, les '''URL de webhook prêtes à copier''' (accusés de réception <code>dlr.php</code> et SMS entrants <code>inbound.php</code>), déjà munies du jeton de sécurité généré automatiquement. Collez ces URL dans l'interface de votre opérateur.
== 4. Permissions ==
Attribuez les droits aux utilisateurs/groupes : lecture, envoi, envoi en masse, administration, suppression, et étendue de visibilité (ses propres SMS, ceux de ses tiers, ou tous).
== 5. Tâches planifiées ==
Vérifiez dans '''Accueil → Configuration → Modules → Travaux planifiés''' que les tâches du module (traitement de la file d'attente, relances différées, vérification des statuts) sont actives. La page '''SMS → Diagnostic''' signale toute tâche inactive.
= Utilisation =
* '''Nouvel envoi''' : menu SMS → Nouvel envoi — tiers, contact, numéro libre, catégorie ou liste de diffusion ; envoi immédiat ou programmé.
* '''Campagnes''' : menu SMS → Campagnes SMS — créez un brouillon, ciblez, testez éventuellement en A/B, validez, suivez les résultats par variante.
* '''Listes de diffusion''' : menu SMS → Listes de diffusion — constitution manuelle ou depuis une catégorie de tiers, dédoublonnage automatique.
* '''Conversations''' : menu SMS → Messages reçus — chaque échange est regroupé en fil de conversation par numéro/tiers.
* '''Tableau de bord''' : menu SMS → Tableau de bord SMS — pilotage par période, filtres opérateur et tiers, export CSV.
* '''Manuel intégré''' : menu SMS → Manuel — documentation détaillée de chaque fonction, y compris les variables de personnalisation.
<!-- Ajoutez ici 2-3 captures d'écran réelles :
[[File:smsavance_tableau_de_bord.png|900px|center|thumb|Le tableau de bord SMS]]
[[File:smsavance_campagne_ab.png|900px|center|thumb|Campagne avec test A/B]]
-->
= Sécurité et conformité =
* Webhooks publics protégés par jeton secret généré automatiquement (comparaison à temps constant)
* Lien de désinscription signé HMAC-SHA256, infalsifiable, avec page de confirmation anti-robots
* Identifiants opérateurs chiffrés en base de données
* Aucune donnée envoyée à des tiers autres que l'opérateur SMS choisi par vos soins
* Liste d'opposition (STOP) vérifiée avant chaque mise en file — impossible à contourner, y compris en envoi de masse
* Journal d'audit : chaque SMS est tracé avec son auteur, son origine et son statut


[[Category:Complementary Modules]]
[[Category:Complementary Modules]]

Latest revision as of 23:24, 21 July 2026

Description

SMS Avancé transforme Dolibarr en véritable plateforme d'envoi et de réception de SMS professionnels : relances de factures automatiques, campagnes marketing avec test A/B, notifications sur événements métier, conversations bidirectionnelles avec les tiers, et conformité STOP/RGPD intégrée.

Le module s'appuie sur 12 opérateurs SMS (africains et internationaux) plus une passerelle HTTP générique permettant de connecter n'importe quel opérateur local disposant d'une API HTTP. Un seul opérateur actif suffit pour démarrer.


Visuel multi operateurs 1280x720.png

Fonctionnalités

Envoi

  • Envoi manuel depuis la fiche d'un tiers, d'un contact, ou en saisie libre
  • Envois programmés (date/heure différées) traités par le planificateur Dolibarr
  • Envois en masse vers une sélection de tiers, une catégorie, ou une liste de diffusion
  • Campagnes SMS avec circuit de validation : brouillon → validation explicite → envoi (rien ne part sans validation)
  • Test A/B : deux variantes de message testées sur des échantillons (10 à 30 %), comparaison des taux de livraison et de clics, puis envoi de la variante gagnante au reste de l'audience
  • Variables de personnalisation dans les messages (nom du tiers, référence de facture, montant, lien de désinscription…)
  • Raccourcisseur de liens intégré avec comptage des clics
  • Plafond de longueur de message configurable (défaut 1 000 caractères)

Intégration Dolibarr

  • Relances automatiques de factures impayées (paliers configurables avant/après échéance)
  • Notifications automatiques sur événements : validation de facture, expédition de commande, intervention…
  • Onglet SMS sur les fiches tiers, contact, facture, commande, proposition, projet, ticket, contrat, expédition, intervention, adhérent, utilisateur et événement d'agenda
  • Widget « activité récente » sur la page d'accueil
  • Historique complet de chaque SMS rattaché au tiers concerné

Multi-opérateurs

  • 12 pilotes d'opérateurs fournis : Nexah (Cameroun), MboaSMS (Cameroun), SMS Partner Africa (Cameroun), Termii (Nigéria), Arkesel (Ghana), Beem Africa (Tanzanie), Africa's Talking (Afrique), BulkSMS, SMSAla, Unimatrix, Twilio et Vonage/Nexmo (international)
  • Passerelle HTTP générique configurable pour tout autre opérateur local
  • Routage par préfixe de destination, ordre de priorité, bascule automatique en cas d'échec
  • Consultation du solde de crédits en temps réel (opérateurs le supportant)
  • Identifiants opérateurs chiffrés en base

Réception et conformité

  • Réception des SMS entrants par webhook, avec boîte de réception et fils de conversation par correspondant
  • Détection automatique des mots-clés STOP / ARRÊT / UNSUBSCRIBE dans les réponses
  • Lien de désinscription signé (variable __LIEN_STOP__) propre à chaque destinataire, avec page de confirmation
  • Liste d'opposition centralisée, contrôlée avant chaque mise en file d'attente
  • Accusés de réception (DLR) par webhook sécurisé par jeton généré automatiquement

Pilotage

  • Tableau de bord SMS : indicateurs de période avec comparaison à la période précédente, soldes opérateurs, graphique quotidien envois/échecs, top tiers destinataires, origines des envois, export CSV
  • Retombées des relances : corrélation entre SMS de relance et paiements de factures encaissés sous 7 jours
  • Journal complet des envois avec filtres (période, opérateur, tiers, campagne, statut)
  • Visibilité à 3 niveaux par droits utilisateur : mes SMS / SMS de mes tiers / tous les SMS

Exploitation

  • Page de diagnostic intégrée (état du schéma, jetons, tâches planifiées)
  • Manuel d'utilisation complet intégré au module
  • Migrations automatiques à chaque mise à jour — aucune réactivation ni intervention manuelle
Retrieved from "https://wiki.dolibarr.org/index.php?title=Module_SMS_Avancé_(multi-opérateurs)&oldid=66714"