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í.
• 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. En el formulario te solicitaran:

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

Con la información anteriormente descrita se establecerá el usuario (system_id) y la contraseña que se manejará para la autenticación.

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.

Las PDUs pueden devolver los siguientes estados:

Parámetros de envío SMS

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 short codes 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 short code 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 short code, 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"
}