Especialidad technical

Migración de Twilio a un proveedor de SMS marroquí: guía paso a paso

Migrar twilio proveedor de SMS marroquí: guía técnica con ejemplos de código para desarrolladores en Marruecos.

Migración de Twilio a un proveedor de SMS marroquí: guía paso a paso
En este artículo
  1. 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.
  2. Preparación: mapeo de funcionalidades
  3. Desarrollo (Adaptar la API de carga útil)
  4. Despliegue progresivo (Canary Release / Double Run)
  5. Gestionar el Fallback (Alta disponibilidad)

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));

bash

**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.

¿Por qué elegir EnvoiSMS para su negocio?

Entrega a Operadores

Rutas locales hacia IAM, Orange e Inwi, con conmutación automática entre rutas y estado de entrega enviado por webhook.

Optimización de Costes

WhatsApp Business API desde 0,65 MAD por mensaje. El mejor retorno de inversión.

Conformidad CNDP

Alojamiento que cumple con las regulaciones de protección de datos personales locales.

¿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.

Artículos sugeridos

Formateo de SMS en Marruecos: saltos de línea, codificación GSM-7 frente a UCS-2 y optimización de costes
technical

Formateo de SMS en Marruecos: saltos de línea, codificación GSM-7 frente a UCS-2 y optimización de costes

Formato empresarial de WhatsApp en Marruecos: texto enriquecido, emojis y botones interactivos
technical

Formato empresarial de WhatsApp en Marruecos: texto enriquecido, emojis y botones interactivos

Autenticación WhatsApp en 1-Clic y One-Tap Autofill OTP en Marruecos
technical

Autenticación WhatsApp en 1-Clic y One-Tap Autofill OTP en Marruecos