Un'API SMS consente al tuo software di inviare messaggi di testo, come codici monouso e avvisi, con una singola richiesta HTTP: con BroadNet, il tuo codice chiama POST /sms/sendSms con un token Bearer o si connette tramite SMPP per pipeline ad alto volume. Documentata in una specifica OpenAPI 3.1. Un SDK ufficiale TypeScript. Report di consegna tramite webhook. Accesso di prova su richiesta.
// 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 IDUn handshake TLS, cinque hop ottimizzati, due webhook. Ogni fase ha il proprio budget di latenza, e ogni budget è nello SLA, non nella pagina di marketing.
POST /sms/sendSms su TLS, autenticazione con token Bearer, corpo JSON: senderId, destinationNumber, message, messageType.
Verifica del token, validazione dello schema e scelta della rotta: l'ID del messaggio torna direttamente nella risposta.
Il punteggio di qualità per percorso seleziona la connessione SMPP legale più veloce. Failover attivo-attivo multi-regione in meno di 800 ms.
Connessione SMPP diretta all'operatore di rete mobile di destinazione. SMS inviato; numero di sequenza tracciato per la correlazione DLR.
deliver_sm acquisito e inviato in POST al tuo URL webhook come report di consegna, collegato all'ID del messaggio.
POST /sms/sendSms su TLS, autenticazione con token Bearer, corpo JSON: senderId, destinationNumber, message, messageType.
Verifica del token, validazione dello schema e scelta della rotta: l'ID del messaggio torna direttamente nella risposta.
Il punteggio di qualità per percorso seleziona la connessione SMPP legale più veloce. Failover attivo-attivo multi-regione in meno di 800 ms.
Connessione SMPP diretta all'operatore di rete mobile di destinazione. SMS inviato; numero di sequenza tracciato per la correlazione DLR.
deliver_sm acquisito e inviato in POST al tuo URL webhook come report di consegna, collegato all'ID del messaggio.
La maggior parte dei team utilizza REST e non torna più indietro. Gli operatori ad alto volume, gli aggregatori e le infrastrutture legacy si connettono a SMPP 3.4. Stessi percorsi, stesso SLA, stessa dashboard: scegli l'interfaccia più adatta al lavoro.
Ogni invio accettato restituisce un ID messaggio. Riprova su errori di rete e 5xx con backoff, e riconcilia i report di consegna per ID messaggio invece di reinviare alla cieca: i worker in background possono andare in crash e ripartire in modo pulito.
Le ricevute di consegna vengono inviate al tuo URL webhook e collegate all'ID messaggio, sia per il traffico REST sia SMPP: nessun ciclo di polling da scrivere.
Fino a 32 connessioni SMPP parallele per account. Multiplexing HTTP/2 su REST. Nessun limite di velocità fisso per account: il throughput è dimensionato sul tuo traffico, mai limitato per connessione.
Multi-regione attivo-attivo. Se un percorso si degrada a metà campagna, ci riconnettiamo in meno di 800 ms e rimettiamo in coda i messaggi in transito. Non è necessario implementare alcuna logica di riconnessione SMPP.
Nessun limite di velocità fisso per account: il throughput è dimensionato sul tuo traffico, fino a 30.000 SMS/sec per nodo. Nessun rallentamento silenzioso, nessun numero bloccato di nascosto: sai sempre qual è la tua situazione.
Leggibile dalle macchine, pubblicata su /developers/openapi.yaml. L'SDK TypeScript ufficiale è generato da essa; genera un client in qualsiasi altro linguaggio o importala in Postman o Insomnia.
Sfida: uno stack di messaggistica con più fornitori generava OTP duplicati durante le raffiche di tentativi, un bug aperto da tempo. Approccio: una migrazione all'API REST di BroadNet con un unico percorso di invio, nuovi tentativi solo su errori di rete e 5xx, e ogni invio tracciato tramite l'ID messaggio restituito dall'API, rilasciata dietro un unico feature flag.
Sfida: un'organizzazione di messaggistica con numerosi sviluppatori perdeva continuamente tempo per modifiche API non documentate tra una release e l'altra. Approccio: la specifica OpenAPI 3.1 è trattata come contratto, con client tipizzati rigenerati in CI a ogni release.
Sfida: il team antifrode non si fidava degli eventi di consegna in ingresso che non poteva ricondurre a un invio. Approccio: ogni report di consegna viene abbinato all'ID messaggio restituito all'invio, con la rotazione dei Sender ID gestita nello stesso flusso.
Questi obiettivi sono contrattuali e non rappresentano semplici aspirazioni. Se non vengono raggiunti, gli accrediti indicati di seguito saranno applicati automaticamente alla fattura successiva.
L'SDK TypeScript ufficiale è generato dalla specifica pubblica OpenAPI 3.1, quindi i due non divergono mai. Genera un client in qualsiasi altro linguaggio o importa la specifica in Postman. La documentazione gira sullo stesso ambiente di staging del tuo codice.
Richiedi l'accesso di prova e ti rispondiamo entro un giorno lavorativo con le credenziali di prova; il primo messaggio di prova arriva al tuo numero verificato circa cinque minuti dopo. Il traffico di produzione in genere parte entro 5–15 giorni lavorativi, in base alla registrazione del Sender ID presso il regolatore, non per qualcosa che dipende da noi.
Riprova solo in caso di errori di rete e 5xx, con backoff esponenziale, e conserva l'ID messaggio che l'API restituisce per ogni invio accettato. Riconcilia i report di consegna per ID messaggio prima di reinviare, invece di riprovare alla cieca, e ricarica i crediti prima che un saldo basso blocchi il traffico.
Reale. La specifica OpenAPI 3.1 su /developers/openapi.yaml (JSON su /developers/openapi.json) documenta ogni canale: SMS, WhatsApp, RCS, Telegram, Push, Email, Messenger e Instagram. L'SDK TypeScript ufficiale (@broadnet/cpaas-sdk) è generato da essa, e puoi generare il tuo client in qualsiasi altro linguaggio senza chiedercelo.
Non ci sono costi API: si paga per messaggio, per paese e per percorso. Le transazioni negli Emirati Arabi Uniti partono da $0,0123/MT, in Arabia Saudita da $0,016 e in Egitto da $0,028. Le connessioni SMPP sono incluse nel piano Enterprise; nel piano Standard ogni connessione dedicata costa $250 al mese. L'accesso di prova è disponibile su richiesta e il traffico di prova è limitato a 1.000 messaggi al giorno.
Effettuiamo un nuovo tentativo con un intervallo di tempo esponenziale di 24 ore: 30 secondi, 2 minuti, 10 minuti, 30 minuti, 2 ore, 8 ore, 24 ore. Ogni tentativo include un'intestazione X-Webhook-Attempt. Dopo 24 ore, l'evento viene inserito nella coda dei messaggi non recapitabili (DLQ), consultabile e riproducibile dalla dashboard con un solo clic. Il piano Standard mantiene la DLQ per 7 giorni; il piano Enterprise per 90.
Sì: condividono instradamento, DLR, fatturazione e dashboard. La maggior parte dei clienti usa REST per il transazionale e SMPP per il marketing ad alto volume sullo stesso account, e i report di consegna di entrambi i percorsi arrivano negli stessi report e webhook.
Responsabile tecnico dedicato, SLA di uptime API del 99,99% con crediti di servizio sul canone mensile (10% sotto il 99,99%, 25% sotto il 99,0%, 50% sotto il 95,0%), cercapersone NOC 24 ore su 24, 7 giorni su 7 con risposta sev-1 entro 15 minuti, binding SMPP dedicati, revisioni trimestrali dell'architettura e un canale Slack condiviso con il team di ingegneria.
broadnet.me/status mostra lo stato dei componenti e gli eventuali incidenti segnalati. Non è ancora alimentato dal monitoraggio in tempo reale, quindi la cronologia degli ultimi 90 giorni è indicativa e non rappresenta una misurazione; il dato contrattuale corrisponde al 99,99% di uptime previsto dall'SLA.
La domanda non è presente in questa sezione? Chiedi al nostro team di ingegneri
L'API SMS è un punto di accesso la piattaforma SMS A2P più ampiaGli stessi percorsi diretti degli operatori alimentano anche Campagne SMS di massa, OTP e verifica multicanale, E L'API di WhatsApp Business
Fornitori di pesi? Leggi il nostro La migliore API per SMS nel 2026 Guida all'acquisto.
Un token di accesso, un SDK TypeScript ufficiale e una guida rapida che sta in una sola schermata. La via più rapida dalla registrazione alla tua prima ricevuta di consegna.
Risorse
Scheda SMS API
Approfondisci i concetti alla base di questo prodotto.