Integración de SMS con Salesforce para grandes empresas en Marruecos

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.

Aquí está cómo debe pensarse la arquitectura para conectar Salesforce a una API SMS soberana marroquí como EnvoiSMS.

La mayoría de los plugins de SMS disponibles en Salesforce AppExchange (como SMS Magic o Twilio) sufren un doble defecto para el mercado marroquí: 1. La Residencia de Datos: El uso de una Aplicación de terceros en la nube de Estados Unidos obliga el flujo de datos personales (Nombres, Teléfonos de ciudadanos marroquíes) a transitar por servidores no aprobados por la CNDP. 2. El costo de la Escala: Las tarifas hacia el destino +212 a menudo son sobrecargadas (Premium Routing) en estas plataformas internacionales.

Una solución habitual entre los DSI (Directores de Sistemas de Información) marroquíes consiste en codificar una conexión directa ("Point-to-Point") o a través de un Middleware (tipo MuleSoft) entre Salesforce y la API local.

El enfoque más potente para activar un SMS desde Salesforce sin pasar por una App de terceros es escribir una clase Apex (Apex Callout) que invocará la API REST de su proveedor marroquí.

Esta clase generalmente se llama de forma asíncrona (via @future(callout=true) o un Queueable Apex) desde un Trigger (por ejemplo: Después de la creación de una Oportunidad) o desde un Salesforce Flow.

Ejemplo simplificado (Apex HTTP Callout) :```java
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());
}
}
}

La ventaja de este método de Apex Callout directo a EnvoiSMS es el control de la cadena de datos: - Salesforce (hostado en Europa a través de la instancia local) presiona el número de teléfono y el apellido en SSL (encriptado). - La API EnvoiSMS (hostada en Marruecos, sujeto a las leyes marroquíes) recibe la consulta y la encamina por rutas locales hacia IAM, Orange e Inwi, con conmutación automática entre rutas. - Ninguna app de terceros (Broker Gris) se interpone entre Salesforce y su proveedor de SMS. La auditoría de cumplimiento para el DPO (Data Protection Officer) de la empresa se vuelve más sencilla.

Para que un centro de llamadas (utilizando Salesforce Service Cloud) sea eficaz, el agente debe saber si el SMS de alerta o OTP se ha entregado.

La arquitectura completa requiere la creación de un Endpoint público (Salesforce Sites o Apex REST Service) que escuche los Webhooks de DLR procedentes de la plataforma SMS. Tan pronto como el operador marroquí devuelva el estado DELIVERED (Enviado al terminal), la API EnvoiSMS notifica a Salesforce. El código Apex intercepta este webhook, busca el ID del mensaje, y actualiza un registro "Tareas" (Task) o un objeto personalizado "Historia SMS" (SMS_History__c) vinculado a la ficha de Contacto.

Esta integración a medida requiere unos días de desarrollo de un integrador Salesforce (Consultant Apex), pero da a la empresa marroquí el control de su cadena de datos y una factura de telecomunicaciones en MAD.