SMS API: integra gli SMS nei tuoi software

Integra facilmente e senza costi aggiuntivi i servizi di invio e ricezione SMS nel tuo sito o gestionale grazie alle API SMS Rest di Esendex.

PROVA ORA GRATIS

CONTATTA UN ESPERTO

Forniamo servizi di messaggistica mobile a livello mondiale: 46.000 clienti ci hanno già dato fiducia

Perché scegliere le SMS API di Esendex?

Le API SMS di Esendex permettono di integrare facilmente le funzionalità di invio e ricezione SMS direttamente nei tuoi sistemi informatici, come software gestionali, siti web, piattaforme e-commerce o applicazioni aziendali.

L’integrazione con il nostro SMS Gateway è semplice e veloce grazie alle API REST, progettate per essere compatibili con qualsiasi linguaggio di programmazione e facilmente implementabili in diverse architetture software.

Le API sono costantemente aggiornate per garantire affidabilità, portabilità e sicurezza, e sono sviluppate nel rispetto delle più recenti direttive europee in materia di protezione dei dati e privacy.

Consegna veloce e affidabile

Le nostre connessioni dirette con i maggiori operatori garantiscono la consegna dei tuoi messaggi sia a livello nazionale che internazionale, attraverso le rotte più veloci e di qualità.

Portabilità solida e garantita

Avrai la certezza che i tuoi messaggi urgenti vengano sempre recapitati in tempo. Le nostre SMS API e la nostra piattaforma sono sempre monitorate.

Integrazione facile e veloce

Sarai attrezzato per inviare e ricevere SMS in pochi minuti. La nostra documentazione API ti permetterà di integrare i nostri servizi senza problemi nei tuoi sistemi.

Supporto locale

Avrai accesso ai vantaggi di essere integrato con un’azienda internazionale, ma avendo a disposizione un team di supporto locale. Mettiamo a disposizione dei nostri clienti un account manager dedicato e un team di customer care capaci di rispondere a qualsiasi esigenza.

Massima sicurezza e protezione dei dati

Siamo certificati ISO 27001 e usiamo i massimi protocolli di sicurezza (TLS 1.2 e HTTPS) per proteggere i dati dei nostri clienti. Non facciamo uso di rotte grigie.

Flessibilità e versatilità

L’integrazione al Gateway SMS Esendex permette molteplici utilizzi: invio campagne di SMS marketing, servizi M2M, sistemi di allerta, segnalazione guasti, automazione SMS service, autenticazione a due fattori, comunicazioni a clienti o fornitori, ricezione SMS e molto altro.

Integrazione tecnica delle API SMS Esendex

Struttura delle API

Le SMS API di Esendex sono basate su architettura RESTful e utilizzano il protocollo HTTP/HTTPS per la comunicazione tra client e server. Tutte le richieste devono essere inviate verso l’endpoint API principale app.esendex.it.

Le API supportano:

• metodi HTTP standard (GET, POST)
• payload in formato JSON
• autenticazione tramite session key o access token

Esempio di endpoint per l’invio di SMS:

POST https://app.esendex.it/API/v1.0/sms

Le API SMS REST di Esendex consentono di integrare le funzionalità di invio e gestione degli SMS direttamente all’interno di applicazioni web, piattaforme software e sistemi aziendali attraverso interfacce programmatiche standard basate su protocollo HTTP/HTTPS.

L’integrazione avviene tramite chiamate RESTful API, che permettono alle applicazioni client di interagire con la piattaforma di messaggistica Esendex inviando richieste strutturate contenenti i parametri necessari alla generazione dei messaggi. Le richieste possono includere informazioni come il numero del destinatario, il mittente, il contenuto del messaggio e altri parametri di configurazione.

Una volta ricevuta la richiesta, la piattaforma API elabora il payload e instrada automaticamente il messaggio attraverso l’infrastruttura di SMS Gateway, che gestisce la comunicazione con gli operatori mobili e la consegna al dispositivo del destinatario.

