Come aggiungo l’invio di SMS alla mia app tramite API?

Passaggi per l’integrazione

1. Ottenete credenziali di test e registrate i numeri di prova a cui invierete.
2. Conservate il token API in un gestore di segreti o in una variabile d’ambiente sul vostro server, mai in un’app mobile o nel codice del browser.
3. Memorizzate i numeri in formato E.164 e convertiteli nel formato richiesto dall’API.
4. Scegliete la codifica: testo GSM-7 oppure Unicode per arabo, emoji e altri alfabeti.
5. Inviate il messaggio e salvate l’ID messaggio restituito accanto al vostro record.
6. Configurate un webhook per ricevere gli stati di consegna.
7. Aggiungete nuovi tentativi con backoff per le risposte 429 e 5xx e registrate i Sender ID per ogni paese che li richiede.

Errori da evitare

• Chiamare l’API dall’app client, esponendo il token a chiunque.
• Inviare numeri con segno più, spazi o zero iniziale nazionale quando l’API si aspetta solo cifre.
• Lasciare che un solo apice tipografico o una sola emoji porti l’intero messaggio in Unicode, riducendo i caratteri per segmento.
• Ritentare alla cieca dopo un timeout. Se l’API non ha una chiave di idempotenza, registrate prima ogni invio e controllatene lo stato prima di rinviare.
• Ignorare le risposte 429 invece di attendere l’intestazione Retry-After.

Esempio: una singola richiesta SMS

Su OmniChannels.ai inviate un SMS con POST https://api.broadnet.me/sms/sendSms, un’intestazione Authorization: Bearer e un corpo JSON. Una chiamata riuscita restituisce 200 con l’ID messaggio come testo semplice. L’accesso di test viene rilasciato dopo una breve richiesta e vale per i vostri numeri verificati; non esiste una registrazione self-service immediata.

Fonti ufficiali

• RFC 9110: HTTP Semantics (IETF)
• ITU-T Recommendation E.164 — The international public telecommunication numbering plan
• 3GPP TS 23.038 — Alphabets and language-specific information