Intégrer l'envoi SMS dans Odoo au Maroc : guide complet (très demandé localement)

Intégrer une API SMS marocaine souveraine (comme EnvoiSMS) dans votre instance Odoo (V15, V16, V17) permet d'automatiser le suivi des livraisons, le recouvrement des factures ou les relances commerciales. Voici le guide d'intégration.

Le marché marocain a longtemps été dominé par des logiciels de gestion disparates (un logiciel pour la compta, un fichier Excel pour le stock). Odoo a unifié tout cela.
Cependant, le module "SMS Marketing" natif d'Odoo pose souvent problème au Maroc :

• Il utilise par défaut des routes IAP (In-App Purchases) internationales (souvent chères vers le +212).
• Il ne gère pas bien le Sender ID Alphanumérique localisé.
• Il manque de conformité avec la CNDP marocaine (les numéros partent sur des serveurs étrangers).

La solution ? Connecter votre propre passerelle SMS marocaine via l'API d'EnvoiSMS à Odoo.

Si vous utilisez Odoo Studio ou avez accès aux paramètres techniques, vous pouvez surcharger la passerelle SMS d'Odoo.

1. Allez dans Paramètres > Technique > Passerelles SMS (Activez le mode développeur).
2. Créez une nouvelle passerelle pointant vers l'URL de l'API EnvoiSMS : https://api.envoisms.ma/v1/messages.
3. Dans la configuration du Header, ajoutez votre clé API : Authorization: Bearer VOTRE_TOKEN.
4. Mappez les paramètres de la requête POST (le numéro de destination to et le message).

Avantage : Vous continuez d'utiliser les boutons "Envoyer un SMS" natifs de l'interface Odoo.

C'est la méthode préférée des intégrateurs Odoo marocains pour les automatisations complexes (ex: "Envoyer un SMS dès qu'un Bon de Livraison est validé").

Dans Actions Automatisées (Automated Actions), créez une règle sur le modèle stock.picking (Livraison).
Choisissez l'action "Exécuter du code Python".

import requests
import json

# Variables Odoo
client_phone = record.partner_id.mobile
order_name = record.origin

if client_phone:
    url = "https://api.envoisms.ma/v1/messages"
    payload = json.dumps({
      "from": "MA_SOCIETE",
      "to": client_phone,
      "message": f"Bonjour, votre commande {order_name} est en route !"
    })
    headers = {
      'Authorization': 'Bearer VOTRE_API_KEY',
      'Content-Type': 'application/json'
    }
    
    # Envoi asynchrone pour ne pas bloquer l'interface Odoo
    requests.request("POST", url, headers=headers, data=payload, timeout=5)

Une fois l'intégration réussie, voici les 3 automatisations les plus rentables pour une PME marocaine :

1. Le recouvrement de créances (Module Invoicing) :

Créez une action planifiée (Cron) qui détecte les factures échues depuis 5 jours.
"Rappel : Votre facture F-2026/145 est arrivée à échéance. Merci de procéder au règlement." -> Réduit drastiquement les retards de paiement.

1. Le suivi e-commerce (Module Ventes & Inventaire) :

La peur du client E-commerce au Maroc est le manque de suivi. Un SMS envoyé dès que le statut passe à "Prêt à être expédié" réduit les appels au service client.

1. Les rappels de rendez-vous (Module Calendrier/Services) :

Pour les prestataires de services, envoyez un SMS à H-24 avant l'intervention (ex: installation de climatisation).

Si votre flux Odoo dépasse les 10 000 SMS par jour, évitez les "Actions Automatisées" avec du code Python synchrone (qui risquent de ralentir les workers de votre serveur Odoo).
Faites appel à un partenaire intégrateur Odoo pour créer un module personnalisé (Custom Addon) qui gérera l'envoi de SMS en arrière-plan via une file d'attente asynchrone (Celery / Job Queue) couplée à l'API EnvoiSMS. Vous allierez ainsi la robustesse de l'ERP à la délivrabilité des routes locales vers les opérateurs marocains.