Grazie a questa architettura, le API SMS permettono di integrare il servizio di messaggistica all’interno dei flussi applicativi esistenti e di attivare automaticamente l’invio di messaggi in risposta a eventi generati dai sistemi informatici. Tra i casi d’uso più comuni rientrano:

• conferme di ordine e notifiche di transazione in piattaforme e-commerce
• aggiornamenti sullo stato delle spedizioni e comunicazioni logistiche
• promemoria automatici di appuntamenti o servizi prenotati
• invio di codici OTP (One Time Password) per autenticazione a due fattori o verifica dell’identità
• notifiche operative e alert di sistema per applicazioni IT o piattaforme SaaS

L’utilizzo delle SMS API REST consente quindi di integrare le comunicazioni SMS direttamente nei processi software aziendali, automatizzando completamente la generazione e l’invio dei messaggi senza necessità di interventi manuali.

Inoltre, l’architettura API permette di gestire in modo programmabile l’intero ciclo di vita del messaggio, inclusi:

• l’invio e la schedulazione dei messaggi
• il monitoraggio dello stato di consegna tramite delivery report
• la gestione delle risposte o dei messaggi ricevuti
• l’integrazione con sistemi di logging, monitoraggio o workflow applicativi.

Questo modello di integrazione rende le API SMS uno strumento particolarmente efficace per implementare comunicazioni automatiche, scalabili e affidabili all’interno di applicazioni enterprise e piattaforme digitali.

Autenticazione alle API

Prima di poter utilizzare qualsiasi endpoint delle API SMS REST di Esendex, è necessario eseguire una procedura di autenticazione che consente di verificare l’identità dell’applicazione client e autorizzarne l’accesso alle risorse API.

L’autenticazione avviene tramite HTTP Basic Authentication, utilizzando le credenziali dell’account Esendex. In questo processo, l’applicazione invia una richiesta al servizio di autenticazione includendo email e password API nell’header Authorization, codificate secondo lo standard Base64.

Questa richiesta iniziale consente al sistema di validare le credenziali e generare una sessione autenticata per l’applicazione che sta effettuando la chiamata.

Processo di autenticazione

Il flusso di autenticazione prevede generalmente i seguenti passaggi:

1. L’applicazione client invia una richiesta HTTP al servizio di login delle API Esendex.
2. Le credenziali dell’account vengono trasmesse nell’header Authorization utilizzando il metodo Basic Authentication.
3. Il server API verifica le credenziali e genera una sessione autenticata.
4. In risposta alla richiesta, il sistema restituisce le chiavi di sessione necessarie per effettuare le chiamate API successive.

La risposta dell’endpoint di autenticazione include generalmente due parametri principali che identificano la sessione attiva:

• USER_KEY – identificativo univoco dell’utente o dell’account API
• SESSION_KEY oppure ACCESS_TOKEN – chiave temporanea che autorizza l’accesso alle API durante la sessione

Utilizzo delle chiavi di sessione

Una volta ottenute le chiavi di autenticazione, queste devono essere incluse negli header HTTP delle richieste successive per autorizzare l’accesso agli endpoint delle API.

Le chiavi di sessione permettono alla piattaforma di:

• identificare l’applicazione che sta effettuando la richiesta
• verificare che la richiesta sia autorizzata
• garantire la sicurezza delle comunicazioni tra client e server API

Questo meccanismo di autenticazione consente di gestire in modo sicuro le integrazioni applicative e di controllare l’accesso alle funzionalità della piattaforma SMS.

Per garantire la sicurezza delle comunicazioni, tutte le richieste API devono essere effettuate tramite connessione HTTPS, in modo da proteggere le credenziali e i dati trasmessi tra applicazione e piattaforma Esendex.

Esempi di autenticazione alle API

