Muchas startups marroquíes (Yassir, Glovo, Chari) empiezan su aventura utilizando Twilio para enviar sus [SMS transaccionales (OTP)](/fr/guides/otp-authentication-maroc/).Este es el reflejo estándar: la documentación es excelente y la API es mundialmente conocida.
Sin embargo, cuando una empresa marroquí escala y alcanza volúmenes críticos (más de 50.000 SMS al mes), Twilio plantea tres problemas principales: 1. El precio (Facturación en USD) : El SMS Twilio a Marruecos (+212) es estructuralmente muy caro (a menudo más de 0.80 MAD) y te expone al riesgo de cambio. 2. La entrega: el tráfico SMS internacional hacia Marruecos es filtrado severamente por los firewalls anti-spam de los operadores cuando el Sender ID no está registrado localmente. La CNDP: Enviar datos de ciudadanos marroquíes a los servidores estadounidenses plantea problemas de cumplimiento legal.
Aquí está el plan de ingeniería (Runbook) para migrar sus flujos a una API local soberana (como EnviarSMS) sin interrupción de servicio.
Preparación: mapeo de funcionalidades
Antes de tocar el código, asegúrese de que el nuevo proveedor soporte sus flujos críticos.
- Sender ID: Twilio permite utilizar un Sender ID alfanumérico sin gran verificación. En Marruecos, tendrá que registrar oficialmente su Sender ID con el proveedor local antes de migrar, so pena de ver sus SMS bloqueados por los operadores (plazo reglamentario ANRT y operadores: de 15 a 30 días, documentos: RC e ICE).
- Webhooks de DLR (Delivery Reports): Si su aplicación escucha los estados 'Delivered' o 'Failed' de Twilio para actualizar una base de datos, deberá mapear el nuevo formato JSON devuelto por la API local.
- Concatenación (Long SMS): Compruebe que la API de destino gestiona automáticamente la concatenación de SMS > 160 caracteres como lo hace Twilio.
Desarrollo (Adaptar la API de carga útil)
La ventaja del SMS es que el protocolo HTTP es universal. La migración de un código Twilio a una API REST estándar (EnvoiSMS) a menudo es cuestión de unas pocas líneas.
Ejemplo Twilio (Node.js) :```javascript
const client = require('twilio')(accountSid, authToken);
client.messages.create({
body: 'Votre code OTP est 1234',
from: 'MA_MARQUE',
to: '+2126XXXXXXXX'
})
.then(message => console.log(message.sid));
**Ejemplo EnviarSMS (Node.js - Fetch) :**```javascript
const response = await fetch('https://api.envoisms.ma/v1/sms/send', {
method: 'POST',
headers: {
'Authorization': `Bearer ${API_KEY}`,
'Content-Type': 'application/json'
},
body: JSON.stringify({
recipient: '+2126XXXXXXXX',
sender_id: 'MA_MARQUE',
message: 'Votre code OTP est 1234'
})
});
const data = await response.json();Despliegue progresivo (Canary Release / Double Run)
El peor error de un CTO es hacer un "Bascule Big Bang" (apagar Twilio y encender el nuevo proveedor inmediatamente en producción).Si el nuevo Sender ID no se propaga bien en inwi, pierdes ventas.
Utilice un enfoque de Rollout Progresivo: 1. Día 1 (10% del tráfico): Configure su backend para redirigir el 10% de las solicitudes de SMS (por ejemplo, sólo los clientes cuyo ID termina en 1) a la API marroquí. Deje el 90% en Twilio. 2. Día 2 (Observación): Analice los registros. ¿La tasa de conversión OTP es la misma? ¿Los DLR (Delivery Reports) se redirigen correctamente de Pending a Delivered? 3. Día 3 (50%): Cambie la mitad del tráfico. 4. Día 7 (100%): Twilio está desactivado y guardado como una única solución de rescate (Fallback).
Gestionar el Fallback (Alta disponibilidad)
Incluso si una plataforma local como EnvoiSMS ofrece rutas locales con conmutación automática, el ecosistema de telecomunicaciones puede sufrir fallos (corte de fibra, mantenimiento IAM).
Mantenga su cuenta Twilio abierta (sin suscripción, en Pay As You Go). Codifica una lógica de Retry Automático: Si la solicitud a la API EnviarSMS falla con un código 500 HTTP o un timeout > 5 segundos, su sistema captura el error (catch) y devuelve el mismo SMS a través de la API Twilio. Así dispone de una ruta de respaldo en caso de incidente, manteniendo la mayor parte de su tráfico en el proveedor local.
Preguntas frecuentes
¿Cómo seguir el enrutamiento en las redes IAM, Inwi y Orange?
Nuestras rutas locales hacia Maroc Telecom (IAM), Orange e inwi, con conmutación automática entre rutas, devuelven un estado de entrega del operador para cada mensaje, por webhook. El plazo de entrega depende del operador y de la red del destinatario.
¿Cómo gestiona la plataforma el formato de los números marroquíes?
EnvoiSMS normaliza automáticamente los números introducidos (06..., 07..., 00212...) al estándar E.164 (+212) para evitar cualquier fallo en la entrega.