Notice du module Envoi SMS

Guide d'utilisation non technique : à quoi sert le module, comment l'utiliser et comment il s'articule avec Dolibarr.

Fournisseur SMSOVH SMS (API)
Fiches Dolibarr connectées12 types de fiches
Variables de personnalisationPlus de 160
Suivi des envois5 statuts + agenda

1. Présentation du module

Le module Envoi SMS ajoute à Dolibarr la possibilité d'envoyer des SMS à vos clients, prospects, contacts, adhérents et fournisseurs, directement depuis les fiches que vous consultez au quotidien : tiers, contact, devis, commande, facture, intervention, contrat, expédition, adhérent, proposition, commande et facture fournisseurs. Un bouton « Envoyer un SMS » apparaît dans la barre d'actions de ces fiches, juste à côté du bouton d'envoi d'e-mail : il ouvre un formulaire déjà renseigné avec le nom et le numéro de téléphone du destinataire, sans aucune ressaisie. Les messages partent par l'interface de programmation SMS d'OVH, avec le nom d'expéditeur validé sur votre compte. Le module s'appuie entièrement sur les données natives de Dolibarr : il reprend les coordonnées des tiers et des contacts, les références, les dates et les montants des documents, et enregistre chaque envoi dans l'agenda pour en garder la trace. Il y ajoute une bibliothèque de modèles de messages, plus de cent soixante variables qui se remplissent seules, un aperçu fidèle avec décompte des SMS consommés, un mode test sans envoi réel, un historique complet et une gestion du crédit de SMS utilisateur par utilisateur.

  • Envoi de SMS depuis les fiches Dolibarr (bouton et fenêtre intégrée) ou depuis un menu dédié, pour un message ponctuel.
  • Nom et numéro du destinataire repris automatiquement de la fiche, numéro mis au format international à la saisie.
  • Modèles de SMS réutilisables, avec variables qui se remplissent seules : client, référence, montants, dates, liens de document.
  • Aperçu en direct, compteur de caractères et de segments, et mode test avant tout envoi réel.
  • Historique de tous les envois avec statut (nouveau, en file, envoyé, échec, test), erreur de l'opérateur et possibilité de relancer.
  • Crédit de SMS par utilisateur, blocage à l'épuisement et alertes automatiques quand le stock devient faible.
  • Chaque envoi, échec ou test est tracé dans l'agenda Dolibarr, rattaché au tiers, au contact et au document concerné.
  • Interface et libellés fournis en français, anglais, allemand, espagnol et italien.

2. Envoyer un SMS depuis une fiche

C'est l'usage principal du module. Un bouton « Envoyer un SMS » s'ajoute à la barre d'actions de la fiche, à côté du bouton d'envoi d'e-mail, et ouvre une fenêtre qui reste posée sur la fiche consultée.

  • Le bouton apparaît sur les fiches tiers, contact et adhérent, sur les devis, commandes, factures, interventions, contrats et expéditions, ainsi que sur les propositions, commandes et factures fournisseurs.
  • La fenêtre d'envoi se déplace, se redimensionne et se réduit : la fiche reste consultable pendant la rédaction du message.
  • Le nom du tiers est repris en lecture seule ; le numéro de téléphone reste modifiable si le message doit partir sur une autre ligne.
  • Une fois le SMS parti, la fenêtre se ferme et la fiche se recharge avec le message de confirmation.
  • En cas de refus (numéro absent, message vide, crédit épuisé), la fenêtre se rouvre avec votre saisie conservée et l'explication du refus.
  • Le bouton n'est visible que pour les utilisateurs ayant le droit de lecture du module ; l'envoi réel demande le droit d'écriture.

3. Le menu du module et ses trois écrans

