Tutto ciò che vale la pena sapere, niente di superfluo.
La richiesta
Il gateway di BroadNet accetta una richiesta POST a https://api.broadnet.me/sms/sendSms con un token nell'header Authorization: Bearer e un corpo JSON: senderId (l'ID mittente), destinationNumber (il numero di destinazione in formato internazionale, solo cifre, senza segno +), message (il testo) e messageType (TEXT per GSM-7, UNICODE per arabo, emoji e altri alfabeti non latini). Una chiamata riuscita restituisce 200 OK con l'ID del messaggio nel corpo della risposta.
Codifica e lunghezza
Un messaggio GSM-7 contiene 160 caratteri per segmento (153 quando si estende su più segmenti); passando a Unicode per emoji o alfabeti non latini il limite scende a 70 (67 nei messaggi concatenati). Imposta messageType su TEXT per il GSM-7 semplice e su UNICODE quando il testo richiede Unicode o l'arabo, così i caratteri non vengono corrotti; POST /sms/identify restituisce codifica e numero di segmenti prima dell'invio.
Traccia la consegna, non dare per scontato che
L'ID del messaggio restituito è l'identificativo per le conferme di consegna (DLR). Configura un webhook per ricevere lo stato finale dell'operatore (consegnato, non riuscito o scaduto) anziché considerare un codice 200 all'invio come prova che il dispositivo mobile ha ricevuto il messaggio.
Passaggio alla produzione
Utilizza numeri E.164 internazionali, registra il tuo ID mittente in ogni mercato di destinazione prima di scalare e invia tramite rotte dirette dell'operatore per una latenza costante. Per volumi elevati, lo stesso account è raggiungibile sia tramite SMPP che REST, quindi puoi iniziare con HTTP e cambiare tipo di autenticazione senza dover ripetere la procedura di onboarding.