📱 Module OVH SMS

Guide complet d'utilisation pour Dolibarr

Version 2.0 - Janvier 2025

📋 Table des matières

1️⃣ Introduction

1.1 Qu'est-ce que le module OVH SMS ?

Le module OVH SMS est une solution professionnelle développée par SBC CONSEILS qui permet d'envoyer des campagnes SMS directement depuis votre Dolibarr vers vos clients, prospects et contacts.

Le module s'intègre avec l'API OVH SMS pour offrir un service de communication fiable et professionnel.

1.2 Fonctionnalités principales

📤 Campagnes SMS

Créez et envoyez des campagnes SMS ciblées à vos contacts avec planification et suivi en temps réel.

📝 Modèles personnalisables

Créez des modèles réutilisables avec variables automatiques (nom, prénom, société, etc.).

👥 Sélection intelligente

Sélectionnez vos destinataires par catégorie, tags ou individuellement avec pagination.

📊 Statistiques détaillées

Suivez vos envois, taux de livraison et historique complet de toutes vos campagnes.

☁️ Multi-comptes OVH

Gérez plusieurs comptes OVH SMS avec différents expéditeurs et services.

🌍 Format international

Conversion automatique des numéros au format international (+33, +32, etc.).

1.3 Avantages

💡 Cas d'usage

  • 📢 Campagnes marketing et promotions
  • 🔔 Rappels de rendez-vous
  • 📦 Notifications de livraison
  • 💰 Relances de paiement
  • 🎉 Vœux saisonniers (Noël, Nouvel An)
  • 🚨 Alertes urgentes

2️⃣ Configuration initiale

2.1 Prérequis

Avant de commencer, assurez-vous d'avoir :

ℹ️ Obtenir les identifiants API OVH

Rendez-vous sur : https://eu.api.ovh.com/createToken/

