API SMS per OTP e codici di verifica
Inviate codici monouso dal vostro backend con una richiesta HTTPS all'API REST di BroadNet. È la vostra applicazione a generare e verificare il codice; noi lo consegniamo da un mittente (Sender ID) registrato su rotte dirette verso gli operatori e riportiamo ogni stato al vostro webhook.
curl -X POST https://api.broadnet.me/sms/sendSms \
-H "Authorization: Bearer $BROADNET_TOKEN" \
-H "Content-Type: application/json" \
-d '{
"senderId": "OmniDemo",
"destinationNumber": "971500000000",
"message": "482913 is your OmniDemo code. It expires in 5 minutes. Do not share it.",
"messageType": "TEXT",
"campaignName": "login-otp"
}'
# 200 OK
2603121407537573731Invio di un OTP con l'API SMS. Token, mittente (Sender ID) e numero sono segnaposto.
Risposta breve
Aggiornato
Per inviare un OTP via SMS con OmniChannels.ai, il vostro backend genera il codice e chiama POST /sms/sendSms su https://api.broadnet.me con un token bearer, il vostro mittente (Sender ID), il numero e il messaggio. L'API restituisce un ID del messaggio e gli stati di consegna arrivano al vostro webhook. Sono supportati Unicode e arabo e WhatsApp o la voce possono fare da fallback.
Cosa offre agli sviluppatori l'API SMS per OTP
Una chiamata REST per codice
POST /sms/sendSms con un corpo JSON e un token bearer. La risposta è l'ID del messaggio da memorizzare insieme al tentativo di verifica.
Stati di consegna via webhook
Ricevete SUBMITTED, SENT, DELIVERED, FAILED e REJECTED in un unico formato normalizzato, così sapete quando offrire un nuovo invio o cambiare canale.
Codici Unicode e in arabo
Impostate messageType su UNICODE per l'arabo o altri alfabeti. POST /sms/identify restituisce la codifica e il numero di segmenti prima dell'invio.
Mittenti (Sender ID) registrati
Inviate da un mittente alfanumerico (Sender ID) registrato per il traffico transazionale nei mercati che lo richiedono, come Emirati Arabi Uniti e Arabia Saudita.
Verifica del numero prima dell'invio
POST /sms/lookup controlla un numero sulla rete (HLR e MNP) e vi aiuta a scartare i numeri non validi prima di pagare l'invio di un codice.
Fallback WhatsApp e voce
Passate a un modello di autenticazione WhatsApp o a una chiamata vocale quando l'SMS non viene consegnato o il codice non viene inserito.
SMPP per volumi molto elevati
Se avete già un client SMPP, inviate gli OTP via SMPP 3.4 su TLS sulle stesse rotte e ricevete le conferme sulla sessione.
SDK e server MCP
Usate l'SDK TypeScript @broadnet/cpaas-sdk, la specifica OpenAPI 3.1 o il server MCP per gli agenti IA.
Cosa fa il vostro codice e cosa fa l'API
Una separazione netta mantiene sicura la verifica: il vostro sistema possiede il codice, la piattaforma possiede la consegna.
| Voce | Dettagli |
|---|---|
| Generate il codice | Il vostro backend crea un codice casuale, memorizza un hash con un orario di scadenza e limita i tentativi per numero, dispositivo e indirizzo IP. |
| Inviate l'SMS | POST /sms/sendSms con senderId, destinationNumber (prefisso internazionale più numero, solo cifre), message e messageType. |
| Seguite la consegna | Memorizzate l'ID del messaggio restituito e abbinate gli stati del webhook. Un DELIVERED mancante entro il vostro timeout può avviare un fallback. |
| Verificate il codice | Il vostro backend confronta ciò che l'utente ha digitato con l'hash memorizzato. La piattaforma non controlla né memorizza mai lo stato della vostra verifica. |
| Passate al fallback | Rinviate su WhatsApp con un modello di autenticazione, oppure con una chiamata vocale, che il nostro team attiva con voi. |
| Prezzi | Addebito per segmento SMS in base alla destinazione, alle tariffe di listino pubblicate da BroadNet, senza costi di attivazione né minimo mensile. Vedi i prezzi degli SMS per paese. |
Come integrare l'API SMS per OTP
- 1
Ottenete il token
Richiedete l'accesso; viene rilasciato un token bearer per il vostro account e i messaggi di prova vanno ai vostri numeri verificati.
- 2
Registrate un mittente (Sender ID)
Scegliete un mittente (Sender ID) transazionale e registratelo nei paesi che lo richiedono prima di andare online.
- 3
Scrivete il messaggio
Mettete il codice per primo, indicate il vostro marchio, la scadenza e un avviso di non condivisione. Mantenetelo entro un segmento.
- 4
Inviate e seguite
Chiamate POST /sms/sendSms, memorizzate l'ID del messaggio e gestite gli stati del webhook in modo idempotente.
- 5
Aggiungete fallback e limiti
Aggiungete WhatsApp o la voce come passaggio successivo e limitate la frequenza delle richieste per bloccare l'SMS pumping prima del lancio.
Quando l'API SMS per OTP è la scelta giusta
È la scelta giusta quando
- Integrate nella vostra app la verifica di registrazione, accesso o pagamento e volete il pieno controllo del codice.
- Vi servono OTP verso Emirati Arabi Uniti, Arabia Saudita e altri mercati del GCC e di MENA, in arabo e inglese.
- Volete un'unica API per gli SMS oggi e per il fallback WhatsApp, RCS o voce in seguito.
- Preferite REST e webhook, con SMPP disponibile quando i volumi crescono.
Da sapere prima di iniziare
- Non esiste un endpoint di verifica ospitato: è la vostra applicazione a generare, memorizzare e controllare il codice.
- L'accesso alla produzione è valutato dal nostro team; non c'è una registrazione immediata in autonomia.
- La registrazione del mittente (Sender ID) richiede giorni in alcuni paesi, quindi avviatela prima della data di lancio.
- Gli endpoint OTP sono un bersaglio delle frodi di SMS pumping; elenchi di paesi consentiti, limiti di frequenza e controlli anti-bot sono una vostra responsabilità nell'app.
Canale di riserva (fallback), passo dopo passo
Inviate una sola volta dalla piattaforma o dall'API. Se un passaggio non viene consegnato in tempo, subentra automaticamente il canale successivo e ogni stato torna in un unico formato di webhook.
- 01
WhatsApp
Modello ricco con pulsanti, conferme di lettura e risposte nella casella condivisa
- 02
RCS
Card ricca con il vostro marchio dove telefono e operatore supportano l'RCS
- 03
SMS
Raggiunge ogni telefono cellulare su rotte dirette verso gli operatori
- 04
Voce
Un codice o un messaggio vocale quando il testo non arriva
Domande sull'API SMS per OTP
Come invio un SMS OTP con l'API?
Generate il codice nel vostro backend, poi chiamate POST https://api.broadnet.me/sms/sendSms con un'intestazione Authorization: Bearer e un corpo JSON contenente senderId, destinationNumber, message e messageType. La risposta è l'ID del messaggio e gli stati di consegna arrivano al vostro webhook.
L'API genera e verifica il codice al posto mio?
No. È la vostra applicazione a generare il codice, memorizzarne un hash con una scadenza e controllare ciò che l'utente inserisce. Tenere la verifica nel vostro sistema significa che logica del codice, limiti di tentativi e traccia di audit restano sotto il vostro controllo.
Posso inviare SMS OTP in arabo?
Sì. Impostate messageType su UNICODE. Gli SMS in arabo contengono 70 caratteri per segmento, quindi mantenete il messaggio breve. Potete chiamare prima POST /sms/identify per ottenere la codifica e il numero di segmenti.
Qual è il miglior formato per un messaggio SMS OTP?
Partite dal codice, indicate il vostro marchio, la scadenza e avvertite l'utente di non condividere mai il codice, tutto in un solo segmento. Usate un mittente (Sender ID) transazionale e tenete le offerte fuori, così le reti non filtrano il messaggio come marketing.
Cosa faccio se l'SMS OTP non viene consegnato?
Controllate gli stati del webhook per l'ID del messaggio. Se non vedete DELIVERED, o l'utente non inserisce il codice entro il vostro timeout, offrite un nuovo invio o passate a WhatsApp o a una chiamata vocale. Non riprovate all'infinito sullo stesso numero.
Come proteggo il mio endpoint OTP dall'SMS pumping?
Consentite solo i paesi che servite, limitate la frequenza per numero, dispositivo e indirizzo IP, aggiungete un controllo anti-bot sui moduli pubblici e impostate avvisi sui picchi di richieste verso prefissi insoliti. Anche una verifica del numero prima dell'invio aiuta a scartare i numeri non validi.
Quanto costa un SMS OTP?
Gli SMS OTP sono addebitati per segmento alla tariffa della destinazione. I prezzi di listino indicativi di BroadNet per paese sono nelle pagine dei prezzi degli SMS, ad esempio da US$0.0123 per segmento verso gli Emirati Arabi Uniti. Non ci sono costi di attivazione né minimo mensile; il preventivo conferma le tariffe.
C'è una sandbox?
L'accesso di prova invia ai vostri numeri verificati sulla stessa API, così provate consegna e stati reali prima della produzione. Non c'è una sandbox pubblica separata né una registrazione immediata in autonomia.
Guide su questo argomento
- SMS e OTPMessaggi OTP su WhatsApp e SMS: sicurezza, consegna e frodi9 min di lettura
- SMS e OTPSMS pumping: come funziona la frode AIT e come fermarla9 min di lettura
- IntegrazioneIntegrare una API di messaggistica: REST, SMPP e webhook9 min di lettura
Scoprite altre funzioni della piattaforma
Richiedete l'accesso API per gli SMS OTP
Indicateci paesi, volumi di verifica previsti e mittente (Sender ID). Rilasceremo un token per provare sui vostri numeri e vi aiuteremo a registrare i mittenti (Sender ID).
Descriveteci i vostri sistemi e cosa volete collegare. Un solution engineer vi ricontatterà.