Le module installe son propre menu dans la barre du haut. Il donne accès à trois écrans qui couvrent la rédaction, le suivi et les modèles, sans passer par une fiche.

  • « Envoyer SMS » ouvre le même formulaire que la fenêtre des fiches : hors document, il suffit de saisir le numéro du destinataire à la main.
  • « Suivi des envois » donne l'historique complet des SMS traités, avec leurs statuts et leur contenu.
  • « Modèles de SMS » donne accès à la bibliothèque de messages types et à leur test.
  • Les trois entrées sont réservées aux utilisateurs disposant du droit de lecture du module.
  • La page de configuration, atteinte depuis la liste des modules de Dolibarr, n'est ouverte qu'aux administrateurs.

4. Composer le message : modèle, aperçu et compteur

Le formulaire d'envoi réunit tout ce qui sert à écrire le message : la liste des modèles, la zone de texte, l'aperçu en direct et le compteur de SMS consommés.

  • Choisir un modèle dans la liste l'applique aussitôt : la zone de texte reçoit le message avec les variables déjà remplacées par les données de la fiche.
  • Le bouton « Choisir » réapplique le modèle sélectionné, ce qui permet de repartir du texte d'origine après une modification.
  • Un bloc dépliable « Modèle brut » montre le texte du modèle avant remplacement, pour vérifier quelle variable a servi.
  • La zone de texte reste librement modifiable : le message envoyé est exactement celui que vous lisez.
  • L'aperçu se met à jour à chaque frappe et montre le message tel qu'il partira, signature comprise.
  • Le compteur affiche le nombre de caractères et le nombre de SMS (segments) que le message va consommer.
  • Seuls les modèles actifs sont proposés, et uniquement ceux dont le type correspond à la fiche en cours ou qui sont génériques.
  • Lorsqu'un seul modèle est disponible, il est appliqué automatiquement à l'ouverture du formulaire.

5. Modèles de SMS réutilisables

L'écran « Modèles de SMS » sert à constituer une bibliothèque de messages types (rappel de rendez-vous, information de livraison, relance de facture) pour ne plus retaper les textes récurrents.

  • Chaque modèle porte un code, un libellé, un contenu et un indicateur « Activé » ; le code doit rester unique.
  • Le type rattache le modèle à une nature de fiche : générique, client, devis, commande, facture, intervention, commande fournisseur ou facture fournisseur.
  • Un modèle générique est proposé partout : c'est le choix à retenir pour les fiches contrat, expédition, contact, adhérent et proposition fournisseur, qui n'ont pas de type dédié.
  • Le contenu se saisit dans l'éditeur habituel de Dolibarr ; la mise en forme est retirée à l'envoi, car un SMS part toujours en texte brut.
  • La liste complète des variables disponibles s'affiche sous le formulaire, avec des valeurs d'exemple.
  • Le bouton « Tester » génère l'aperçu du modèle à partir d'une fiche réelle : on indique le type de fiche et son identifiant pour contrôler le rendu avant de diffuser le modèle.
  • Les modèles se modifient et se suppriment depuis la liste, la suppression demandant une confirmation.
  • La consultation et le test demandent le droit de lecture ; créer, modifier ou supprimer un modèle demande le droit d'écriture.

6. Personnalisation automatique : les variables

