API SMS, API SMPP API MS Scheduler
Guida per l'utente
API SMS, API SMPP API MS Scheduler
| Modificato: | 6/24/2025 |
| Versione: | 1.7 |
| Autore: | Kenny Colander Norden, KCN |
Questo documento è destinato esclusivamente al destinatario designato e può contenere informazioni riservate, proprietarie o altrimenti private. Se lo avete ricevuto per errore, avvisate immediatamente il mittente e cancellate l'originale. Qualsiasi altro uso del documento da parte tua è proibito.
Cronologia delle modifiche
| Riv. | Data | By | Modifiche rispetto alla versione precedente |
| 1.0 | Numero di telefono: 2010-03-16 | Il KCN | Creato |
| 1. | Numero di telefono: 2019-06-11 | TPE | Loghi LINK aggiornati |
| 1. | Numero di telefono: 2019-09-27 | PNI | Aggiunto riferimento alla specifica SMPP 3.4 |
| 1. | Numero di telefono: 2019-10-31 | EP | Osservazione sul periodo di validità tag |
| 1. | Numero di telefono: 2020-08-28 | Il KCN | Aggiunte informazioni sulle versioni TLS supportate |
| 2. | Numero di telefono: 2022-01-10 | Il KCN | Aggiunte informazioni aggiuntive riguardanti i rapporti di consegna Informazioni aggiornate riguardanti TLS 1.3 |
| 2. | Numero di telefono: 2025-06-03 | GM | Aggiunto codice risultato 2108 |
| 2. | Numero di telefono: 2025-06-24 | AK | Quota aggiunta |
Introduzione
LINK Mobility è distributore di SMS dal 2001 e ha molta esperienza nel lavorare sia con operatori che con aggregatori di connessioni. Questa piattaforma è progettata per gestire grandi volumi di traffico, mantenere un'elevata disponibilità e semplificare l'instradamento del traffico tramite connessioni multiple.
Questo documento descrive l'interfaccia SMPP alla piattaforma SMSC, quali parametri e comandi sono richiesti e quali parametri sono supportati.
Questo documento non tratterà casi d'uso specifici come messaggi concatenati, WAPpush, Flash SMS, ecc. Ulteriori informazioni su questi casi possono essere fornite contattando l'assistenza.
Comandi supportati
Il server di LINK Mobility deve essere trattato come SMPP 3.4. Le specifiche ufficiali possono essere trovate su https://smpp.org/SMPP_v3_4_Issue1_2.pdf.
Non tutti i metodi sono supportati e tutte le differenze sono specificate di seguito.
4.1 Rilegatura
Sono supportati i seguenti comandi di associazione.
- Trasmettitore
- Ricetrasmettitore
- Ricevitore
Parametri richiesti:
- system_id: ottenuto dal supporto
- password: ottenuta dal supporto
Parametri opzionali:
- addr_ton – valore predefinito se TON è impostato su Sconosciuto durante l'invio.
- addr_npi – valore predefinito se NPI è impostato su Sconosciuto durante l'invio.
Parametri non supportati:
- intervallo_indirizzo
4.2 Separare
Il comando di separazione è supportato.
4.3 Collegamento alla richiesta
Il comando inquire link è supportato e deve essere richiamato ogni 60 secondi.
4.4 Invia
Il metodo di invio deve essere utilizzato per consegnare i messaggi.
Parametri richiesti:
- indirizzo_sorgente
- indirizzo_sorgente_npi
- indirizzo_sorgente
- destinazione_addr_ton
- destinazione_addr_npi
- indirizzo_dest
- classe esm
- codifica_dati
- sm_lunghezza
- breve messaggio
Parametri non supportati:
- tipo di servizio
- protocollo_id
- priorità_flag
- pianificazione_consegna_ora
- sostituisci_se_presente_flag
- sm_default_msg_id
Nota che il carico utile tag non è supportato ed è possibile inviare un solo SMS per chiamata ed è consigliabile che il periodo di validità_periodo tag ha un valore di almeno 15 minuti.
4.4.1 TON e NPI consigliati
I seguenti TON e NPI devono essere utilizzati quando si inviano messaggi utilizzando il comando di invio.
4.4.1.1 Fonte
Le seguenti combinazioni TON e NPI sono supportate per l'indirizzo sorgente. Tutte le altre combinazioni saranno considerate non valide. Il TON predefinito del comando bind verrà utilizzato se TON è impostato su Unknown (0). Il NPI predefinito del comando bind verrà utilizzato se NPI è impostato su Unknown (0).
| TONNELLATA | NPI | Descrizione |
| Alfanumerico (5) | Sconosciuto (0) ISDN (1) |
Verrà trattato come testo del mittente alfanumerico |
| Internazionale (1) | Sconosciuto (0) ISDN (1) |
Verrà trattato come MSISDN |
| Nazionale (2) Specifico della rete (3) Numero dell'abbonato (4) Abbreviato (6) |
Sconosciuto (0) ISDN (1) Nazionale (8) |
Verrà trattato come un numero breve specifico del paese. |
4.4.1.2 Destinazione
Per l'indirizzo di destinazione sono supportate le seguenti combinazioni TON e NPI. Tutte le altre combinazioni verranno considerate non valide. Il TON predefinito dal comando di associazione verrà utilizzato se TON è impostato su Sconosciuto (0). L'NPI predefinito dal comando di associazione verrà utilizzato se NPI è impostato su Sconosciuto (0).
| TONNELLATA | NPI | Descrizione |
| Internazionale (1) | Sconosciuto (0) ISDN (1) |
Verrà trattato come MSISDN |
4.4.2 Codifiche supportate
Sono supportate le seguenti codifiche. X può contenere qualsiasi valore.
| DCS | Codifica |
| 0xX0 | Alfabeto GSM predefinito con estensione |
| 0xX2 | binario a 8 bit |
| 0xX8 | UCS2 (ISO-10646-UCS-2) |
Quota
5.1 Quota superataview
Una quota definisce il numero massimo di messaggi SMS che possono essere inviati entro un intervallo di tempo specificato (ad esempio, al giorno, alla settimana, al mese o indefinitamente). Ogni quota è identificata in modo univoco da un quotaId (UUID) e viene reimpostata in base al fuso orario del cliente. Le quote possono essere assegnate a livello di Paese, regione o predefinito tramite Quota Pro.fileLa quota può anche essere assegnata dinamicamente tramite il Quota Mapping. Questo metodo mappa un QuotaId padre (UUID) e una chiave di quota univoca (ad esempio, mittente o utente) a un QuotaId specifico.
La quota viene impostata in base al supporto locale, al responsabile dell'account assegnato o, se non è specificato nulla, per impostazione predefinita.
5.2 Stato 106 – Quota superata
Un messaggio SMS può essere bloccato con il codice di stato 106 ("quota superata") quando:
- Il messaggio supera il limite definito per il suo quotaId corrispondente nell'intervallo corrente.
- Al paese o alla regione di destinazione non è assegnata alcuna quota (ovvero, è esplicitamente bloccato con una mappatura di quota nulla nel profile).
- Non esiste una quota corrispondente e non è definita alcuna quota predefinita, il che comporta il rifiuto.
In questi casi, il sistema impedisce l'ulteriore elaborazione dei messaggi per applicare limiti basati sul cliente o sulla destinazione ed evitare usi impropri.
Rapporto di consegna
Sono supportate solo nessuna consegna o consegna finale con esito positivo/fallito.
Formato del verbale di consegna: id: xxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxx data di completamento: aaMMggHHmm stat:
Valori disponibili nello stato:
- CONSEGNATO
- SCADUTO
- RIFIUTATO
- NON CONSEGNARE
- CANCELLATO
6.1 Formato del rapporto di consegna esteso
Informazioni estese nei rapporti di consegna possono essere richieste contattando il proprio rappresentante di vendita.
Formato del rapporto di consegna: id: xxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxx sub:000 dlvrd:000 data di invio:
aaMMggHHmm data di esecuzione: aaMMggHHmm stat: ehm: testo:
Valori disponibili nello stato:
- CONSEGNATO
- SCADUTO
- RIFIUTATO
- NON CONSEGNARE
- CANCELLATO
I campi “sub” e “dlvrd” saranno sempre impostati su 000 e il campo “testo” sarà sempre vuoto.
Vedere il capitolo Codici di errore per i valori del campo “err”.
Versioni TLS supportate
TLS 1.2 o TLS 1.3 è richiesto per tutte le connessioni TLS su SMPP.
Il supporto per TLS 1.0 e 1.1 è stato interrotto dal 2020-11-15. Le versioni 1.0 e 1.1 di TLS sono protocolli più vecchi che sono stati deprecati e sono considerati rischi per la sicurezza nella comunità Internet.
LINK consiglia vivamente di utilizzare TLS se oggi vengono utilizzate connessioni SMPP non crittografate. Le connessioni SMPP non crittografate sono deprecate a partire dal 2020-09-01 da LINK e verranno rimosse in futuro. La data per la rimozione delle connessioni non crittografate non è ancora stata decisa.
Le connessioni verso il server SMPP per TLS avvengono sulla porta 3601 anziché non crittografate sulla porta 3600.
Puoi comunque utilizzare TLS anche se la tua implementazione SMPP non supporta TLS utilizzando stunnel, vedi https://www.stunnel.org/
Codici di errore
È possibile rispondere ai seguenti codici di errore nel campo err se il campo è abilitato.
| Codice di errore | Descrizione |
| 0 | Errore sconosciuto |
| 1 | Errore di routing temporaneo |
| 2 | Errore di routing permanente |
| 3 | È stata superata la limitazione massima |
| 4 | Tempo scaduto |
| 5 | Errore sconosciuto dell'operatore |
| 6 | Errore dell'operatore |
| 100 | Servizio non trovato |
| 101 | Utente non trovato |
| 102 | account non trovato |
| 103 | Password non valida |
| 104 | Errore di configurazione |
| 105 | Errore interno |
| 106 | Quota superata |
| 200 | OK |
| 1000 | Inviato |
| 1001 | Consegnato |
| 1002 | Scaduto |
| 1003 | Eliminato |
| 1004 | Cellulare pieno |
| 1005 | In coda |
| 1006 | Non consegnato |
| 1007 | Consegnato, addebito ritardato |
| 1008 | Addebitato, messaggio non inviato |
| 1009 | Addebitato, messaggio non recapitato |
| 1010 | Scaduto, assenza del verbale di consegna dell'operatore |
| 1011 | Addebitato, messaggio inviato (all'operatore) |
| 1012 | In coda da remoto |
| 1013 | Messaggio inviato all'operatore, addebito ritardato |
| 2000 | Numero di origine non valido |
| 2001 | Il numero breve non è supportato come origine |
| 2002 | Alpha non è supportato come origine |
| 2003 | MSISDN non è supportato come numero di origine |
| 2100 | Il numero breve non è supportato come destinazione |
| 2101 | Alpha non è supportato come destinazione |
| 2102 | MSISDN non è supportato come destinazione |
| 2103 | Operazione bloccata |
| 2104 | Abbonato sconosciuto |
| 2105 | Destinazione bloccata |
| 2106 | Errore nel numero |
| 2107 | Destinazione temporaneamente bloccata |
| 2108 | Destinazione non valida |
| 2200 | Errore di ricarica |
| 2201 | L'abbonato ha un saldo basso |
|
2202 |
Abbonato escluso per sovrapprezzo (premio)
messaggi |
|
2203 |
Abbonato troppo giovane (per questo particolare
soddisfare) |
| 2204 | Abbonamento prepagato non consentito |
| 2205 | Servizio rifiutato dall'abbonato |
| 2206 | Abbonato non registrato nel sistema di pagamento |
| 2207 | L'abbonato ha raggiunto il saldo massimo |
| 2208 | È necessaria la conferma dell'utente finale |
| 2300 | Rimborsato |
|
2301 |
Non è stato possibile effettuare il rimborso a causa di articoli illegali o mancanti
MSISDN |
| 2302 | Impossibile effettuare il rimborso a causa della mancanza del messageId |
| 2303 | In coda per il rimborso |
| 2304 | Timeout del rimborso |
| 2305 | Rimborso fallito |
| 3000 | La codifica GSM non è supportata |
| 3001 | La codifica UCS2 non è supportata |
| 3002 | La codifica binaria non è supportata |
| 4000 | Il rapporto di consegna non è supportato |
| 4001 | Contenuto del messaggio non valido |
| 4002 | Tariffa non valida |
| 4003 | Dati utente non validi |
| 4004 | Intestazione dati utente non valida |
| 4005 | Codifica dati non valida |
| 4006 | IVA non valida |
| 4007 | Contenuti non supportati per la destinazione |
Documenti / Risorse
 |
mobilità dei collegamenti API SMS, API SMPP API MS Scheduler [pdf] Guida utente API SMS API SMPP API MS Scheduler, API SMS API SMPP, API MS Scheduler, API Scheduler, API |