Module SMS pour Dolibarr ERP/CRM

1Les envois qui partent tout seuls

Trois tâches planifiées font le travail sans que personne y pense. Elles sont fournies avec le module, désactivées par défaut : vous choisissez celles que vous voulez.

Rappels de rendez-vous

Un SMS part avant les événements de l'agenda, avec le délai que vous fixez (24 h par défaut). Vous choisissez les types d'événements concernés — « Rendez-vous » uniquement, par exemple — ou cochez « tous les types ». Le numéro est cherché d'abord sur le contact lié à l'événement (mobile, personnel, professionnel), à défaut sur le tiers (mobile, téléphone). Un seul rappel par événement, quelle que soit la fréquence de la tâche.

Chaque fiche d'événement porte une case « Rappel SMS », cochée d'office quand son type est concerné : décochez-la pour écarter ce rendez-vous précis, cochez-la pour en inclure un dont le type ne l'est pas. Tant que personne n'y touche, la fiche suit le réglage général.

Variables du message : {date} {heure} {label} {societe} {masociete}.

Relances des factures impayées

Balayage quotidien des factures validées, non payées et échues depuis le nombre de jours de votre choix. Un intervalle minimum évite de relancer deux fois la même facture. Variables : {ref} {total} {date} {societe} {masociete}.

Alerte de solde bas

Dès que le crédit passe sous le seuil que vous fixez, un e-mail part vers l'adresse de votre choix — et un SMS sur votre mobile si vous le souhaitez. L'alerte ne se répète pas plus d'une fois tous les X jours.

2Suivre ce qui part, comprendre ce qui ne part pas

Un SMS qui ne parte pas sans explication, c'est une heure perdue. Le module a été construit pour que la réponse soit toujours à l'écran.

• Accusés de réception : le statut de remise remonte dans l'historique (remis, non remis, en attente). Le module conserve la référence d'envoi renvoyée par la passerelle, si bien que le rapprochement reste exact même avec plusieurs SMS vers le même numéro.
• Trace dans l'agenda du client : chaque SMS lié à un tiers crée un événement sur sa fiche, avec le texte complet en note. L'historique client devient réellement complet.
• Widget sur l'accueil : solde du compte et derniers envois dès la connexion.
• Test de connexion : un envoi à blanc (rien n'est envoyé, rien n'est débité) qui vérifie identifiants, extension cURL, proxy, jointure de la passerelle, validité du compte, solde — et affiche la réponse brute de l'API.
• Aperçu des rappels : la liste exacte des rendez-vous qui seront traités, le numéro trouvé pour chacun et le champ d'où il vient. S'il n'y en a aucun, la page dit pourquoi (hors fenêtre, type non retenu, aucun numéro).
• Exécution à la demande : « Simuler » ou « Exécuter » la tâche depuis la configuration, avec un journal détaillé étape par étape.
• État des tâches planifiées : activée ou non, dernière exécution, dernier compte rendu. Si une tâche active affiche « jamais exécutée », c'est le cron de Dolibarr qui n'est pas en service — et non le module.
• Codes de retour en clair : les 23 codes de l'API (80 à 102) sont traduits dans l'historique et les journaux. Un envoi bloqué avant la passerelle (réseau, pare-feu) est lui aussi enregistré, avec sa raison.

3Installation

$dolibarr_main_url_root_alt = '/custom';
$dolibarr_main_document_root_alt = '/chemin/vers/dolibarr/htdocs/custom';

• 1. Activez le répertoire custom/ dans conf.php (encadré ci-dessus).
• 2. Décompressez l'archive sur votre poste puis envoyez le dossier sms123 dans htdocs/custom/ (ou envoyez le zip et décompressez-le sur le serveur) : vous devez obtenir htdocs/custom/sms123/core/modules/modSms123.class.php (si vous obtenez htdocs/custom/sms123/sms123/…, remontez d'un niveau).
• 3. Accueil › Configuration › Modules/Applications : activez « SMS 123-SMS.net » (famille Interfaces).
• 4. Configurez le module, onglet Compte : identifiant et clé API (transmis à l'inscription), Sender-ID optionnel. Le bouton Tester la connexion valide le tout sans rien débiter.
• 5. Donnez la permission « Envoyer des SMS via 123-SMS » aux utilisateurs concernés.
• 6. Menu Outils › SMS 123-SMS : envoyez un SMS de test — la réponse s'affiche en clair (80 = envoyé).

4Faire tourner les tâches automatiquement

Dolibarr n'exécute ses tâches planifiées que si quelque chose vient les déclencher. La configuration du module affiche les trois moyens possibles, la commande et l'URL étant déjà remplies avec vos propres chemins et votre clé :

• Le cron du serveur (recommandé) : une ligne dans la crontab, appelant scripts/cron/cron_run_jobs.php.
• Une URL appelée par un service externe : pratique en hébergement mutualisé (planificateur de votre hébergeur, service de cron en ligne).
• Le déclencheur de secours du module : si aucun cron n'est possible, le module lance ses propres tâches pendant l'affichage d'une page, au plus une fois par intervalle. C'est un dépannage : rien ne part tant que personne ne se connecte. Il s'efface de lui-même dès qu'un vrai cron tourne.

5Pour les développeurs : la classe Sms123Api

Le module expose une classe utilisable partout dans Dolibarr — trigger maison, tâche planifiée, script en ligne de commande. Licence MIT : reprenez-la, adaptez-la.

<?php
// Dans n'importe quel trigger, cron ou script Dolibarr :
dol_include_once('/sms123/class/sms123api.class.php');

$code = Sms123Api::envoyer('0601020304', 'Votre commande est prete.');

if (Sms123Api::estSucces($code)) {
    // 80 = envoye, 81 = enregistre pour un envoi differe
} else {
    dol_syslog('SMS non parti : '.Sms123Api::libelle($code), LOG_WARNING);
}

// Envoi a blanc : rien n'est envoye, rien n'est debite (reponse 92)
$code = Sms123Api::envoyer('0601020304', 'Essai', 1);

// Rattacher l'envoi a un tiers : il apparait alors dans son agenda
$code = Sms123Api::envoyer($numero, $message, 0, 'ma-source', $socid);

// Solde du compte, en credits SMS
$solde = Sms123Api::solde();

Les numéros français sont normalisés automatiquement (0601020304 devient 33601020304), plusieurs destinataires se séparent par des tirets, et chaque appel est enregistré dans l'historique avec l'origine que vous indiquez.