Les modèles et les messages peuvent contenir des variables remplacées par les vraies données au moment de l'envoi. Le formulaire affiche la liste complète de ces variables avec, pour chacune, la valeur obtenue sur la fiche en cours, un tiret signalant une donnée absente.

  • Destinataire : nom du tiers, nom du contact rattaché et numéro de téléphone utilisé.
  • Client ou fournisseur de la fiche : raison sociale, nom commercial, code client, code fournisseur, adresse, code postal, ville, pays, courriel, téléphone, télécopie, identifiants professionnels, numéro de TVA intracommunautaire et notes.
  • Document : identifiant, référence, référence client ou fournisseur, libellé, notes publique et privée.
  • Dates du document : création, modification, validation, livraison (jusqu'au jour, au mois, à l'année et à l'heure) et date d'échéance ou de fin de validité.
  • Montants du document : total hors taxes, TVA, total toutes taxes, reste à payer, en chiffres, mis en forme ou en toutes lettres, y compris en devise.
  • Votre société : nom, adresse complète, code postal, ville, pays, téléphone, mobile, télécopie, site web, identifiants professionnels, capital et code devise.
  • Utilisateur connecté : nom, prénom, nom complet, fonction, téléphones, courriel et signature.
  • Repères de calendrier : jour, mois et année en cours en chiffres ou en lettres, jour et mois précédents ou suivants.
  • Liens : téléchargement du dernier document PDF (devis, commande, facture, contrat, intervention, proposition fournisseur), signature en ligne (devis, contrat, intervention) et paiement en ligne de Dolibarr.
  • Le lien de téléchargement ouvre le document sans demander d'identifiant, comme le fait Dolibarr dans ses modèles d'e-mail : à réserver aux pièces que le destinataire a le droit de recevoir.
  • Une variable permet aussi d'insérer la traduction d'une clé de langue ou la valeur d'une constante de Dolibarr.

7. Numéro du destinataire et indicatif pays

Un SMS ne part que si le numéro est au format international. Le module s'en occupe, pendant la saisie comme au moment de l'envoi.

  • Le numéro proposé vient du tiers de la fiche, téléphone mobile en priorité et téléphone fixe à défaut.
  • Si le tiers n'a aucun numéro, celui du contact rattaché est utilisé.
  • Sur un document, le contact retenu est le contact de facturation lorsqu'il existe, sinon le premier contact externe rattaché ; son nom alimente la variable correspondante.
  • Trois comportements se règlent en configuration : détecter et compléter l'indicatif seulement si besoin, ajouter systématiquement l'indicatif par défaut, ou ne rien modifier.
  • Le champ est remis au format international dès que vous le quittez : espaces et séparateurs disparaissent, un zéro initial est remplacé par l'indicatif, et un numéro commençant par deux zéros devient un numéro précédé du signe plus.
  • L'indicatif par défaut se saisit au format international, par exemple « +33 » pour la France.
  • Un envoi sans numéro, ou sans message, est refusé avec un avertissement explicite.

8. Longueur du message, segments et signature

Un SMS n'est pas un courriel : sa longueur est limitée et ce qui est consommé dépend du nombre de segments. Le module calcule tout avant l'envoi et le compteur l'affiche en direct.

  • Un message composé uniquement des caractères de la table SMS standard tient en 160 caractères ; au-delà, il est découpé en segments de 153 caractères.
  • Dès qu'un caractère sort de cette table (émoji, caractère rare), le message bascule en codage étendu : 70 caractères pour un seul segment, puis 67 caractères par segment.
  • Le crédit est décompté au nombre de segments réellement nécessaires, et non au nombre de messages envoyés.
  • Le nom de votre société est ajouté en signature à la fin du message, sauf s'il y figure déjà.
  • Le nom de l'expéditeur est retiré du corps du message pour éviter qu'il n'apparaisse deux fois.
  • Mise en forme, balises et retours à la ligne superflus sont nettoyés : le texte envoyé est bien celui de l'aperçu.

9. Options d'envoi et expéditeur

Sous la zone de message, quelques réglages adaptent chaque envoi à la nature du message et à la réglementation applicable aux SMS.

  • Priorité du message : haute, moyenne ou basse, transmise à l'opérateur.
  • Type de message : transactionnel (confirmation, code, rappel de rendez-vous) ou marketing (offre commerciale).
  • Délai avant envoi, en minutes : le message est remis en différé par l'opérateur, jusqu'à 4 320 minutes, soit 72 heures.
  • Mention STOP : elle n'est jamais ajoutée aux SMS transactionnels ; la case « Désactiver le message STOP » ne concerne donc que les envois marketing.
  • L'expéditeur affiché est celui retenu en configuration : il n'est pas modifiable au moment de l'envoi.
  • Sans expéditeur choisi, le nom de votre société est utilisé, tronqué à onze caractères comme l'imposent les règles des SMS.
  • L'expéditeur doit être validé sur votre compte OVH : un nom inconnu de l'opérateur fait refuser l'envoi.
  • Les valeurs par défaut de ces quatre réglages se fixent une fois pour toutes en configuration.

10. Mode test avant envoi réel

Le mode test prépare et vérifie un SMS sans qu'aucun message ne soit réellement remis ni décompté. C'est le bon réflexe pour valider un modèle ou une mise en forme.

  • Un interrupteur « Mode test » figure dans le formulaire ; il peut être activé par défaut en configuration.
  • Tant qu'il est actif, un bandeau rappelle qu'aucun SMS ne sera délivré, et le titre de l'aperçu signale le test.
  • Le message est enregistré dans le suivi avec le statut « Test » et ne consomme aucun crédit.
  • Après validation, un encadré « Résultat du mode test » reprend la date, le destinataire, l'expéditeur et le texte exact qui serait parti.
  • Un événement est créé dans l'agenda, afin que le test laisse lui aussi une trace.
  • Une ligne au statut « Test » ne propose pas d'action d'envoi dans l'historique : pour envoyer réellement, on repasse par le formulaire.

11. Suivi des envois

L'écran « Suivi des envois » liste tous les SMS traités, du message en attente à l'échec, avec leur contenu exact et les options utilisées.

  • Colonnes affichées : date, destinataire, expéditeur, statut, contexte (type de fiche), message et actions.
  • Cinq statuts sont gérés : Nouveau, En file, Envoyé, Échec et Test.
  • Sous chaque message, un rappel des options retenues : priorité, type, délai et mention STOP.
  • Quand l'opérateur refuse un message, l'erreur qu'il a renvoyée s'affiche sous la ligne concernée.
  • Filtres par statut, par contexte, et recherche libre sur le contenu, le destinataire ou l'expéditeur.
  • Les colonnes date, destinataire, expéditeur, statut et contexte sont triables, et le nombre de résultats par page est réglable.
  • L'action « Envoyer » relance un message au statut Nouveau, En file ou Échec ; un message déjà envoyé n'est jamais expédié deux fois.
  • L'action « Supprimer » retire une ligne de l'historique, après confirmation.
  • Ces deux actions demandent le droit d'écriture ; le droit de lecture suffit pour consulter et filtrer.

12. Crédit de SMS par utilisateur et alertes de stock

Le module permet d'attribuer un nombre de SMS à chaque utilisateur et de surveiller ce qui reste, côté utilisateur comme côté compte OVH.

  • La configuration liste les utilisateurs actifs avec, pour chacun, le quota attribué, le nombre consommé et le disponible, puis une ligne de total.
  • Un utilisateur dont le quota n'est pas renseigné n'est pas limité par le module.
  • Dès qu'un quota est renseigné, l'envoi est refusé quand les segments nécessaires dépassent le disponible, avec le détail de ce qui est utilisé et de ce qui est autorisé.
  • Le contrôle a lieu aussi dans le navigateur, avant la validation du formulaire, pour éviter une tentative inutile.
  • Un badge rappelle le nombre de SMS restants sur l'écran d'envoi et sur la page de configuration.
  • Lorsqu'il reste dix SMS ou moins, un bandeau s'affiche sur l'écran d'envoi avec le lien de commande indiqué en configuration.
  • Sous le seuil d'alerte paramétré, une carte apparaît en bas de l'écran et une pastille s'ajoute en haut à droite dans tout Dolibarr ; la carte peut être fermée définitivement.
  • L'alerte suit le quota de l'utilisateur lorsqu'il en a un, et le crédit réel du compte OVH dans le cas contraire.
  • La configuration affiche l'écart entre le crédit du compte OVH et la somme des quotas encore disponibles, ce qui permet de repérer une sur-attribution.

13. Configuration et outils de contrôle

La page de configuration, réservée aux administrateurs, rassemble la connexion à l'opérateur, les valeurs par défaut des envois, les quotas des utilisateurs et deux outils de vérification.

  • Connexion OVH SMS : adresse de l'interface de programmation, Application Key, Application Secret, Consumer Key et nom du service, de la forme « sms-XXXXX ».
  • L'adresse accepte l'URL complète de l'interface ou un raccourci de la gamme OVH ; l'Europe est utilisée par défaut.
  • Un bouton ouvre le générateur de clé d'accès OVH déjà préparé avec les droits nécessaires à l'envoi et à la lecture du crédit.
  • Les identifiants sont contrôlés à l'enregistrement : un avertissement signale un champ manquant, une adresse invalide ou un refus de l'opérateur.
  • Le crédit disponible sur le compte OVH est affiché, ainsi que la liste des expéditeurs validés dans laquelle se choisit l'expéditeur par défaut.
  • Valeurs par défaut réglables : mode test, priorité, type de message, délai, mention STOP, gestion de l'indicatif pays, indicatif par défaut et seuil d'alerte de stock.
  • L'outil « Tester la configuration » vérifie en cinq points l'adresse de l'interface, les identifiants, le service, l'accès effectif à l'opérateur et la présence des tables.
  • L'outil « Réinitialiser le module » efface, après confirmation explicite, les SMS, les modèles et les paramètres de l'entité en cours.

14. Liaisons avec Dolibarr

Le module ne fonctionne pas en vase clos : il s'articule avec les briques natives de Dolibarr.

  • Tiers et contacts : Le module reprend le nom et le numéro de téléphone du tiers de la fiche, mobile en priorité, et à défaut ceux du contact rattaché. Un bouton d'envoi est ajouté sur les fiches tiers et contact, et le tiers est rattaché à l'événement d'agenda créé.
  • Devis, commandes et factures clients : Les fiches proposition commerciale, commande et facture reçoivent le bouton d'envoi. Les variables y reprennent la référence, la référence client, les dates et les montants du document (hors taxes, TVA, toutes taxes, reste à payer) et peuvent insérer le lien de téléchargement du document, le lien de signature en ligne d'un devis ou le lien de paiement en ligne.
  • Interventions, contrats et expéditions : Ces trois fiches disposent également du bouton d'envoi, avec reprise du client et de ses coordonnées. L'intervention et le contrat acceptent en plus le lien de téléchargement de leur document et le lien de signature en ligne natif de Dolibarr.
  • Documents fournisseurs : Les propositions, commandes et factures fournisseurs sont prises en charge : le tiers fournisseur et la référence fournisseur alimentent le message, et la proposition fournisseur dispose de son lien de téléchargement.
  • Adhérents : Les fiches adhérent permettent d'écrire à un membre : son nom et son numéro de mobile sont repris, et l'événement d'agenda est rattaché à la société liée lorsqu'elle existe.
  • Agenda (événements) : Chaque SMS envoyé, en échec ou en test crée un événement automatique dans l'agenda, rattaché au tiers, au contact, au document d'origine et au projet du document le cas échéant. Le libellé rappelle le statut et le destinataire ; la note reprend l'expéditeur, l'identifiant renvoyé par l'opérateur, un extrait du message et l'erreur éventuelle. Un échec est enregistré comme non abouti.
  • Documents, signature et paiement en ligne : Les variables de lien s'appuient sur le dernier document PDF généré par Dolibarr et sur les liens natifs de signature et de paiement en ligne : aucun fichier n'est recopié ailleurs. Le lien de téléchargement s'ouvre sans authentification, exactement comme celui proposé par Dolibarr dans ses modèles d'e-mail.
  • Société émettrice et utilisateurs : Les coordonnées de votre société (nom, adresse, identifiants professionnels, capital) et la fiche de l'utilisateur connecté alimentent les variables, la signature ajoutée au SMS et le nom d'expéditeur par défaut. Les crédits de SMS, eux, se gèrent utilisateur Dolibarr par utilisateur Dolibarr.
  • Droits et entités : Le module déclare deux permissions, Lire et Écrire : la lecture ouvre les écrans, les modèles et le bouton des fiches, l'écriture autorise l'envoi, la gestion des modèles et les actions de l'historique. La page de configuration reste réservée aux administrateurs. Messages, modèles, paramètres et quotas sont cloisonnés par entité, et la réinitialisation ne touche que l'entité en cours.
Besoin d'aide ? WhatsApp Téléphone: 07 45 15 75 87 Téléphone: 07 43 52 58 29 Email Ouvrir le formulaire