Passa al contenuto principale

Inizia con le API SMS di Agile Telecom

Benvenuto nella documentazione SMS di Agile Telecom. Invia SMS agli utenti mobile in tutto il mondo tramite una solida REST API o una connessione binaria SMPP ad alta velocità — con delivery report, ricezione bidirezionale e funzionalità di network intelligence.

Cosa puoi fare​

  • SMS in uscita — Invia SMS transazionali e marketing via REST o SMPP, inclusi messaggi concatenati e Unicode.
  • SMS in ingresso — Ricevi SMS su un numero noleggiato via email o webhook, con semantica di ack +OK.
  • Delivery report (DLR) — Traccia in tempo reale lo stato di consegna di ogni messaggio inviato.
  • Network intelligence — Verifica i numeri con MNP lookup e controlla il credito disponibile prima di inviare.
  • Schedulazione e invio massivo — Invia a migliaia di destinatari in una singola chiamata API.

URL Base​

Endpoint REST:

https://wholesale.agiletelecom.com/services/

Endpoint SMPP:

smpp.agiletelecom.com:2776 (TLS)

Autenticazione​

Due metodi di autenticazione supportati. API Key è consigliata per nuove integrazioni.

  • API Key — Invia X-Api-Key: YOUR_API_KEY in ogni richiesta HTTPS.
  • Basic Auth — Invia Authorization: Basic <base64(user:pass)>.

Entrambi supportano la IP whitelist opzionale come ulteriore layer di sicurezza.

Vedi la guida Autenticazione per gli esempi.

Concetti essenziali​

Sender ID — Identificativo "from" mostrato sul telefono del destinatario. Può essere un numero (short code) o una stringa alfanumerica (max 11 caratteri, dipende dal paese).

Body del messaggio — Fino a 160 caratteri GSM-7 per parte, oppure 70 caratteri UCS-2 per Unicode (emoji, alfabeti non latini). I messaggi più lunghi vengono suddivisi automaticamente in parti concatenate.

Delivery report (DLR) — Notifica asincrona dello stato finale di consegna (DELIVERED, FAILED, EXPIRED…), inviata al tuo webhook in tempo reale.

SMS in ingresso — Messaggi ricevuti su un numero noleggiato da Agile Telecom, inoltrati al tuo webhook o via email.

Credito e MNP — Verifiche in tempo reale del saldo del tuo account e della portabilità del numero, per evitare invii sprecati.

Prossimi passi​

  1. Quick Start — Invia il tuo primo SMS in 3 minuti.
  2. Autenticazione — Metti in sicurezza le richieste.
  3. Invio SMS — Encoding, sender ID, schedulazione e invii massivi.
  4. Delivery Report — Traccia la consegna in tempo reale.
  5. Best Practice — Throughput, opt-out, retry.

Pronto a integrare? Apri la documentazione completa della SMS API sul portale wholesale.