Definizione
Un’API SMS è un’interfaccia web, di solito REST su HTTPS con JSON, che permette al software di inviare SMS, ricevere risposte e ottenere gli stati di consegna in modo programmatico, senza gestire direttamente le connessioni con gli operatori.
Una chiamata tipica invia a un endpoint, con un token API, il destinatario in formato E.164, il Sender ID e il testo, e riceve un ID messaggio. Stati di consegna e risposte in arrivo giungono in seguito tramite webhook.
Rispetto a SMPP, un’API HTTP è più facile da integrare, funziona attraverso i firewall standard e si adatta ad applicazioni serverless e web. SMPP è più efficiente per volumi costanti molto alti.
Buone pratiche: tenere i token lato server, rendere gli invii idempotenti perché i nuovi tentativi non causino doppi invii, gestire le risposte 429 di limite di frequenza e verificare le richieste webhook.
L’API REST di OmniChannels.ai su api.broadnet.me usa l’autenticazione con token Bearer e copre gli SMS insieme a WhatsApp, RCS e altri canali.
Esempio
POST /sms {"to":"+971501234567","from":"AcmeBank","text":"Il codice è 482913"}