FAQ
Domande e risposte sull'API Bulk SMS
39 risposte su account, invio, prezzi, report di consegna e l'API, verificate rispetto ai limiti nel codice. Per endpoint e campi, il Riferimento API contiene i dettagli.
Il servizio
Cos'è BulkSMSAPI?
Un'API SMS di massa per sviluppatori: invia un testo o un batch di fino a 10.000 numeri per richiesta a 227 paesi tramite REST, segui ogni messaggio con webhook firmati e paga per messaggio da un saldo prepagato. Una console web invia campagne da un elenco incollato o CSV senza codice.
Chi usa un'API SMS di massa?
Team di prodotto e ingegneria che inviano messaggi dai propri sistemi: codici di accesso e registrazione, aggiornamenti su ordini e consegne, promemoria per appuntamenti, avvisi di pagamento, notifiche di servizio e campagne di marketing. Chiunque possa fare una richiesta HTTPS può usarlo.
A quali paesi posso inviare?
227 paesi e territori, elencati con i loro prezzi nella pagina dei prezzi e nelle pagine dei paesi. Una richiesta può mescolare paesi: ogni numero è prezzato in base al paese a cui appartiene.
C'è una tariffa mensile o un contratto?
No. Paghi per segmento di messaggio da un saldo prepagato e non ci sono tariffe mensili, costi di setup o volumi minimi. Il saldo non ha una data di scadenza.
C'è una prova gratuita?
Gli account iniziano con un saldo zero e la prima ricarica apre tutto. La prima ricarica aggiunge un bonus fino al 40%, quindi i primi messaggi costano meno. I prezzi sono pubblici e l'endpoint di stima e la console mostrano il costo esatto prima che venga inviato qualsiasi messaggio.
Account e chiavi API
Come creo un account?
Apri Ottieni chiave API. Il tuo browser crea una chiave account che inizia con acct_; copiala o salvala come file di testo, conferma di averla salvata e l'account è pronto. La chiave account è l'unico accesso: non ci sono email o password da gestire.
Cosa succede se perdo la mia chiave account?
Memorizziamo solo un hash crittografato, quindi nessuno può mostrarla di nuovo, incluso il nostro team di supporto. Conservala in un gestore di password. Finché sei ancora connesso, la console continua a funzionare e puoi contattare il supporto da lì.
Come ottengo una chiave API?
Nella pagina delle chiavi API della console, dopo che il primo ricarico è stato accreditato. Assegna un nome alla chiave, creala e copiala una volta: inizia con bsa_live_. Un account può contenere 10 chiavi attive, ciascuna con il proprio nome e contatore del limite di richiesta.
Posso usare chiavi diverse per produzione e staging?
Sì. Crea una chiave per app o ambiente e assegnale un nome. Ogni chiave mostra quando è stata utilizzata l'ultima volta e revocandone una le altre continuano a funzionare.
Quanti account posso creare?
Fino a 3 account per indirizzo di rete. La maggior parte dei team ha bisogno di un account con diverse chiavi API.
Invio di messaggi
Quanti numeri può gestire una richiesta?
POST /v1/batches gestisce fino a 10.000 numeri per richiesta, sia un testo unico per tutti che un testo personalizzato per numero. La console gestisce 50.000 numeri per campagna. Le liste più grandi vengono suddivise in più richieste.
Quanto velocemente vengono inviati i messaggi?
La coda viene eseguita ogni due secondi e consegna fino a 1.200 messaggi al minuto per account alla rete, nell'ordine in cui sono stati accettati. Un singolo messaggio di solito parte entro pochi secondi dalla richiesta.
In che formato devono essere i numeri di telefono?
Internazionale E.164: un segno più, il prefisso internazionale e il numero nazionale, come +14155550123. Spazi, trattini, parentesi e un prefisso 00 vengono puliti automaticamente; i duplicati e i numeri che non possono essere letti vengono messi da parte e non addebitati.
Quanto può essere lungo un messaggio?
Fino a 10 segmenti: 1.530 caratteri in GSM-7 o 670 in Unicode. Un segmento contiene 160 caratteri GSM-7 o 70 caratteri Unicode; i testi più lunghi vengono suddivisi in parti di 153 o 67 caratteri e riuniti nuovamente sul telefono.
Perché il mio messaggio ha utilizzato più segmenti del previsto?
Un carattere al di fuori dell'alfabeto GSM-7, come una virgoletta riccia, un'emoji o una lettera come á o ç, trasforma l'intero testo in Unicode a 70 caratteri per segmento. Il compositore della console identifica quei caratteri e POST /v1/estimates restituisce la codifica prima dell'invio.
Posso programmare i messaggi?
Sì. Aggiungi send_at a una richiesta API o scegli un orario nella console, da 2 minuti a 45 giorni in anticipo. Un batch programmato può essere annullato fino all'inizio e il suo costo completo viene restituito al saldo.
Ogni destinatario può ricevere un testo diverso?
Sì. Tramite l'API, invia un batch con messaggi, uno {to, text} per destinatario. Nella console, incolla o carica una lista con colonne aggiuntive e usa i campi di unione {{1}} a {{9}} nel testo.
Una riga di rinuncia viene aggiunta ai miei messaggi?
Imposta la tua frase di rinuncia una volta nelle Impostazioni, ad esempio un link o un indirizzo email, e la console la aggiunge ai testi della campagna quando spunti la casella. Tramite l'API controlli l'intero testo, quindi aggiungi tu stesso la riga ai messaggi di marketing. I numeri nella tua lista di non invio vengono saltati dalla console e dall'API e non vengono addebitati.
Posso inviare prima un messaggio di prova?
Sì. La console ha un invio di prova a un numero prima di una campagna e tramite l'API puoi inviare un singolo messaggio al tuo telefono con POST /v1/messages.
Prezzi e pagamenti
Quanto costa un SMS?
Dipende dal paese del numero: ogni paese ha un prezzo per segmento in dollari USA, da $0.00247 (Brasile). La pagina dei prezzi e GET /v1/pricing elencano ogni paese.
Come viene calcolato il costo di un batch?
Per ogni destinatario: il prezzo per segmento del suo paese moltiplicato per i segmenti del suo testo. La somma viene prelevata dal saldo quando la richiesta viene accettata e la risposta la mostra nel costo.
Qual è il minimo per la ricarica?
$40. Puoi ricaricare qualsiasi importo da $40 a $5.000. La prima ricarica include un bonus fino al 40%, mostrato su ogni importo prima del pagamento.
Come posso pagare?
Nella console, la sezione Fatturazione apre un checkout in una finestra sovrapposta. Scegli l'importo e paga in criptovaluta: la pagina di pagamento mostra l'importo esatto e l'indirizzo. La pagina dei pagamenti elenca ogni passaggio.
I messaggi falliti vengono rimborsati?
Sì. Se un messaggio fallisce, il suo costo torna automaticamente sul saldo come voce di rimborso nel registro. Un invio programmato annullato viene rimborsato per intero.
Posso prelevare il saldo?
Il saldo serve per pagare i messaggi e rimane nel tuo account senza scadenza. Anche i rimborsi per messaggi falliti o annullati tornano sul saldo.
I prezzi cambiano?
I prezzi possono cambiare con i costi di rete. L'elenco corrente è datato, l'API restituisce la data con ogni prezzo, e i messaggi già accettati mantengono il prezzo applicato.
Consegna e report
Come so se un messaggio è stato consegnato?
Ogni messaggio passa da in coda a inviato a consegnato o fallito. Aggiungi un URL webhook nella console per ricevere un evento firmato per ogni stato finale, o leggi GET /v1/messages/{id} e GET /v1/batches/{id}.
Come sono firmati i webhook?
Nel formato Standard Webhooks: intestazioni webhook-id, webhook-timestamp e webhook-signature, dove la firma è HMAC-SHA256 di id, timestamp e corpo grezzo con il tuo segreto whsec_. La documentazione include codice di verifica per Node.js, Python, PHP e Go.
E se il mio endpoint webhook non funziona?
Ogni evento ha 10 tentativi in circa 24 ore, e ogni tentativo è elencato nella console con il suo stato HTTP. Puoi anche interrogare gli endpoint dei messaggi in qualsiasi momento.
Perché un messaggio potrebbe fallire?
Il telefono potrebbe essere spento troppo a lungo, il numero non è più attivo o la rete rifiuta il messaggio. Lo stato failed include un codice di errore e il costo viene rimborsato.
Per quanto tempo sono conservati i messaggi?
Invii, messaggi e il registro del saldo rimangono nel tuo account e nell'API. Il log delle richieste conserva le ultime 500 chiamate API e il log webhook le ultime 500 consegne.
Per sviluppatori
C'è un SDK?
L'API è JSON semplice su HTTPS, quindi basta la libreria standard di qualsiasi linguaggio. La documentazione include esempi completi in curl, Node.js, Python, PHP e Go, e la specifica OpenAPI in /openapi.json genera un client tipato per molti linguaggi.
Quali sono i limiti di richiesta?
600 richieste al minuto per chiave API. Ogni risposta include le intestazioni X-RateLimit-Limit, X-RateLimit-Remaining e X-RateLimit-Reset, e una risposta 429 include Retry-After.
Come ripetere una richiesta in sicurezza dopo un timeout?
Invia richieste POST con un'intestazione Idempotency-Key e ripeti con la stessa chiave. Per 24 ore, la stessa chiave e corpo restituiscono la prima risposta invece di inviare di nuovo.
Posso controllare i prezzi senza una chiave API?
Sì. GET /v1/pricing e GET /v1/pricing/{country} sono pubblici, quindi una pagina di checkout o dashboard può mostrare i prezzi in tempo reale.
Dove posso vedere cosa ha inviato il mio codice?
La console ha un registro delle richieste con il metodo, il percorso, lo stato e l'ora delle ultime 500 chiamate API, accanto a batch, messaggi e il registro dei webhook.
La console
Posso inviare senza scrivere codice?
Sì. Nella console, incolla i numeri o carica un file CSV con fino a 50.000 righe, scrivi il testo con i campi di unione, controlla l'anteprima per ogni destinatario e il costo per paese, e invia ora o a un orario impostato.
Cosa mostra la console?
Saldo, batch recenti con conteggi in tempo reale, ogni batch con i suoi messaggi e stati, ricariche e registro, chiavi API, impostazioni e consegne dei webhook, registro delle richieste, listino prezzi, ticket di supporto e impostazioni.
Come posso contattare il supporto?
Dalla pagina di Supporto della console. Le domande sui pagamenti possono essere poste dal primo giorno; gli altri argomenti si aprono dopo che la prima ricarica viene accreditata.
Hai ancora una domanda?
Gli account connessi possono aprire un ticket di supporto dalla console. Le domande sui pagamenti possono essere poste dal primo giorno.