Intégrer le SMS avec Salesforce pour les grandes entreprises au Maroc

Contrairement à une PME qui connecte deux outils via Zapier, l'intégration d'un canal de communication (comme le SMS) dans l'architecture Salesforce d'un grand compte marocain est un projet informatique stratégique. Il ne s'agit pas seulement d'envoyer des notifications : il faut respecter la gouvernance de la donnée, tracer chaque accusé de réception (DLR) dans l'objet Contact, et satisfaire aux exigences strictes de la CNDP.

Voici comment l'architecture doit être pensée pour relier Salesforce à une API SMS souveraine marocaine comme EnvoiSMS.

La plupart des plugins SMS disponibles sur la Salesforce AppExchange (comme SMS Magic ou Twilio) souffrent d'un double défaut pour le marché marocain :

1. La Résidence des Données : Utiliser une App tierce cloud américaine force le flux de données personnelles (Noms, Téléphones des citoyens marocains) à transiter par des serveurs non-agréés par la CNDP.
2. Le Coût de l'Escale : Les tarifs vers la destination +212 sont souvent surfacturés (Premium Routing) sur ces plateformes internationales.

Une solution courante auprès des DSI (Directeurs des Systèmes d'Information) marocains consiste à coder une connexion directe ("Point-à-Point") ou via un Middleware (type MuleSoft) entre Salesforce et l'API locale.

L'approche la plus performante pour déclencher un SMS depuis Salesforce sans passer par une App tierce est d'écrire une classe Apex (Apex Callout) qui invoquera l'API REST de votre fournisseur marocain.

Cette classe est généralement appelée de manière asynchrone (via @future(callout=true) ou un Queueable Apex) depuis un Trigger (ex: Après la création d'une Opportunité) ou depuis un Salesforce Flow.

Exemple simplifié (Apex HTTP Callout) :

public class SmsSender {
    @future (callout=true)
    public static void sendWelcomeSms(String phoneNumber, String customerName) {
        Http http = new Http();
        HttpRequest request = new HttpRequest();
        request.setEndpoint('https://api.envoisms.ma/v1/messages');
        request.setMethod('POST');
        request.setHeader('Content-Type', 'application/json');
        // Ne jamais hardcoder le token. Utilisez Named Credentials ou Custom Settings.
        request.setHeader('Authorization', 'Bearer ' + getApiKey()); 
        
        String payload = '{"from": "MA_BANQUE", "to": "' + phoneNumber + '", "message": "Bonjour ' + customerName + ', votre dossier de crédit est validé."}';
        request.setBody(payload);
        
        try {
            HttpResponse response = http.send(request);
            if(response.getStatusCode() == 202) {
                // Logguer le succès dans un objet personnalisé (ex: SMS_Log__c)
            }
        } catch (Exception e) {
            System.debug('Erreur Callout SMS: ' + e.getMessage());
        }
    }
}

L'avantage de cette méthode d'Apex Callout direct vers EnvoiSMS est la maîtrise de la chaîne de données :

• Salesforce (hébergé en Europe via l'instance locale) pousse le numéro de téléphone et le prénom en SSL (chiffré).
• L'API EnvoiSMS (hébergée au Maroc, soumise aux lois marocaines) reçoit la requête et l'achemine par des routes locales vers IAM, Orange et Inwi, avec bascule automatique entre routes.
• Aucune App tierce (Broker Gris) ne s'intercale entre Salesforce et votre fournisseur SMS. L'audit de conformité pour le DPO (Data Protection Officer) de l'entreprise devient plus simple.

Pour qu'un centre d'appel (utilisant Salesforce Service Cloud) soit efficace, l'agent doit savoir si le SMS d'alerte ou l'OTP a été délivré.

L'architecture complète exige la création d'un Endpoint public (Salesforce Sites ou Apex REST Service) qui écoutera les Webhooks de DLR provenant de la plateforme SMS.
Dès que l'opérateur marocain renvoie le statut DELIVERED (Délivré sur le terminal), l'API EnvoiSMS notifie Salesforce. Le code Apex intercepte ce webhook, recherche l'ID du message, et met à jour un enregistrement "Tâche" (Task) ou un objet personnalisé "Historique SMS" (SMS_History__c) lié à la fiche Contact.

Cette intégration sur-mesure demande quelques jours de développement à un intégrateur Salesforce (Consultant Apex), mais elle donne à l'entreprise marocaine la maîtrise de sa chaîne de données et une facture télécom en MAD.