EN

Envío de SMS mediante el protocolo SMPP

El protocolo abierto SMPP permite a técnicos y empresas integrar sus aplicaciones con la plataforma de mensajería SMS de LabsMobile utilizando un estándar ampliamente adoptado en las telecomunicaciones. Este protocolo es utilizado para el intercambio de mensajes SMS entre centros de servicio de mensajes cortos (SMSC) y aplicaciones externas de envío.

Las funcionalidades por medio del protocolo SMPP son:

Esta documentación explica detalladamente el proceso de integración y automatización de estas funcionalidades.

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.

A tener en cuenta

Esta documentación se corresponde al protocolo SMPP versión 3.4.

Recomendamos el uso de nuestra API http/POST.


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.

Solicitar alta servicio SMPP

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.

Valores de conexión
system_idIdentificador de usuario asignado para la autenticación SMPPB000123456
passwordContraseña asociada al system_idKz234d&5
hostIP o dominio del servidor SMPPsmpp.labsmobile.com
portPuerto TCP para establecer la conexión2775
bind_type Define qué operaciones puede realizar el cliente.bind_transceiver

Recomendación Asegúrese de que la IP proporcionada esté correctamente configurada para establecer conexiones salientes hacia el servidor SMPP. Además, recomendamos utilizar una IP estática y un servidor dedicado para garantizar la estabilidad y seguridad de la conexión.

Recomendación Recomendamos activar las Recargas automáticas para que siempre existan créditos disponibles en la cuenta y no se interrumpa el servicio de envío SMS.


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

Las PDUs pueden devolver los siguientes estados:

Respuestas de estado de PDU
ESME_ROKIndica que la operación fue aceptada correctamente.
ESME_RUNKNOWNERRCódigo de error genérico que indica un error desconocido en el servidor SMPP o falta de saldo en la cuenta.

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.

Ejemplo de formato
{
  "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"
}
                      

Importante El código ESME_ROK indica que la petición fue aceptada, pero no implica que el mensaje fue entregado al dispositivo del usuario. Se debe esperar un DLR para conocer el estado final de entrega.

Recomendación En caso de recibir ESME_RUNKNOWNERR, verifique que su cuenta tenga saldo disponible para realizar envíos. Además, asegúrese de que se está especificando correctamente el número telefónico de destino y el contenido del mensaje.


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"

A continuación se describe cada uno de los estados de entrega:

Valores de estado
DELIVRDEstado de entrega que indica que el mensaje fue entregado exitosamente al dispositivo del destinatario.
UNDELIVNo ha sido posible entregar el mensaje, normalmente porque el número es incorrecto.
REJECTDMensaje rechazado por alguna política del operador o por el dispositivo móvil.