PROTOCOLLO SMPP #
Lo standard SMPP è un protocollo sviluppato appositamente per l’invio di SMS tramite connessioni TCP/IP.
I tipi di connessioni (BIND) supportati sono:
- Transmitter (TX – solo invio messaggi)
- Receivere (RX – solo ricezione notifiche di consegna)
- Transceiver (TRX – invio messaggi + ricezione notifiche)
Agile Telecom come policy di default permette fino a 4 connessioni attive da considerarsi 4 TX + 4 RX oppure 4 TRX. Nel caso sia necessario si può fare richiesta di ulteriori connessioni
I parametri per la connessione sono i seguenti:
| HOST | smpp.agiletelecom.com |
| PORTA | 2776 (TLS) |
| SYSTEM ID | login utente |
| PASSWORD | password utente |
| MODALITA’ | TX, RX o TRX |
| Login-AddrRange | <leave empty> |
| Login-SystemType | <leave empty> |
| Login-TON | 1 |
| Login-DPI | 1 |
| Login-DCS | 0 |
ERRORI GESTITI DALLA PIATTAFORMA SMPP #
Di seguito i possibili errori gestiti dal server.
| ESITO BIND | ERROR NUMBER | VALORE HEX | DESCRIPTION |
| ESME_RINVCMDLEN | 2 | 0x02 | Lunghezza del pacchetto non valida |
| ESME_RINVCMDID | 3 | 0x03 | Comando non valido |
| ESME_RALYBIND | 5 | 0x05 | Utente già connesso (raggiunto limite) |
| ESME_RSYERR | 8 | 0x08 | Errore di sistema |
| ESME_RINVSRCADR | 10 | 0x0A | ADDRESS_RANGE non valido |
| ESME_RBINDFAIL | 13 | 0x0D | Account non valido |
| ESME_RINVPASWD | 14 | 0x0E | Credenziali errate |
| ESME_RINVSYSTYP | 83 | 0x53 | SYSTEM_TYPE non valido |
| ERROR TYPE | ERROR NUMBER | VALORE HEX | DESCRIPTION |
| ESME_RINMSGLEN | 1 | 0x01 | Lunghezza del pacchetto non valida |
| ESME_RINVCMDLEN | 2 | 0x02 | Comando non valido |
| ESME_RINVBNDSTS | 4 | 0x04 | Login non ancora effettuato |
| ESME_RSYERR | 8 | 0x08 | Errore di sistema |
| ESME_RINVSRCADR | 10 | 0x0A | Mittente non valido |
| ESME_RINVDSTADR | 11 | 0x0B | Destinatario non valido |
| ESME_RINVPASWD | 13 | 0x0E | Credenziali errate |
| ESME_RINVSERTYP | 21 | 0x15 | SYSTEM_TYPE non valido |
| ESME_RSUBMITFAIL | 69 | 0x45 | Decoding del testo fallito |
| ESME_RTHROTTLED | 88 | 0x58 | Limite di throughput superato |
| ESME_RINVSCHED | 97 | 0x61 | Data di programmazione invio non valido |
| ESME_RINVEXPIRY | 98 | 0x62 | VALIDITY_PERIOD non valido |
| ESME_RSERTYPDENIED | 259 | 0x103 | Credito insufficiente |
MITTENTE SMS #
Max 16 caratteri per il mittente esclusivamente numerico (es. +391234567890123) oppure max 11 caratteri per il mittente alfanumerico (es. AZIENDA ABC).
Dal 16/10/2013 la delibera prevede: n. 42/13/CIR dell’Agcom.
MESSAGE_ID PER NOTIFICA #
Il message_id restituito dal pacchetto SUBMIT_SM_RESP e utilizzato dalla operazione DELIVER_SM per la consegna delle notifiche usa di default un UUID con il seguente formato: AGILE-XXXXXXXX-XXXX-XXXX-XXXX
Se la piattaforma del cliente non supporta tale formato può essere richiesto il formato diverso da concordare.
FORMATO DATA NELLA NOTIFICA DI CONSEGNA #
Nel pacchetto DELIVER_SM la stringa che indica la data di consegna del messaggio contiene anche l’informazione dei secondi e si presenta con questo formato: yyMMddHHmmss
VINCOLO DI INVIO DA IP #
Di default la piattaforma è aperta a tutti gli ip, ma se necessario il cliente può richiedere di vincolare l’utilizzo dell’account solamente da determinati indirizzi o subnet IP