Droits nécessaires : GET, POST sur /sms/*

2.2 Configuration du module

1 Allez dans Accueil → Configuration → Modules/Applications
2 Recherchez "OVH SMS" et activez le module
3 Cliquez sur la roue dentée ⚙️ à côté du module pour accéder à la configuration

2.3 Ajouter un compte OVH SMS

1 Dans la page de configuration, cliquez sur "Nouveau compte SMS"
2 Remplissez les informations :
  • Nom du compte : ex. "Principal", "Marketing", "Urgence"
  • Application Key : votre clé API OVH
  • Application Secret : votre secret API OVH
  • Consumer Key : votre consumer key OVH
  • Service SMS : nom du service (ex. "sms-ab12345-1")
  • Expéditeur par défaut : nom affiché (max 11 caractères)
3 Cliquez sur "Enregistrer"

✅ Configuration terminée

Votre compte OVH SMS est maintenant configuré et prêt à l'emploi !

⚠️ Expéditeur

L'expéditeur doit respecter les règles OVH :

  • Maximum 11 caractères
  • Uniquement lettres et chiffres (pas d'espaces, pas d'accents)
  • Exemples valides : SBCCONSEILS, Promo2025
  • Exemples invalides : SBC CONSEILS, Société!

2.4 Gérer plusieurs comptes

Vous pouvez configurer plusieurs comptes OVH pour différents usages :

Lors de chaque envoi, vous pourrez choisir quel compte utiliser.

3️⃣ Créer une campagne SMS

3.1 Accéder aux campagnes

1 Dans le menu principal, cliquez sur "OVH SMS"
2 Cliquez sur "Nouvelle campagne"

3.2 Informations de la campagne

1 Remplissez les informations de base :
  • Nom de la campagne : ex. "Promo Noël 2025", "Rappels Janvier"
  • Description : objectif de la campagne (optionnel mais recommandé)

💡 Conseil

Utilisez des noms de campagne clairs et datés pour retrouver facilement vos envois dans l'historique.

3.3 Sélection du compte SMS

2 Choisissez le compte OVH SMS à utiliser pour cette campagne

Si vous avez plusieurs comptes configurés, sélectionnez celui approprié pour votre campagne.

3.4 Personnaliser l'expéditeur

3 (Optionnel) Modifiez l'expéditeur pour cette campagne

Par défaut, l'expéditeur configuré dans le compte sera utilisé. Vous pouvez le modifier pour cette campagne uniquement.

⚠️ Rappel

L'expéditeur doit respecter : max 11 caractères, alphanumériques uniquement

4️⃣ Modèles de SMS

4.1 Qu'est-ce qu'un modèle ?

Les modèles SMS sont des messages prédéfinis et réutilisables qui peuvent contenir des variables automatiques pour personnaliser chaque envoi.

4.2 Créer un modèle

1 Depuis la page OVH SMS, cliquez sur "Modèles"
2 Cliquez sur "Nouveau modèle"
3 Remplissez les informations :
  • Nom du modèle : ex. "Promo hiver", "Rappel RDV"
  • Catégorie : Marketing, Rappel, Information, Urgence
  • Description : usage du modèle
4 Rédigez votre message avec les variables

4.3 Variables disponibles

Vous pouvez utiliser les variables suivantes qui seront automatiquement remplacées par les informations du destinataire :

📋 Variables de base (disponibles partout)

Variable Remplacée par Exemple
__THIRDPARTY_NAME__ Nom du tiers/client ABC Solutions
__THIRDPARTY_CODE__ Code client CL001
__THIRDPARTY_EMAIL__ Email du tiers contact@abc.fr
__THIRDPARTY_PHONE__ Téléphone du tiers +33612345678
__THIRDPARTY_ADDRESS__ Adresse complète 123 Rue Example
__THIRDPARTY_ZIP__ Code postal 68000
__THIRDPARTY_TOWN__ Ville Colmar
__MYCOMPANY_NAME__ Nom de votre entreprise SBC CONSEILS

📅 Variables intervention/RDV

Variable Remplacée par Exemple
__EVENT_DATE__ Date du RDV 15/01/2025
__EVENT_TIME__ Heure du RDV 14:30
__EVENT_DATETIME__ Date et heure complètes 15/01/2025 à 14:30
__EVENT_REF__ Référence de l'intervention INT-2025-001
__EVENT_ADDRESS__ Adresse de l'intervention 123 Rue Example, Colmar

🔧 Variables équipement

Variable Remplacée par Exemple
__EQUIPMENT_NAME__ Nom de l'équipement Chaudière Viessmann
__EQUIPMENT_TYPE__ Type d'équipement Chaudière gaz
__EQUIPMENT_SERIAL__ Numéro de série ABC123456
__LAST_MAINTENANCE_DATE__ Date dernier entretien 10/12/2024
__NEXT_MAINTENANCE_DATE__ Date prochain entretien 10/12/2025

4.4 Exemples de modèles

📢 Promotion commerciale

Bonjour __THIRDPARTY_NAME__,

Profitez de -20% sur tous nos services jusqu'au 31/12 !

Code promo : NOEL2025

__MYCOMPANY_NAME__

🔔 Rappel de rendez-vous

Bonjour __THIRDPARTY_NAME__,

Rappel : RDV __EVENT_DATE__ à __EVENT_TIME__ pour l'entretien de votre équipement.

Adresse : __EVENT_ADDRESS__

À bientôt !
__MYCOMPANY_NAME__

💰 Relance facture

Bonjour __THIRDPARTY_NAME__,

Votre facture N°2025-123 arrive à échéance le 15/01.

Merci de procéder au règlement.

__MYCOMPANY_NAME__

🎉 Vœux

Bonjour __THIRDPARTY_NAME__,

Toute l'équipe de __MYCOMPANY_NAME__ vous souhaite une excellente année 2025 !

Merci pour votre confiance.

🔧 Rappel entretien équipement

Bonjour __THIRDPARTY_NAME__,

Votre __EQUIPMENT_TYPE__ nécessite un entretien.

Dernier entretien : __LAST_MAINTENANCE_DATE__
Prochain prévu : __NEXT_MAINTENANCE_DATE__

Merci de nous contacter.
__MYCOMPANY_NAME__

✅ Bonnes pratiques pour les modèles

  • Restez concis : 1 SMS = 160 caractères max
  • Utilisez les variables pour personnaliser
  • Ajoutez toujours votre nom d'entreprise
  • Incluez un appel à l'action clair
  • Testez avec un vrai numéro avant l'envoi massif

4.5 Utiliser un modèle

1 Lors de la création d'une campagne, cliquez sur "Utiliser un modèle"
2 Sélectionnez le modèle souhaité dans la liste
3 Le message est automatiquement chargé avec les variables
4 Vous pouvez encore modifier le message si nécessaire

💡 Astuce

Créez une bibliothèque de modèles pour tous vos besoins courants. Gain de temps garanti !

5️⃣ Gestion des destinataires

5.1 Sources de destinataires

Le module permet de sélectionner des destinataires depuis différentes sources de Dolibarr :

👤 Tiers (Clients/Prospects)

Tous vos clients et prospects enregistrés dans Dolibarr

👥 Contacts

Les contacts rattachés à vos tiers

🏷️ Catégories

Sélection par catégorie de tiers

🔖 Tags

Sélection par tags personnalisés

5.2 Sélection par catégorie

1 Dans la création de campagne, section "Destinataires"
2 Choisissez "Sélectionner par catégorie"
3 Cochez les catégories souhaitées :
  • ✅ Clients VIP
  • ✅ Prospects chauds
  • ✅ Zone géographique spécifique
4 Le système charge automatiquement tous les contacts de ces catégories

5.3 Sélection individuelle

1 Choisissez "Sélection manuelle"
2 La liste complète des tiers/contacts s'affiche avec pagination
3 Cochez les destinataires un par un
4 Naviguez entre les pages pour sélectionner plus de contacts

💡 Pagination intelligente

Le système affiche 50 contacts par page. Votre sélection est conservée lorsque vous changez de page !

5.4 Filtres et recherche

Utilisez les filtres disponibles pour affiner votre sélection :

5.5 Vérification des numéros

ℹ️ Conversion automatique

Le module convertit automatiquement tous les numéros de téléphone au format international :

  • 06 12 34 56 78+33612345678
  • 0612345678+33612345678
  • +33 6 12 34 56 78+33612345678

⚠️ Numéros invalides

Les contacts sans numéro de mobile ou avec numéro invalide sont automatiquement exclus de l'envoi.

Un rapport vous indiquera le nombre de destinataires exclus et la raison.

5.6 Aperçu des destinataires

1 Avant l'envoi, visualisez la liste complète des destinataires sélectionnés
2 Vérifiez le nombre total de SMS qui seront envoyés
3 Consultez le coût estimé de la campagne

✅ Récapitulatif avant envoi

Le système affiche toujours un récapitulatif complet avant l'envoi définitif :

  • 📊 Nombre de destinataires valides
  • ❌ Nombre de destinataires exclus
  • 💰 Coût estimé de la campagne
  • 📝 Aperçu du message avec variables

6️⃣ Envoi et suivi

6.1 Valider le message

1 Rédigez ou sélectionnez votre message avec variables
2 Visualisez l'aperçu du message avec variables remplacées
3 Vérifiez le nombre de caractères (max 160 par SMS)

ℹ️ SMS longs

Si votre message dépasse 160 caractères :

  • Il sera envoyé en plusieurs SMS
  • Chaque SMS supplémentaire coûte 1 crédit
  • Le système vous informe du nombre de SMS par destinataire

6.2 Test avant envoi

💡 Conseil important

Envoyez toujours un SMS test sur votre propre numéro avant l'envoi massif !

1 Cliquez sur "Envoyer un test"
2 Saisissez votre numéro de mobile
3 Vérifiez la réception et le rendu du message

6.3 Lancer la campagne

1 Vérifiez une dernière fois le récapitulatif :
  • Nombre de destinataires
  • Coût total
  • Aperçu du message
  • Expéditeur
2 Cliquez sur "Envoyer la campagne"
3 Confirmez l'envoi dans la popup

✅ Campagne lancée !

L'envoi est lancé. Vous pouvez suivre la progression en temps réel.

6.4 Suivi en temps réel

Pendant l'envoi, vous pouvez suivre :

⚠️ Ne fermez pas la page

Pendant l'envoi de la campagne, ne fermez pas votre navigateur. L'envoi se fait par lots pour garantir la fiabilité.

6.5 Statuts d'envoi

Statut Description
🟡 En cours La campagne est en cours d'envoi
Terminée Tous les SMS ont été envoyés avec succès
⚠️ Partielle Certains envois ont échoué
Échec La campagne a échoué (problème API, crédits insuffisants)
⏸️ Brouillon Campagne créée mais pas encore envoyée

6.6 Gestion des erreurs

En cas d'erreur pendant l'envoi, le système vous informe :

ℹ️ Crédits insuffisants

Si vous n'avez plus assez de crédits en cours d'envoi :

  • L'envoi s'arrête automatiquement
  • Les SMS déjà envoyés restent comptabilisés
  • Vous pouvez relancer la campagne après recharge

7️⃣ Historique et statistiques

7.1 Consulter l'historique

1 Cliquez sur "OVH SMS" dans le menu principal
2 Cliquez sur "Historique des campagnes"

Vous accédez à la liste complète de toutes vos campagnes avec :

7.2 Détails d'une campagne

1 Cliquez sur une campagne dans l'historique
2 Consultez les statistiques détaillées

La fiche de campagne affiche :

📊 Statistiques globales

  • Total envoyés
  • Taux de réussite
  • Coût total
  • Durée d'envoi

📝 Contenu

  • Message envoyé
  • Expéditeur utilisé
  • Modèle utilisé
  • Variables

👥 Destinataires

  • Liste complète
  • Statut par destinataire
  • Heure d'envoi
  • Raison des échecs

⚙️ Configuration

  • Compte OVH utilisé
  • Date de création
  • Utilisateur créateur
  • Catégories ciblées

7.3 Exporter les statistiques

1 Dans la fiche de campagne, cliquez sur "Exporter"
2 Choisissez le format :
  • 📊 Excel : pour analyse détaillée
  • 📄 CSV : pour import dans autre système
  • 📑 PDF : pour rapport client

7.4 Filtres de l'historique

Filtrez l'historique par :

7.5 Rapports mensuels

📊 Tableau de bord

Le module génère automatiquement des statistiques mensuelles :

  • 📈 Évolution du nombre de campagnes
  • 💰 Coût total par mois
  • ✅ Taux de réussite moyen
  • 👥 Nombre de destinataires uniques
  • 🏆 Campagnes les plus performantes

7.6 Relancer une campagne

Vous pouvez facilement relancer une campagne existante :

1 Ouvrez la campagne dans l'historique
2 Cliquez sur "Dupliquer"
3 Modifiez si nécessaire le message ou les destinataires
4 Lancez la nouvelle campagne

✅ Gain de temps

Dupliquez vos campagnes saisonnières (Noël, Pâques, Soldes) au lieu de tout recréer !

8️⃣ Fonctionnalités avancées

8.1 Envoi programmé

🕐 Planifier vos campagnes

Programmez l'envoi de vos campagnes à une date et heure précises.

1 Lors de la création de campagne, cochez "Envoi programmé"
2 Sélectionnez la date et heure d'envoi
3 Enregistrez la campagne
4 La campagne sera automatiquement envoyée à l'heure programmée

Cas d'usage :

8.2 Liens trackés

Ajoutez des liens dans vos SMS pour suivre les clics :

1 Insérez un lien dans votre message : https://votresite.com/promo
2 Le système génère un lien court automatique
3 Consultez les statistiques de clics dans l'historique

ℹ️ URLs courtes

Les liens longs sont automatiquement raccourcis pour économiser des caractères dans vos SMS.

8.3 Listes de diffusion

Créez des listes de diffusion personnalisées pour vos envois fréquents :

1 Allez dans "Listes de diffusion"
2 Créez une nouvelle liste : ex. "Clients VIP", "Zone Nord"
3 Ajoutez les contacts manuellement ou par catégorie
4 Lors d'une campagne, sélectionnez directement la liste

8.4 Réponses automatiques

⚠️ Limitation OVH

Les SMS OVH sont unidirectionnels : les destinataires ne peuvent pas répondre directement.

Pour des échanges bidirectionnels, contactez OVH pour activer cette option (coût suppl.).

8.5 Intégration avec les agendas

Envoyez automatiquement des SMS de rappel depuis vos événements Dolibarr :

1 Créez un événement dans l'agenda Dolibarr
2 Cochez "Envoyer un rappel SMS"
3 Choisissez quand : 24h avant, 1h avant, etc.
4 Le SMS sera envoyé automatiquement

8.6 Variables personnalisées

Créez vos propres variables pour des besoins spécifiques :

1 Allez dans Configuration → Variables personnalisées
2 Créez une nouvelle variable : ex. {montant_du}, {ref_dossier}
3 Associez-la à un champ de Dolibarr
4 Utilisez-la dans vos modèles

💡 Exemple avancé - Rappel intervention

Bonjour __THIRDPARTY_NAME__,

Intervention __EVENT_REF__ programmée le __EVENT_DATETIME__

Lieu : __EVENT_ADDRESS__
__THIRDPARTY_ZIP__ __THIRDPARTY_TOWN__

À bientôt !
__MYCOMPANY_NAME__

8.7 Multi-comptes et règles

Configurez des règles pour utiliser automatiquement le bon compte OVH :

8.8 API et webhooks

ℹ️ Pour développeurs

Le module expose une API REST pour intégrer les SMS dans vos processus automatisés.

Documentation disponible dans Configuration → API SMS

9️⃣ Astuces et bonnes pratiques

9.1 Optimisation des coûts

💰 Économiser vos crédits SMS

  • Restez sous les 160 caractères pour 1 seul SMS
  • Utilisez des liens courts
  • Évitez les accents qui comptent double
  • Groupez vos envois pour mutualiser les coûts
  • Nettoyez régulièrement les numéros invalides

9.2 Meilleur moment d'envoi

Type de campagne Meilleur moment À éviter
📢 Marketing/Promo 10h-12h ou 14h-16h Tôt le matin, tard le soir
🔔 Rappels RDV 9h-18h Week-end, jours fériés
🚨 Urgences Immédiat -
🎉 Vœux 00h01 jour J Veille ou après

9.3 Rédaction efficace

✅ Message efficace

  • Personnalisez avec les variables
  • Soyez concis et clair
  • Ajoutez un appel à l'action
  • Identifiez-vous clairement
  • Incluez une date limite si pertinent

❌ À éviter

  • Messages trop longs
  • Trop d'emojis
  • CAPS LOCK agressif
  • Fautes d'orthographe
  • Informations incomplètes

9.4 Conformité légale

⚠️ RGPD et consentement

Avant d'envoyer des SMS marketing, assurez-vous que :

  • ✅ Le destinataire a consenti à recevoir des SMS
  • ✅ Vous proposez un moyen de se désinscrire
  • ✅ Vous respectez les horaires légaux (8h-20h)
  • ✅ Vous conservez la preuve du consentement

9.5 Tests et validation

1 Testez toujours sur votre numéro avant envoi massif
2 Vérifiez le rendu sur différents téléphones
3 Testez les variables avec plusieurs profils de destinataires
4 Vérifiez les liens et leur accessibilité

9.6 Organisation

📋 Checklist avant envoi

  • ☑️ Message relu et corrigé
  • ☑️ Variables testées
  • ☑️ Destinataires vérifiés
  • ☑️ Expéditeur correct
  • ☑️ Heure d'envoi appropriée
  • ☑️ Crédits suffisants
  • ☑️ Test effectué

9.7 Suivi et amélioration

Analysez vos campagnes pour vous améliorer :

9.8 Maintenance régulière

🗓️ Routine mensuelle

  1. Nettoyez les numéros invalides
  2. Mettez à jour vos modèles
  3. Vérifiez vos crédits OVH
  4. Analysez les statistiques du mois
  5. Archivez les anciennes campagnes

🆘 Support et contact

10.1 Besoin d'aide ?

Notre équipe SBC CONSEILS est à votre disposition pour vous accompagner dans l'utilisation du module OVH SMS.

📧 Email

contact@sbc-conseils.fr

Réponse sous 24h ouvrées

📞 Téléphone

+33 3 89 77 04 77

Lun-Ven 9h-12h / 14h-18h

🌐 Site web

www.sbc-conseils.fr

Documentation et actualités

📍 Adresse

SBC CONSEILS
11 Rue de la gare
68380 Breitenbach
France

10.2 FAQ - Questions fréquentes

❓ Mes SMS ne partent pas, que faire ?

Vérifiez dans l'ordre :

  1. Vos crédits OVH sont suffisants
  2. Les identifiants API sont corrects
  3. Le service SMS OVH est actif
  4. Les numéros sont au format valide

❓ Comment recharger mes crédits SMS ?

Connectez-vous à votre espace client OVH et accédez à la section SMS pour ajouter des crédits.

❓ Puis-je utiliser un autre opérateur qu'OVH ?

Actuellement, le module est conçu pour OVH uniquement. Contactez-nous si vous souhaitez une version pour un autre opérateur.

❓ Les destinataires peuvent-ils répondre ?

Par défaut, les SMS OVH sont unidirectionnels. Pour activer les réponses, contactez OVH pour souscrire à cette option.

❓ Combien coûte un SMS ?

Le prix dépend de votre forfait OVH, généralement entre 0,035€ et 0,055€ par SMS en France. Consultez les tarifs OVH pour plus de détails.

❓ Y a-t-il une limite d'envoi ?

Les limites dépendent de votre compte OVH. Le module lui-même n'impose aucune limite.

10.3 Formation

Nous proposons des formations sur mesure pour maîtriser le module :

💼 Formation sur site

Nous nous déplaçons dans vos locaux pour former vos équipes directement sur votre installation Dolibarr.

Contactez-nous pour un devis personnalisé : contact@sbc-conseils.fr

10.4 Mises à jour

Le module est régulièrement mis à jour avec de nouvelles fonctionnalités et améliorations.

ℹ️ Restez informé

Pour être notifié des mises à jour :

  • 📧 Inscrivez-vous à notre newsletter
  • 🌐 Consultez notre site web
  • 📱 Suivez-nous sur les réseaux sociaux

10.5 Assistance technique

En cas de problème technique, merci de nous fournir :

✅ Support réactif

Notre équipe s'engage à répondre à toutes vos questions dans les meilleurs délais. N'hésitez pas à nous contacter !