Invia il tuo primo SMS di prova cinque minuti dopo aver ricevuto le credenziali.
Richiedi l’accesso di prova e ti risponderemo entro un giorno lavorativo con le tue credenziali di prova. Poi prendi il token, installa l’SDK TypeScript e chiama smsSendsmsPost. Il tuo primo messaggio di prova raggiungerà il tuo numero verificato circa cinque minuti dopo aver ricevuto le credenziali di test. Ogni esempio qui sotto è pronto per essere copiato, e lo step 5 spiega cosa controllare prima della produzione.
Un unico percorso verso il tuo primo messaggio, con i tempi di ogni fase.
- 01
Richiedi l'accesso di prova
Rispondiamo entro 1 giorno lavorativoUn ingegnere della messaggistica risponderà fornendo le tue credenziali di prova e fisserà una chiamata di 30 minuti per discutere i tuoi paesi, volumi e casi d'uso.
- 02
Primo messaggio di test
Circa 5 minuti dopo la ricezione delle credenzialiInvia un messaggio di prova al tuo numero verificato con il codice della guida rapida. La ricevuta di consegna (DLR) torna al tuo webhook.
- 03
Integrazione
2–5 giorni lavorativiCostruire e testare con le proprie credenziali di test utilizzando lo stesso endpoint degli esempi di codice. Un ingegnere BroadNet lavorerà in coppia con voi su REST o SMPP.
- 04
Approvazione
3–10 giorni lavorativiL'identità del mittente, lo scopo del traffico e le regole di destinazione vengono revisionati, e i Sender ID vengono registrati presso ogni autorità regolatrice in parallelo alla tua integrazione.
- 05
Produzione
Giorno del passaggio in produzioneL'accesso alla produzione e i relativi percorsi sono attivati per il vostro account. La vostra integrazione chiama già https://api.broadnet.me.
Totale: 5–15 giorni lavorativi dalla richiesta alla produzione per la maggior parte dei mercati; di più dove la registrazione del Sender ID presso il regolatore richiede più tempo.
- La tua applicazioneInviato tramite REST API o SMPP
- Piattaforma BroadNetValida, instrada e fattura ogni messaggio
- SMSC dell’operatoreConnessione diretta con l'operatore
- Dispositivo dell'abbonatoIl messaggio viene consegnato
Ottieni il tuo token di accesso.
Il tuo access token viene fornito insieme alle credenziali di test: richiedi l'accesso di prova e risponderemo entro un giorno lavorativo. Salvalo nella variabile d'ambiente BROADNET_TOKEN e invialo nell'header Authorization: Bearer in ogni chiamata. Tutti gli esempi in questa pagina utilizzano l'URL base di produzione, https://api.broadnet.me.
Invia un SMS di prova al tuo numero verificato utilizzando POST /sms/sendSms. Un codice 200 OK con nel corpo un ID messaggio conferma che il token è funzionante prima di scrivere qualsiasi altro codice.
Installa l'SDK.
BroadNet offre un SDK ufficiale per TypeScript e Node.js: npm install @broadnet/cpaas-sdk axios. Questo SDK viene generato a partire dalla specifica OpenAPI BroadNet. Per qualsiasi altro linguaggio, è possibile chiamare l'API REST con la propria libreria HTTP abituale oppure generare un client a partire dalla specifica OpenAPI.
npm install @broadnet/cpaas-sdk axios
export BROADNET_TOKEN=your_access_tokenImporta Configuration e SMSSMSApi da @broadnet/cpaas-sdk. Se l'importazione si risolve e il controllo dei tipi passa, sei pronto per inviare.
Invia il tuo primo messaggio.
Crea un'istanza di SMSSMSApi con il tuo URL di base e il tuo token, chiama smsSendsmsPost con senderId, destinationNumber, message e messageType e registra il risultato. Il corpo della risposta è l'ID del messaggio; conservalo per associarlo in seguito allo stato di consegna.
// npm install @broadnet/cpaas-sdk axios
import { Configuration, SMSSMSApi } from "@broadnet/cpaas-sdk";
const sms = new SMSSMSApi(
new Configuration({
basePath: "https://api.broadnet.me",
accessToken: process.env.BROADNET_TOKEN!,
}),
);
const res = await sms.smsSendsmsPost({
sMSSmsRequest: {
senderId: "BroadNet",
destinationNumber: "447700900123",
message: "Your verification code is 482913",
messageType: "TEXT",
},
});
console.log(res.data); // message IDHTTP/1.1 200 OK
2603121407537573731Controlla il telefono che hai in mano. Se hai ricevuto l'SMS, la parte più difficile è fatta: tutto il resto è solo una questione di rifinitura operativa.
Ricevi lo stato della consegna.
BroadNet invia lo stato di consegna all'URL del webhook configurato sul tuo account: SUBMITTED, SENT, DELIVERED, READ sui canali che segnalano le letture, oppure FAILED e REJECTED. Memorizza ogni aggiornamento, rispondi rapidamente con un codice 2xx ed elaboralo in modo asincrono.
import express from "express";
const app = express();
app.post("/webhooks/broadnet", express.json(), async (req, res) => {
// Store the status update first, then acknowledge with a 2xx.
// Statuses: SUBMITTED, SENT, DELIVERED, READ, FAILED, REJECTED.
await db.statusUpdates.insert({ receivedAt: new Date(), body: req.body });
res.sendStatus(200);
});Confermato sul telefono. Gli aggiornamenti precedenti, SUBMITTED e SENT, arrivano man mano che il messaggio si sposta attraverso la rete.
Aperto dal destinatario, sui canali che segnalano letture, come WhatsApp.
Messaggio non consegnato. Verifica il formato del numero e il tuo ID mittente prima di inviare nuovamente.
Invia un messaggio al tuo telefono, poi controlla il registro del server per l'aggiornamento di stato DELIVERED.
Prima della produzione.
L'accesso alla produzione si apre dopo l'approvazione di: identità del mittente, finalità del traffico e ID mittente; il processo richiede 3–10 giorni lavorativi, in parallelo alla tua integrazione. Una volta approvato, lo stesso codice invierà il traffico di produzione. Nel frattempo, mantieni il token fuori dal controllo versione, configura i webhook per lo stato di consegna e definisci la tua policy di retry.
- 01Trasferisci i segreti nel tuo ambiente
Conserva BROADNET_TOKEN in una variabile d'ambiente o nel tuo gestore di segreti, mai nel controllo di versione o nel codice lato client. Sostituiscilo immediatamente se dovesse mai essere divulgato.
- 02Riprova in sicurezza e tieni d’occhio il saldo
In caso di errori di rete e risposte 5xx, riprova con un algoritmo di backoff esponenziale. Ogni messaggio inviato correttamente restituisce un ID, quindi memorizzalo e controlla lo stato di consegna anziché inviare nuovamente il messaggio senza un motivo valido. Gli invii in blocco segnalano i crediti rimanenti in ogni risposta.
- 03Fissa la versione SDK
Specifica una versione precisa @broadnet/cpaas-sdk nel package.json ed esegui l'aggiornamento con attenzione. I percorsi API non hanno un prefisso di versione, quindi segui le modifiche nel changelog e nelle specifiche OpenAPI.
- 04Gestione degli errori tramite codice di stato
Gli errori restituiscono un codice di stato HTTP e un corpo ExceptionResponse con stato, errore, messaggio, errorCode e requestUri. Corregge gli errori 400 e 401; riprova gli errori 5xx con backoff.
- 05Definisci la tua politica sui tentativi
Impostazione predefinita: backoff esponenziale per errori 5xx e di rete, mai per errori 4xx. Dopo un timeout, verificare lo stato di consegna prima di reinviare, poiché la prima richiesta potrebbe essere già stata accettata.
Esegui la checklist qui sotto sul tuo codice. Quando tutte le caselle sono selezionate, la tua integrazione è pronta per la produzione non appena l'approvazione sarà completata.
Gli stessi percorsi di codice gestiscono oltre 300 milioni di messaggi al giorno.
Il tuo traffico di test non è una simulazione. Ogni richiesta, chiave e webhook configurati nei passaggi precedenti passano attraverso lo stesso stack di routing, fatturazione e compliance che gestisce il nostro traffico enterprise — sottoposto ad audit annuale secondo le certificazioni riportate di seguito.
Domande sul quickstart
POST https://api.broadnet.me/sms/sendSms, con un header Authorization: Bearer e un body JSON con senderId, destinationNumber, message e messageType (TEXT o UNICODE). La risposta è l'ID del messaggio. La vecchia API HTTP sotto /websmpp resta disponibile per le integrazioni dell'era SMPP.
Richiedi l'accesso di test su /signup. Un ingegnere BroadNet risponde entro un giorno lavorativo con le tue credenziali di test: il token di accesso da inviare nell'header Authorization: Bearer e l'indirizzo a cui inviare il traffico di test. Il tuo primo messaggio di test può partire circa cinque minuti dopo averle ricevute.
Un solo SDK ufficiale: @broadnet/cpaas-sdk per TypeScript e Node.js, su npm. In qualsiasi altro linguaggio, chiama direttamente la REST API via HTTPS oppure genera un client dalla specifica OpenAPI (/developers/openapi.yaml).
La domanda non è presente in questa sezione? Chiedi al nostro team di ingegneri
Cinque gradini più in basso.
Una sola chiave per andare.
Effettua i test sui tuoi numeri verificati, rilascia l'integrazione e poi passa al traffico live dalla stessa console. Stesso SDK, stessi endpoint, stessi SLA che gestiscono oltre 300 milioni di messaggi al giorno.