Envío de SMS mediante el protocolo SMPP

Para iniciar una integración con el envío por medio del protocolo SMPP son imprescindibles los siguientes requisitos:

• Una cuenta de LabsMobile asociada con un nombre de usuario (correo electrónico de registro). Crea una cuenta aquí.
• Es necesario activar el servicio SMPP.
• La cuenta debe tener saldo disponible para permitir el envío de mensajes.

Activación del Servicio SMPP

Para activar este servicio es necesario diligenciar el siguiente formulario de alta del servicio SMPP con los siguientes datos:

• Username asociado a la cuenta.
• Si la cuenta y primera compra han sido validadas.
• Dirección IP del cliente que realizará las conexiones SMPP.
• Estimación de volumen mensual de mensajes.

En un máximo de 72h se crearán las credenciales de la conexión SMPP y se comunicarán por email.

Parámetros de conexión

Los siguientes datos son necesarios para establecer una conexión SMPP y permitir el envío de mensajes SMS. A continuación, se detallan los valores y la función de cada uno de los parámetros requeridos.

PDU SMPP compatibles

El servidor SMPP admite las siguientes PDU, fundamentales para establecer y mantener la comunicación entre el cliente y el servidor. A continuación se detallan sus funciones principales y cómo intervienen en la transmisión y recepción de mensajes SMS.

• Ampliar todo

  Tipos de PDU

  El servidor SMPP admite las siguientes PDU

• bind_transmitter

  Es una solicitud para establecer una sesión SMPP como transmisor (transmitter). El cliente envía este comando al SMSC (servidor) para autenticarse y enviar mensajes SMS salientes.

• unbind

  Se utiliza para cerrar una sesión SMPP de forma correcta. Indicando que ya no necesita mantener la conexión activa.

• submit_sm

  Se encarga de enviar un mensaje SMS a través de una sesión activa.

• deliver_sm

  Es el comando que el SMSC usa para confirmar el estado de entrega del mensaje (DLR).

• enquire_link

  Sirve como ping de mantenimiento para comprobar que la conexión TCP sigue activa entre el cliente y el sevidor.

Envío de SMS (submit_sm)

El comando submit_sm es el método principal para enviar mensajes SMS a través de SMPP. En este apartado se detallan los parámetros clave que deben incluirse en cada solicitud para garantizar el correcto envío del mensaje.

• Ampliar todo

  PARÁMETROS

  Los parámetros o datos se envían cuando se realiza una conexión SMPP. A continuación se describen los valores y funcionalidad de todos los parámetros.

• source_addr_ton integer obligatorio

  Se recomienda usar el valor 5 para remitentes alfanuméricos, 3 para shortcode y 0 o 1 para números internacionales.

  Ejemplo: "source_addr_ton":5

• source_addr_npi integer obligatorio

  Normalmente se utiliza el valor 0 para remitentes tipo shortcode o alfanuméricos. Si el remitente es un número internacional, se debe utilizar el valor 1.

  Ejemplo: "source_addr_npi":0

• source_addr string obligatorio

  Puede ser un número shortcode, un número internacional o un texto alfanumérico, según los valores configurados en TON y NPI. Se debe tener en cuenta que el remitente depende del país de destino. Para más información, puede validar la siguiente documentación.

  Ejemplo: "source_addr":"LABSMOBILE"

• dest_addr_ton integer obligatorio

  Debe establecerse en 1 para indicar que el número es internacional.

  Ejemplo: "dest_addr_ton":1

• dest_addr_npi integer obligatorio

  Debe establecerse en 1 para usar el formato internacional E.164 .

  Ejemplo: "dest_addr_npi":1

• destination_addr string obligatorio

  Se debe indicar que el número es internacional utilizando los valores adecuados en TON y NPI, y el número debe seguir el formato internacional E.164 .

  Ejemplo: "destination_addr":"573124868812"

• short_message string obligatorio

  Texto del mensaje SMS que se desea enviar. La longitud máxima depende de la codificación utilizada data_coding.

  Si se envían SMS estándar sólo son válidos los caracteres del alfabeto GSM 3.38 7bit . Se pueden enviar también SMS Concatenados y SMS Unicode.

  Ejemplo: "short_message":"Hello world!"

• data_coding integer obligatorio

  Define el tipo de codificación del mensaje. Afecta la cantidad de caracteres y el tipo de símbolos permitidos.

  Utilizar valor 0 (SMSC) o 1 (IA5_ASCII) para mensajes estándar. Utilizar 8 (UCS2) si el mensaje contiene caracteres especiales.

  Ejemplo: "data_coding":8

{
  "cmdName":"submit_sm",
  "params":{
    "source_addr_ton":3,
    "source_addr_npi":0
    "source_addr":"LABSMOBILE",
    "dest_addr_ton":1
    "dest_addr_npi":1
    "destination_addr":"573124868812",
    "short_message":"Hello world!",
    "registered_delivery":1,
    "data_coding":1,
    "sm_length":8
    },
  "seqNr":2,
  "cmdStatus":"ESME_ROK"
}
                      

Confirmaciones de entrega (deliver_sm)

Los estados de entrega se incluyen en el campo short_message dentro de la PDU deliver_sm, el cual contiene información del resultado del envío de cada mensaje.

Formato: id:XXXXXXXXXX submit date:YYMMDDHHMM done date:YYMMDDHHMM stat:ZZZZZZZ err:YYY

• id: Identificador del mensaje enviado.
• submit date: Fecha y hora del envío en formato YYMMDDHHMM.
• done date: Fecha y hora en que se completó el intento de entrega en formato YYMMDDHHMM.
• stat: Estado final del mensaje (por ejemplo: DELIVRD, UNDELIV, etc.).
• err: Código de error numérico, presente si el mensaje no fue entregado correctamente.

Ejemplo: short_message: "id:681ca29a4caec submit date:2505081224 done date:2505081225 stat:DELIVRD err:000"