# Invia il tuo primo SMS di prova cinque minuti dopo aver ricevuto le credenziali. - URL canonico: https://www.broadnet.me/it/developers/quickstart - Lingua: it - Ultimo aggiornamento: 2026-10-21 - Editore: BroadNet (https://www.broadnet.me) - Versione Markdown della pagina, generata dalla pagina pubblicata. Guida rapida per sviluppatori 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. [Richiedi l'accesso di prova](https://www.broadnet.me/it/signup) [Riferimento API completo](https://www.broadnet.me/it/developers/api) Progressi 0 / 5 passaggi · 5 min 0/5 Passi rimanenti 5 1. Ottieni il tuo token di accesso Passo 1 · 30 sec 2. Installa l'SDK Passo 2 · 45 sec 3. Invia il tuo primo messaggio Passo 3 · 60 sec 4. Ricevi lo stato della consegna Passo 4 · 90 sec 5. Prima della produzione Passo 5 · non fa parte dei cinque minuti Dalla richiesta alla produzione ## Un unico percorso verso il tuo primo messaggio, con i tempi di ogni fase. 1. 01 Richiedi l'accesso di prova Rispondiamo entro 1 giorno lavorativo Un 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. 2. 02 Primo messaggio di test Circa 5 minuti dopo la ricezione delle credenziali Invia un messaggio di prova al tuo numero verificato con il codice della guida rapida. La ricevuta di consegna (DLR) torna al tuo webhook. 3. 03 Integrazione 2–5 giorni lavorativi Costruire 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. 4. 04 Approvazione 3–10 giorni lavorativi L'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. 5. 05 Produzione Giorno del passaggio in produzione L'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. Diagramma Come un messaggio A2P raggiunge il telefono 1. La tua applicazione Inviato tramite REST API o SMPP 2. Piattaforma BroadNet Valida, instrada e fattura ogni messaggio 3. SMSC dell’operatore Connessione diretta con l'operatore 4. Dispositivo dell'abbonato Il messaggio viene consegnato La ricevuta di consegna (DLR) torna lungo lo stesso percorso verso il tuo webhook In questa pagina 1. 01 Ottieni il tuo token di accesso 2. 02 Installa l'SDK 3. 03 Invia il tuo primo messaggio 4. 04 Ricevi lo stato della consegna 5. 05 Prima della produzione Dopo le credenziali 5 min Circa cinque minuti dall'ottenimento delle credenziali di prova al primo messaggio di prova. Il passaggio relativo al webhook richiede un URL pubblico; ngrok funziona perfettamente. 01 Passo 1 · 30 sec ## 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. your BroadNet account · access token Access token quickstart-default active 84f1a02e3c7d4b91a7e0•••••••••••• copy Header Bearer Env var BROADNET_TOKEN Base URL api.broadnet.me $ curl -X POST https://api.broadnet.me/sms/sendSms -H "Authorization: Bearer $BROADNET_TOKEN" … 200 OK Provalo 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. step 1.broadnet.me 02 Passo 2 · 45 sec ## 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. Install ``` npm install @broadnet/cpaas-sdk axios export BROADNET_TOKEN=your_access_token ``` bash node >= 18 Provalo Importa Configuration e SMSSMSApi da @broadnet/cpaas-sdk. Se l'importazione si risolve e il controllo dei tipi passa, sei pronto per inviare. step 2.broadnet.me 03 Passo 3 · 60 sec ## 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. POST /sms/sendSms ``` // 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 ``` javascript 200 OK · message ID Response · 200 OK body · message ID ``` HTTP/1.1 200 OK 2603121407537573731 ``` Provalo Controlla 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. step 3.broadnet.me 04 Passo 4 · 90 sec ## 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. POST /webhooks/broadnet ``` 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); }); ``` javascript delivery status · JSON DELIVERED Confermato sul telefono. Gli aggiornamenti precedenti, SUBMITTED e SENT, arrivano man mano che il messaggio si sposta attraverso la rete. dopo la consegna READ Aperto dal destinatario, sui canali che segnalano letture, come WhatsApp. alla lettura FAILED / REJECTED Messaggio non consegnato. Verifica il formato del numero e il tuo ID mittente prima di inviare nuovamente. stato finale Provalo Invia un messaggio al tuo telefono, poi controlla il registro del server per l'aggiornamento di stato DELIVERED. step 4.broadnet.me 05 Passo 5 · non fa parte dei cinque minuti ## 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. - 01 Trasferisci 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. - 02 Riprova 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. - 03 Fissa 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. - 04 Gestione 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. - 05 Definisci 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. Provalo 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. step 5.broadnet.me Progettato per la produzione fin dal primo giorno ## 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. ISO 27001 Sicurezza delle informazioni ISO 9001 gestione della qualità ISO 22301 continuità operativa GDPR Allineato · Residenza dei dati nell'UE HIPAA Allineato · BAA su richiesta SOC 2 Tipo II · revisione annuale Residenza dei dati nell'UE e negli Emirati Arabi Uniti SLA di disponibilità API del 99,99% Un unico URL di base per test e produzione Webhook sullo stato della consegna Domande che gli acquirenti pongono ## 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](https://www.broadnet.me/it/contact) Accesso di prova · risposta entro un giorno lavorativo ## 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. [Richiedi l'accesso di prova](https://www.broadnet.me/it/signup) [Riferimento API completo](https://www.broadnet.me/it/developers/api) $ curl -X POST https://api.broadnet.me/sms/sendSms -H "Authorization: Bearer $BROADNET_TOKEN" -d '{ "senderId": "…", "destinationNumber": "…", "message": "…", "messageType": "TEXT" }'