Le API REST di Esendex supportano diversi metodi di autenticazione per consentire alle applicazioni di accedere in modo sicuro alle funzionalità della piattaforma.

L’autenticazione può avvenire attraverso:

• Session Key (autenticazione basata su sessione)
• User Token / Access Token (autenticazione tramite token)

Entrambi i metodi permettono di autorizzare le richieste API includendo le credenziali negli header HTTP delle chiamate successive.

Autenticazione tramite Session Key

Nel metodo basato su Session Key, l’applicazione esegue inizialmente una richiesta di login utilizzando Basic Authentication.

Le credenziali dell’account (email e password API) vengono codificate in Base64 e inviate nell’header Authorization.

Esempio di richiesta di autenticazione

GET /API/v1.0/REST/login HTTP/1.1
Host: app.esendex.it
Authorization: Basic base64(email:password)

Se le credenziali sono valide, il server API restituisce una risposta contenente le informazioni di autenticazione della sessione.

Esempio di risposta

{
  "user_key": "abc12345",
  "session_key": "xyz98765"
}

Questi due valori identificano la sessione autenticata e devono essere utilizzati negli header delle richieste successive.

Esempio di chiamata API autenticata

POST /API/v1.0/REST/sms HTTP/1.1
Host: app.esendex.it
Content-Type: application/json
user_key: abc12345
session_key: xyz98765

L’inclusione delle chiavi di sessione negli header consente alla piattaforma di verificare l’identità dell’applicazione e autorizzare l’operazione richiesta.

Autenticazione tramite User Token

In alternativa alla sessione temporanea, le API Esendex consentono di autenticare le richieste utilizzando un User Token o Access Token.

In questo caso l’applicazione utilizza un token di accesso generato dall’account Esendex, che viene incluso direttamente negli header delle richieste API.

Questo metodo è particolarmente utile per:

• integrazioni server-to-server
• applicazioni automatizzate
• sistemi che effettuano chiamate API frequenti

Esempio di richiesta con User Token

POST /API/v1.0/REST/sms HTTP/1.1
Host: app.esendex.it
Content-Type: application/json
Authorization: Bearer YOUR_ACCESS_TOKEN

Il token permette al server API di autenticare la richiesta senza la necessità di creare una nuova sessione.

Invio di un SMS tramite API

Una volta completata la fase di autenticazione, l’applicazione può utilizzare gli endpoint delle SMS Send API per generare e inviare messaggi SMS attraverso la piattaforma Esendex.

L’invio dei messaggi avviene tramite richieste HTTP verso l’endpoint dedicato all’invio SMS. La richiesta deve includere un payload contenente i parametri del messaggio e gli header necessari per l’autenticazione.

L’API riceve la richiesta, valida i parametri e instrada automaticamente il messaggio attraverso l’infrastruttura di SMS Gateway, che gestisce la consegna ai diversi operatori mobili.

Parametri principali della richiesta

Per inviare un SMS tramite API è necessario specificare alcuni parametri fondamentali nel payload della richiesta:

• accountreference – identificativo dell’account Esendex utilizzato per l’invio
• messages – array contenente uno o più messaggi da inviare
• to – numero di telefono del destinatario in formato internazionale
• body – contenuto del messaggio SMS
• from – mittente del messaggio (alphanumeric sender ID o numero)

Questo modello permette di inviare sia singoli messaggi sia batch di messaggi verso più destinatari.

Esempio di richiesta API per l’invio di un SMS

Di seguito un esempio semplificato di richiesta HTTP utilizzando il metodo POST verso l’endpoint di invio SMS.

POST /v1.0/messagedispatcher HTTP/1.1
Host: app.esendex.it
Content-Type: application/json
Authorization: Bearer YOUR_ACCESS_TOKEN

Esempio di payload JSON

{
  "accountreference": "EX0000000",
  "messages": [
    {
      "to": "+393491234567",
      "from": "MyCompany",
      "body": "Il tuo codice di verifica è 483921"
    }
  ]
}

