Configurar una conexión SMPP en Marruecos: guía paso a paso para empresas de alto volumen

La solución estándar de la industria de telecomunicaciones es el protocolo SMPP (Short Message Peer-to-Peer).

Aunque es extremadamente rápido y asíncrono, configurar una conexión SMPP directa con las pasarelas marroquíes requiere un rigor de ingeniería absoluto.

El SMPP (actualmente en v3.4 para la mayoría de las pasarelas) es un protocolo binario que funciona en TCP/IP. A diferencia de HTTP, donde se abre y cierra una conexión para cada envío, el SMPP abre un túnel permanente (un Bind) entre su servidor (el ESME) y la pasarela del proveedor (el SMSC).

Lo que aporta: - Transporte masivo: Usted envía un flujo binario continuo. No hay encabezados HTTP pesados. El caudal ya no está limitado por una solicitud HTTP por mensaje. - DLR nativos y asíncronos: Los informes de entrega (Acuerdos de recepción) llegan desde el operador marroquí (IAM, inwi, Orange) directamente a ese mismo túnel TCP. Ya no necesita exponer un webhook en su servidor.

¿Desde cuándo usarlo? El desarrollo de un cliente SMPP toma 10 veces más tiempo que una integración de API.Utiliza SMPP sólo si tu volumen supera los 1 millones de SMS al mes o si tu SLA de OTP requiere un envío a la pasarela en menos de 100 milisegundos.

Para establecer una conexión SMPP con una pasarela que la ofrezca (en EnvoiSMS, el SMPP solo se ofrece bajo petición, para grandes volúmenes; por defecto, los envíos pasan por nuestra API REST y su endpoint bulk), su proveedor le proporcionará 4 elementos vitales: IP, puerto, System ID (su login) y contraseña.

Pero debes configurar el comportamiento de tu cliente SMPP de una manera óptima:

1. Tipo de vínculo: *

Transmitter (TX): Para enviar únicamente mensajes SMS.

• 'Receiver (RX)': Para recibir solo los DLR y SMS entrantes.
• Transceiver (TRX): Recomendación estándar. Permite enviar y recibir en la misma conexión TCP.

1. Tamaño de ventana: Este es el secreto de la velocidad del SMPP. Este es el número de mensajes que puede enviar en el túnel antes de esperar la confirmación (Acknowledge) del servidor.Si el servidor permite una ventana de 50, envía 50 PDUs asíncronos a la vez.
2. El Enquiry Link (Keep-alive): Dado que el túnel debe permanecer abierto 24/7, tu script debe enviar un enquiry_link cada 30 o 60 segundos para demostrar al servidor operador que todavía estás en línea.

Nunca se conecte directamente a la dirección de producción.Un loop de error de su código SMPP puede inundar el servidor (DDoS involuntario) y causar la suspensión de su IP.

1. Conecte a la Sandbox SMPP del proveedor.
2. Envíe un submit_sm (la solicitud de envío de un SMS) con un número de prueba (por ejemplo: +212600000000).
3. Verifique la recepción del submit_sm_resp con un estado ESME_ROK (Código 0x00000000), lo que significa que el envío está validado.
4. Deje su cliente inactivo durante 10 minutos para comprobar que su mecanismo 'enquire_link' mantiene bien la conexión sin Timeout.

• La codificación DCS (Data Coding Scheme): Este es el problema #1 en Marruecos. En SMPP, debes especificar explícitamente el formato de tu texto. Para el francés estándar, utilice DCS 0x00 (SMSC Default) o 0x01 (ASCII). Para la darija con caracteres árabes, debes obligatoriamente convertir tu texto en hexadecimal y definir el DCS en 0x08 (UCS-2).
• El formato TON/NPI: Para los números de destino marroquíes internacionales (+212), debe configurar el TON (Type of Number) en 1 (International) y el NPI (Numbering Plan Indicator) en 1 (ISDN/E.164).
• Ruptura de la cola: Si tu conexión TCP se interrumpe, todos los SMS de tu RAM no confirmados por la puerta se pierden.Tu cliente debe utilizar un sistema externo como Redis o RabbitMQ para asegurarse de que cualquier mensaje no "Acké" se vuelva a la cola para la próxima conexión.