SMS API,SMPP API MS Scheduler API
Guía de usuario
SMS API,SMPP API MS Scheduler API
| Modificado: | 6/24/2025 |
| Versión: | 1.7 |
| Autor: | Kenny Colander Norden, KCN |
Este documento é só para o destinatario designado e pode conter información privilexiada, propietaria ou privada. Se o recibiu por erro, comuníqueo inmediatamente ao remitente e elimine o orixinal. Queda prohibido calquera outro uso do documento por vostede.
Historial de cambios
| Rev | Data | By | Cambios con respecto á versión anterior |
| 1.0 | 2010-03-16 | KCN | Creado |
| 1. | 2019-06-11 | TPE | Logotipos de LINK actualizados |
| 1. | 2019-09-27 | PNI | Engadida referencia á especificación SMPP 3.4 |
| 1. | 2019-10-31 | EP | Observación sobre o período de vixencia tag |
| 1. | 2020-08-28 | KCN | Engadiuse información sobre as versións de TLS compatibles |
| 2. | 2022-01-10 | KCN | Added additional information regarding delivery reports Updated information regarding TLS 1.3 |
| 2. | 2025-06-03 | GM | Added result code 2108 |
| 2. | 2025-06-24 | AK | Added quota |
Introdución
LINK Mobility é distribuidor de SMS desde 2001 e ten moita experiencia traballando tanto con operadores como con agregadores de conexións. Esta plataforma está deseñada para xestionar grandes volumes de tráfico, manter unha alta dispoñibilidade e facilitar o enrutamento do tráfico a través de varias conexións.
This is document describes the SMPP interface to the SMSC-platform and which parameters and commands that are required and which parameters are supported.
This document will not handle specific use cases as concatenated messages, WAPpush, Flash SMS, etc. More information about those cases can be provided by contacting support.
Comandos admitidos
O servidor de LINK Mobility debe tratarse como SMPP 3.4. A especificación oficial pódese consultar en https://smpp.org/SMPP_v3_4_Issue1_2.pdf.
Non se admiten todos os métodos e todas as diferenzas especifícanse a continuación.
4.1 Vincular
Admítense os seguintes comandos de vinculación.
- Transmisor
- transceptor
- Receptor
Parámetros necesarios:
- system_id: obtido do soporte
- contrasinal: obtido do soporte
Parámetros opcionais:
- addr_ton: valor predeterminado se TON está definido como Descoñecido durante o envío.
- addr_npi: valor predeterminado se NPI está definido como Descoñecido durante o envío.
Parámetros non compatibles:
- intervalo_enderezos
4.2 Desvincular
O comando unbind é compatible.
4.3 Consultar ligazón
O comando inquire link é compatible e debe chamarse cada 60 segundos.
4.4 Enviar
O método de envío debe utilizarse para enviar mensaxes.
Parámetros necesarios:
- engadido_fonte
- fonte_addr_npi
- enderezo_fonte
- dest_addr_ton
- dest_addr_npi
- dest_addr
- clase_esm
- codificación_datos
- sm_length
- mensaxe_curta
Parámetros non compatibles:
- tipo_servizo
- protocol_id
- bandeira_prioridade
- horario_de_entrega
- substituír_se_presente_bandeira
- sm_default_msg_id
Nota que a carga útil tag non é compatible e só se pode enviar unha SMS por chamada e recoméndase que validity_period tag ten un valor de 15 minutos de duración como mínimo.
4.4.1 TON e NPI recomendados
Os seguintes TON e NPI deben usarse cando se envían mensaxes mediante o comando enviar.
4.4.1.1 Fonte
The following TON and NPI combinations are supported for source address. All other combinations will be treated as invalid. The default TON from bind command will be used if TON is set to Unknown (0). The default NPI from bind command will be used if NPI is set to Unknown (0).
| TON | NPI | Descrición |
| Alfanumérico (5) | Descoñecido (0) ISDN (1) |
Tratarase como texto do remitente alfanumérico |
| Internacional (1) | Descoñecido (0) ISDN (1) |
Tratarase como MSISDN |
| Nacional (2) Network specific (3) Subscriber number (4) Abbreviated (6) |
Descoñecido (0) ISDN (1) Nacional (8) |
Tratarase como un número curto específico do país. |
4.4.1.2 Destino
As seguintes combinacións TON e NPI son compatibles para o enderezo de destino. Todas as demais combinacións serán tratadas como non válidas. Usarase o comando predeterminado TON de vincular se TON está definido como Descoñecido (0). Usarase o NPI predeterminado do comando bind se NPI está definido como Descoñecido (0).
| TON | NPI | Descrición |
| Internacional (1) | Descoñecido (0) ISDN (1) |
Tratarase como MSISDN |
4.4.2 Codificacións admitidas
Admítense as seguintes codificacións. X pode conter calquera valor.
| DCS | Codificación |
| 0xX0 | Alfabeto GSM predeterminado con extensión |
| 0xX2 | binario de 8 bits |
| 0xX8 | UCS2 (ISO-10646-UCS-2) |
Cota
5.1 Quota Overview
A quota defines the maximum number of SMS messages that can be sent within a specified time interval (such as per day, week, month, or indefinitely). Each quota is uniquely identified by a quotaId (UUID) and is reset according to the customer’s time zone. Quotas can be assigned at the country, region, or default level through a Quota Profile. Quota can also be dynamically assigned using Quota Mapping. This maps a parent QuotaId (UUID) and a unique quota Key (e.g., sender or user) to a specific quotaId.
A quota is set in accordance with your local support, your assigned account manager or by default if nothing is specified.
5.2 Status 106 – Quota Exceeded
An SMS message may be blocked with status code 106 (“quota exceeded”) when:
- The message exceeds the defined limit for its corresponding quotaId within the current interval.
- The destination country or region has no quota assigned (i.e., is explicitly blocked with a null quota mapping in the profile).
- There is no matching quota and no default quota is defined, resulting in rejection.
In these cases, the system prevents further message processing to enforce customer or destination-based limits and avoid misuse.
Informe de entrega
Só se admite ningunha entrega ou a entrega final cun resultado exitoso/fallo.
Formato do informe de entrega: ID: xxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxx Fecha de realización: aaMMddHHmm stat:
Valores dispoñibles no estado:
- ENTREGA
- CADUCADO
- REXEITADA
- UNELIV
- ELIMINADO
6.1 Formato de informe de entrega ampliado
Pódese solicitar información ampliada nos informes de entrega en contacto co seu representante de vendas.
Format on delivery report: id: xxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxx sub:000 dlvrd:000 submit date:
yyMMddHHmm done date: yyMMddHHmm stat: <status> err: <error code> text:
Valores dispoñibles no estado:
- ENTREGA
- CADUCADO
- REXEITADA
- UNELIV
- ELIMINADO
Os campos "sub" e "dlvrd" estarán sempre configurados en 000 e o campo "texto" sempre estará baleiro.
Consulte o capítulo Códigos de erro para ver os valores do campo "err".
Versións TLS compatibles
Requírese TLS 1.2 ou TLS 1.3 para todas as conexións TLS a través de SMPP.
O soporte para TLS 1.0 e 1.1 descontinuouse desde o 2020-11-15. As versións 1.0 e 1.1 de TLS son protocolos máis antigos que quedaron en desuso e considéranse riscos de seguridade na comunidade de Internet.
LINK recoméndase encarecidamente usar TLS se hoxe se están a usar conexións SMPP sen cifrar. As conexións SMPP sen cifrar quedaron obsoletas a partir do 2020-09-01 por LINK e eliminaranse no futuro. A data para a eliminación de conexións sen cifrar aínda non está decidida.
As conexións co servidor SMPP para TLS están no porto 3601 en lugar de sen cifrar no porto 3600.
Aínda podes usar TLS aínda que a túa implementación SMPP non admita TLS usando stunnel, consulte https://www.stunnel.org/
Códigos de erro
Os seguintes códigos de erro pódense responder no campo de erro se o campo está activado.
| Código de erro | Descrición |
| 0 | Erro descoñecido |
| 1 | Erro de ruta temporal |
| 2 | Erro de ruta permanente |
| 3 | Superouse a limitación máxima |
| 4 | Tempo de espera |
| 5 | Erro descoñecido do operador |
| 6 | Erro do operador |
| 100 | Non se atopou o servizo |
| 101 | Usuario non atopado |
| 102 | Non se atopou a conta |
| 103 | Contrasinal incorrecta |
| 104 | Erro de configuración |
| 105 | Erro interno |
| 106 | Quota exceeded |
| 200 | OK |
| 1000 | Enviado |
| 1001 | Entregado |
| 1002 | Caducou |
| 1003 | Eliminado |
| 1004 | Móbil cheo |
| 1005 | En cola |
| 1006 | Non entregado |
| 1007 | Entregado, cargo atrasado |
| 1008 | Cargo, mensaxe non enviada |
| 1009 | Cargo, mensaxe non entregada |
| 1010 | Caducado, ausencia do informe de entrega do operador |
| 1011 | Cargado, mensaxe enviada (ao operador) |
| 1012 | En cola remota |
| 1013 | Mensaxe enviada ao operador, a carga atrasouse |
| 2000 | O número de orixe non é válido |
| 2001 | O número curto non se admite como fonte |
| 2002 | Alpha non é compatible como fonte |
| 2003 | MSISDN non é compatible como número de orixe |
| 2100 | Non se admite o número curto como destino |
| 2101 | Alpha non é compatible como destino |
| 2102 | MSISDN non é compatible como destino |
| 2103 | Operación bloqueada |
| 2104 | Abonado descoñecido |
| 2105 | Destino bloqueado |
| 2106 | Erro de número |
| 2107 | Destino bloqueado temporalmente |
| 2108 | Invalid destination |
| 2200 | Erro de carga |
| 2201 | O abonado ten saldo baixo |
|
2202 |
Subscriber barred for overcharged (premium)
mensaxes |
|
2203 |
Subscriber too young (for this particular
contido) |
| 2204 | Non se permite abonado de prepago |
| 2205 | Servizo rexeitado polo abonado |
| 2206 | Abonado non rexistrado no sistema de pago |
| 2207 | O abonado alcanzou o saldo máximo |
| 2208 | Necesítase confirmación do usuario final |
| 2300 | Reembolsado |
|
2301 |
Could not refund due to illegal or missing
MSISDN |
| 2302 | Non se puido reembolsar debido a que falta o identificador da mensaxe |
| 2303 | En cola para o reembolso |
| 2304 | Tempo de espera do reembolso |
| 2305 | Fallo de reembolso |
| 3000 | Non se admite a codificación GSM |
| 3001 | Non se admite a codificación UCS2 |
| 3002 | Non se admite a codificación binaria |
| 4000 | Non se admite o informe de entrega |
| 4001 | Contido da mensaxe non válido |
| 4002 | Tarifa non válida |
| 4003 | Datos de usuario non válidos |
| 4004 | Cabeceira de datos de usuario non válida |
| 4005 | Codificación de datos non válida |
| 4006 | IVE non válido |
| 4007 | Contido non compatible para o destino |
Documentos/Recursos
 |
link mobility SMS API,SMPP API MS Scheduler API [pdfGuía do usuario SMS API SMPP API MS Scheduler API, SMS API SMPP API, MS Scheduler API, Scheduler API, API |