In questo esempio:

• il campo accountreference identifica l’account Esendex utilizzato per l’invio
• il campo to indica il numero destinatario
• from definisce il mittente che verrà visualizzato sul telefono del destinatario
• body contiene il testo del messaggio SMS

L’array messages permette inoltre di includere più destinatari nella stessa richiesta, semplificando l’invio di comunicazioni multiple.

Esempio di invio tramite cURL

Il seguente esempio mostra come effettuare una richiesta POST all’endpoint di invio SMS utilizzando cURL, includendo gli header di autenticazione e il payload JSON contenente i parametri del messaggio.

curl -X POST https://app.esendex.it/v1.0/messagedispatcher \
-H "Content-Type: application/json" \
-H "Authorization: Bearer YOUR_ACCESS_TOKEN" \
-d '{
  "accountreference": "EX0000000",
  "messages": [
    {
      "to": "+393491234567",
      "from": "MyCompany",
      "body": "Il tuo codice di verifica è 483921"
    }
  ]
}'

Questo tipo di richiesta può essere implementato facilmente in qualsiasi linguaggio di programmazione che supporti chiamate HTTP REST.

Esempio di integrazione in Python

Il seguente esempio mostra come inviare un SMS utilizzando Python e la libreria requests, effettuando una richiesta POST all’endpoint delle SMS API.

import requests
url = "https://api.esendex.com/v1.0/messagedispatcher"
headers = {
    "Authorization": "Bearer YOUR_ACCESS_TOKEN",
    "Content-Type": "application/json"
}
payload = {
    "accountreference": "EX0000000",
    "messages": [
        {
            "to": "+393491234567",
            "from": "MyCompany",
            "body": "Il tuo codice OTP è 483921"
        }
    ]
}
response = requests.post(url, json=payload, headers=headers)
print(response.status_code)
print(response.json())

Risposta dell’API

Quando la richiesta viene accettata, il server API restituisce una risposta contenente le informazioni relative al messaggio appena generato.

Una risposta tipica include:

• messageid – identificativo univoco del messaggio generato dal sistema
• status – stato iniziale del messaggio all’interno della piattaforma di invio

Il messageid rappresenta il riferimento principale che consente all’applicazione di monitorare il ciclo di vita del messaggio, ad esempio tramite i delivery report o le API di stato.

Esempio di risposta

{
  "messageid": "abc123456",
  "status": "submitted"
}

Lo stato submitted indica che il messaggio è stato accettato dalla piattaforma Esendex ed è stato inserito nella coda di invio verso gli operatori mobili.

Invio di SMS multipli (batch messaging)

Le API SMS permettono inoltre di inviare più messaggi con una singola richiesta. Questo approccio è particolarmente utile per applicazioni che devono gestire grandi volumi di comunicazioni automatiche, come notifiche di servizio o campagne di messaggistica transazionale.

Esempio di richiesta con più destinatari:

{
  "accountreference": "EX0000000",
  "messages": [
    {
      "to": "+393491234567",
      "from": "MyCompany",
      "body": "Il tuo ordine è stato spedito"
    },
    {
      "to": "+393498765432",
      "from": "MyCompany",
      "body": "Il tuo ordine è stato spedito"
    }
  ]
}

Questo tipo di implementazione consente di ottimizzare le prestazioni delle integrazioni API e ridurre il numero di richieste HTTP necessarie per gestire grandi volumi di messaggi.

Monitoraggio dello stato dei messaggi

Dopo l’invio, le applicazioni possono utilizzare le API di Esendex per monitorare lo stato dei messaggi e verificare l’esito della consegna.

Attraverso i delivery report è possibile conoscere informazioni come:

• consegna avvenuta
• messaggio non consegnato
• messaggio in stato pending
• eventuali errori di routing

