# API SMS per messaggi critici, tramite REST o SMPP - URL canonico: https://www.broadnet.me/it/products/sms-api - Lingua: it - Ultimo aggiornamento: 2026-10-20 - Editore: BroadNet (https://www.broadnet.me) - Versione Markdown della pagina, generata dalla pagina pubblicata. API SMS · REST + SMPP Un'API SMS che rispetta il tuo tempo 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. [Pianifica la tua integrazione API](https://www.broadnet.me/it/contact?topic=api-integration&product=sms-api) [Richiedi l'accesso di prova](https://www.broadnet.me/it/signup) ISO 27001 · 9001 · 22301 Conforme a GDPR e HIPAA In meno di un secondo p99 POST /sms/sendSms 200 ``` // 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 ID ``` [Riferimento API completo](https://www.broadnet.me/it/developers/api) 42 ms · edge: AMS tempo di attività dell'API 99.99% SLA mensile contrattuale, multiregione latenza API <350ms Obiettivo p99, tutte le regioni SDK ufficiale 1 TypeScript / Node.js + specifica OpenAPI 3.1 Paesi 200+ Oltre 1.000 percorsi diretti gestiti dagli operatori Dentro una sola richiesta ## Cosa succede tra il tuo POST e un report di consegna. Un 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. 1. 01 · Request La tua app · REST POST /sms/sendSms su TLS, autenticazione con token Bearer, corpo JSON: senderId, destinationNumber, message, messageType. p50 < 41ms TTFB 2. 02 · Edge BroadNet API edge Verifica del token, validazione dello schema e scelta della rotta: l'ID del messaggio torna direttamente nella risposta. p50 < 60ms 3. 03 · Router Percorso + coda Il punteggio di qualità per percorso seleziona la connessione SMPP legale più veloce. Failover attivo-attivo multi-regione in meno di 800 ms. p50 < 10ms 4. 04 · Bind Operatore SMPP 3.4 Connessione SMPP diretta all'operatore di rete mobile di destinazione. SMS inviato; numero di sequenza tracciato per la correlazione DLR. p50 < 1.5s 5. 05 · Webhook Report di consegna deliver_sm acquisito e inviato in POST al tuo URL webhook come report di consegna, collegato all'ID del messaggio. p95 < 2s 6. ← rapporto di consegna · webhook 01 · Request La tua app · REST POST /sms/sendSms su TLS, autenticazione con token Bearer, corpo JSON: senderId, destinationNumber, message, messageType. p50 < 41ms TTFB 02 · Edge BroadNet API edge Verifica del token, validazione dello schema e scelta della rotta: l'ID del messaggio torna direttamente nella risposta. p50 < 60ms 03 · Router Percorso + coda Il punteggio di qualità per percorso seleziona la connessione SMPP legale più veloce. Failover attivo-attivo multi-regione in meno di 800 ms. p50 < 10ms 04 · Bind Operatore SMPP 3.4 Connessione SMPP diretta all'operatore di rete mobile di destinazione. SMS inviato; numero di sequenza tracciato per la correlazione DLR. p50 < 1.5s 05 · Webhook Report di consegna deliver_sm acquisito e inviato in POST al tuo URL webhook come report di consegna, collegato all'ID del messaggio. p95 < 2s Protocolli ## REST o SMPP — scegli il tuo protocollo 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. REST · HTTPS api.broadnet.me/sms/sendSms Consigliato - JSON su HTTPS, TLS 1.3 - Autenticazione con token Bearer: il token si ottiene dal tuo account BroadNet - POST /sms/sendSms · una famiglia di percorsi per canale - Invio immediato o programmato - Report di consegna inviati al tuo webhook - Riferimento completo su /developers/api Limiti di velocità Nessun limite fisso per account Carico utile massimo 1 MiB SMPP3.4 2775 in chiaro · porta TLS fornita con il tuo account Volume elevato - SMPP binario v3.4 (v5.0 su richiesta) - Bind Transmitter, Receiver e Transceiver - Fino a 32 bind simultanei per account - Inoltro dei DLR tramite deliver_sm - Bind protetti da TLS, allow-list IP per credenziale - Throughput fino a 30.000 msg/s per nodo nel piano enterprise Per nodo 30k SMS/s Failover <800ms Window 100 msg Quello che otterrai effettivamente ## Sei cose che non dovrai più costruire da solo. ### Tentativi sicuri 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. ### Webhook di consegna 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. ### Connessioni simultanee 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. ### Failover automatico 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 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. ### Specifiche OpenAPI 3.1 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. Storie di clienti ## Quali sono i veri team di ingegneri? dire qualcosa sull'API. Uber Mobilità · MENA AE SA 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. Ingegnere capo, piattaforma di identità Samsung Tecnologia di consumo · APAC ID 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. Ingegnere di staff, piattaforma di messaggistica American Express Servizi finanziari · MENA EG 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. Direttore tecnico, frodi e rischi 1:1 DLR ↔ ID messaggio Bearer Autenticazione a token su ogni chiamata Progettato per la produzione ## I numeri che abbiamo messo per iscritto. Questi obiettivi sono contrattuali e non rappresentano semplici aspirazioni. Se non vengono raggiunti, gli accrediti indicati di seguito saranno applicati automaticamente alla fattura successiva. Uptime dell'API 99.99% SLA mensile Latenza REST p99 <350ms Obiettivo, tutte le regioni Consegna dei webhook <2s p95 end-to-end Risposta agli incidenti <15 min Reperibilità 24/7, presa in carico degli incidenti di severità 1 Impegni relativi ai livelli di servizio [SLA completo](https://www.broadnet.me/legal/sla) Uptime mensile dell'API 99.99% Credito del 10% sotto il 99,99% · 25% sotto il 99,0% · 50% sotto il 95,0% Latenza REST p50 <100ms Sull'edge, escluso l'egress di rete Latenza REST p99 <350ms Su tutte le regioni Consegna dei webhook <2s p95 Backoff esponenziale fino a 24 h in caso di errore Disponibilità dei bind SMPP 99.99% Per regione, con failover automatico tra regioni Risposta agli incidenti <15 min Reperibilità 24/7, presa in carico degli incidenti di severità 1 Documentato di default ## Le ricevute. 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. [npm · @broadnet/cpaas-sdk SDK TypeScript ufficiale 64 classi API, una per funzionalità di canale Vedi su npm](https://www.npmjs.com/package/@broadnet/cpaas-sdk) [broadnet.me/developers/openapi.yaml Specifica OpenAPI 3.1 329 percorsi su otto canali Scarica la specifica](https://www.broadnet.me/developers/openapi.yaml) [broadnet.me/developers Documentazione e guide rapide 90s dalla registrazione al primo messaggio inviato Leggi la documentazione](https://www.broadnet.me/it/developers) TypeScript SDK Autenticazione tramite token al portatore broadnet.me/status Webhook compatibili con ngrok Domande che gli acquirenti pongono ## Domande di ingegneria, ha risposto direttamente. 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](https://www.broadnet.me/it/contact) L'API SMS è un punto di accesso [la piattaforma SMS A2P più ampia](https://www.broadnet.me/it/products/a2p-sms)Gli stessi percorsi diretti degli operatori alimentano anche [Campagne SMS di massa](https://www.broadnet.me/it/products/bulk-sms), [OTP e verifica multicanale](https://www.broadnet.me/it/products/otp), E [L'API di WhatsApp Business](https://www.broadnet.me/it/products/whatsapp-business-api) Fornitori di pesi? Leggi il nostro [La migliore API per SMS nel 2026](https://www.broadnet.me/it/compare/best-sms-api-2026) Guida all'acquisto. Accesso di prova · risposta entro un giorno lavorativo ## Smettila di litigare con il tuo fornitore di SMS. Inizio delle spedizioni. 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. [Vedi il percorso di integrazione API](https://www.broadnet.me/it/contact?topic=api-integration&product=sms-api) [Richiesta di onboarding per sviluppatori](https://www.broadnet.me/it/onboarding) $ curl -X POST https://api.broadnet.me/sms/sendSms -H "Authorization: Bearer $BROADNET_TOKEN" -d '{"senderId":"BroadNet", …}' Risorse Scheda SMS API [Scarica la scheda· PDF, 101 kB](https://www.broadnet.me/resources/datasheets/broadnet-sms-api-datasheet.pdf) [Schede prodotto](https://www.broadnet.me/it/resources) ## Guide e risposte correlate Approfondisci i concetti alla base di questo prodotto. - [Che cos'è un'API SMS Leggi](https://www.broadnet.me/it/answers/what-is-sms-api) - [Come si invia un SMS tramite API Leggi](https://www.broadnet.me/it/answers/how-to-send-sms-via-api) - [Che cos'è SMPP Leggi](https://www.broadnet.me/it/answers/what-is-smpp) - [Che cos'è un SMS A2P Leggi](https://www.broadnet.me/it/answers/what-is-a2p-sms) - [Che cos'è un SMSC Leggi](https://www.broadnet.me/it/answers/what-is-smsc) - [Che cos'è la latenza hop-by-hop nella consegna degli SMS Leggi](https://www.broadnet.me/it/answers/what-is-hop-by-hop-latency)