Queste informazioni possono essere integrate nei sistemi aziendali per aggiornare automaticamente lo stato delle comunicazioni o attivare workflow applicativi basati sugli esiti di consegna.

Questo tipo di richiesta può essere facilmente integrato in qualsiasi linguaggio di programmazione come:

• Python
• PHP
• JavaScript
• Java
• C#

Monitoraggio dello stato dei messaggi

Le API SMS permettono di monitorare lo stato dei messaggi inviati e di ottenere informazioni dettagliate sulla consegna.

Attraverso le chiamate API è possibile:

• verificare se il messaggio è stato consegnato
• controllare eventuali errori di invio
• analizzare lo stato dei messaggi pending o non consegnati
• recuperare lo storico dei messaggi inviati

Queste informazioni permettono di integrare il monitoraggio degli SMS direttamente nei sistemi aziendali, migliorando la gestione delle comunicazioni automatiche.

Integrazione con software e applicazioni aziendali

Le API SMS possono essere integrate in una vasta gamma di applicazioni e piattaforme software.

Alcuni esempi di integrazione includono:

CRM e software gestionali

• notifiche ai clienti
• conferma appuntamenti
• comunicazioni operative

Piattaforme e-commerce

• conferma ordine
• aggiornamenti spedizione
• notifiche di consegna

Applicazioni mobile

• verifica numero di telefono
• autenticazione utenti
• notifiche transazionali

Sistemi IT e monitoraggio

• alert di sistema
• notifiche di sicurezza
• gestione incidenti

Grazie all’architettura REST delle API, l’integrazione può essere implementata rapidamente in qualsiasi ambiente software.

Best practice per l’integrazione delle API SMS

Quando si integrano le API SMS in applicazioni aziendali o piattaforme digitali è importante seguire alcune buone pratiche tecniche per garantire affidabilità, sicurezza e scalabilità delle comunicazioni.

Gestire correttamente l’autenticazione

Le chiavi di autenticazione API devono essere gestite in modo sicuro all’interno dell’infrastruttura applicativa. È consigliabile:

• non inserire credenziali direttamente nel codice sorgente
• utilizzare variabili di ambiente o sistemi di gestione delle chiavi
• limitare l’accesso alle credenziali ai soli servizi che devono utilizzare le API

Una corretta gestione delle chiavi riduce i rischi di accessi non autorizzati e garantisce maggiore sicurezza alle integrazioni.

Gestire errori e retry automatici

Durante l’integrazione è importante prevedere meccanismi di gestione degli errori e tentativi di reinvio automatico (retry).

In alcuni casi l’invio di un SMS può non riuscire immediatamente a causa di:

• problemi temporanei di rete
• timeout nelle richieste API
• indisponibilità momentanea dell’operatore mobile

Implementare logiche di retry controllate consente di migliorare l’affidabilità complessiva del sistema di invio.

Monitorare lo stato dei messaggi

Le applicazioni che utilizzano le API SMS dovrebbero sempre monitorare lo stato dei messaggi inviati.

Attraverso i delivery report è possibile verificare:

• se il messaggio è stato consegnato
• se è ancora in stato pending
• se si è verificato un errore di consegna

Queste informazioni permettono di integrare logiche applicative avanzate, come notifiche alternative o aggiornamenti automatici dello stato delle comunicazioni.

Gestire grandi volumi di invio

Le API SMS sono spesso utilizzate per gestire grandi volumi di messaggi, ad esempio per notifiche automatiche o comunicazioni su larga scala.

Per applicazioni ad alto traffico è consigliabile:

• utilizzare sistemi di queue o message broker
• inviare i messaggi in modo asincrono
• gestire correttamente il rate delle richieste API

Questo approccio permette di migliorare le prestazioni e garantire la scalabilità delle comunicazioni.

Proteggere i dati degli utenti

Quando gli SMS contengono informazioni sensibili — ad esempio codici OTP o notifiche personali — è importante adottare buone pratiche di sicurezza.

Tra queste:

• utilizzare sempre connessioni HTTPS
• limitare la memorizzazione dei dati sensibili
• applicare policy di protezione dei dati conformi alle normative sulla privacy

Un’integrazione sicura delle API SMS contribuisce a proteggere sia l’infrastruttura aziendale sia i dati degli utenti finali.

Documentazione completa per sviluppatori

Per consultare l’elenco completo degli endpoint API, i parametri tecnici e gli esempi di integrazione è possibile accedere alla documentazione ufficiale per sviluppatori.

La documentazione include:

• descrizione dettagliata degli endpoint
• parametri e payload delle richieste
• esempi di integrazione
• gestione degli errori e delle risposte API

In sintesi: le caratteristiche delle nostre API SMS

Gestione di conversazioni bidirezionali

Controlla lo stato dei tuoi SMS

Gestisci account e contatti

Potenzia i dati dei tuoi clienti

Gestisci il tuo credito

Invia messaggi personalizzati a contatti singoli o multipli.

Programma data e ora per l’invio dei tuoi SMS.

Gestisci i messaggi ricevuti dai tuoi clienti.

Crea e salva i template SMS, utilizzando campi dinamici che vengono personalizzati per ciascun destinatario.

Puoi essere certo che i tuoi SMS arrivino a destinazione monitorando lo stato dei tuoi messaggi inviati e la ricevuta di consegna.

Crea e modifica nuovi sub-account, contatti e gruppi di contatti.

Monitora i contatti che hanno chiesto di fare opt-out dalle tue comunicazioni e inseriscili in una lista apposita perché non ricevano più i tuoi messaggi.

Aggiungi metadata ai tuoi messaggi inviati (ad esempio, un codice identificativo per quella campagna o un codice per utente), per poter creare così dei report dettagliati basandoti sulle risposte dai differenti tipi di clienti.

Ottieni informazioni dettagliate sui tuoi destinatari, monitorando il loro comportamento quando inserisci un link nei tuoi messaggi (apertura del link, sistema operativo, ecc.).

Monitora il credito rimanente per ogni account.

Trasferisci credito dall’account principale ai tuoi sub-account.

Sei già integrato con le nostre legacy API e desideri consultarle? Contatta il nostro team per il Customer Success: [email protected]t o 0532-207296.

Ti aiutiamo a costruire esperienze, non solo un software

Le nostre API ti aiutiano a costruire relazioni più forti con i tuoi clienti, usando un’unica piattaforma. Le API sono tutto quello di cui hai bisogno. Leggi come abbiamo aiutato altre aziende a migliorare le loro comunicazioni.

Spotler migliora il coinvolgimento dei clienti integrando il servizio SMS attraverso Esendex

Spotler crea e gestice piattaforme di marketing automation per il B2B. Volevano aggiungere gli SMS alla piattaforma come ulteriore canale di comunicazione. Grazie al programma partner di Esendex, Spotler ha integrato con successo i nostri servizi, permettendogli di migliorare il coinvolgimento e la customer experience dei suoi clienti finali, grazie all’invio di SMS e email.

Leggi il case study completo

Capgemini lancia la soluzione di click&collect grazie alle SMS API di Esendex

Contattata da uno dei maggiori retailers sul mercato per lanciare il loro nuovo servizio di click&collect, Capgemini ha scelto le API SMS di Esendex per rispondere alle necessità del loro cliente. Grazie all’implementazione delle SMS automation, il loro cliente finale ha beneficiato di un significativo aumento delle vendite.

Leggi il case study completo

Vuoi aderire al Programma Reseller di Esendex?

Scopri il programma che meglio rispecchia le tue esigenze

Grazie al Programma Reseller potrai integrare i nostri servizi facilmente, ampliando così la tua offerta. Inoltre, potrai guadagnare ogni qual volta i tuoi clienti faranno un acquisto.