FAQ API SMS

Installa l'SDK e invia al destinatario di test autorizzato +15005550006 in circa cinque minuti. Puoi configurare un check CI prima ancora di attivare un numero.

Un unico endpoint di invio, messaggistica bidirezionale in entrata, provisioning dei numeri (numeri lunghi, numeri brevi, toll-free e sender ID alfanumerici), compliance A2P 10DLC e opt-out, instradamento diretto verso l'operatore e analisi delle consegne, tutto in un'unica API.

Bird raggiunge oltre 150 paesi attraverso più di 240 connessioni dirette con gli operatori, con riselezione delle rotte di livello carrier quando un percorso si degrada.

Per inviare traffico application-to-person a numeri statunitensi, sì. La registrazione del brand e della campagna si gestisce dalla dashboard e lo stato è interrogabile tramite API.

Per messaggio, a una tariffa che dipende dal Paese di destinazione e dal tipo di mittente utilizzato, quindi un long code statunitense e un mittente alfanumerico britannico hanno tariffe separate. Le tariffe sono pubblicate per Paese nella pagina dei prezzi SMS.

Sì, la fatturazione è per segmento anziché per messaggio. Un segmento contiene 160 caratteri GSM-7, oppure 70 quando un singolo emoji o carattere non latino forza l'intero messaggio in Unicode. I testi più lunghi vengono suddivisi e ogni segmento viene fatturato, quindi un singolo carattere fuori standard può raddoppiare il costo di una grande campagna.

I costi dell'operatore si applicano per messaggio e variano in base alla destinazione e all'operatore. Negli Stati Uniti, il 10DLC prevede anche costi di registrazione del brand e della campagna. Entrambi sono elencati nella pagina dei costi operatore SMS.

Il log SMS mostra il conteggio dei segmenti e il costo di ogni singolo messaggio una volta tariffato; le metriche SMS aggregano il volume accettato, i segmenti e la spesa nel tempo.

Un messaggio GSM-7 contiene 160 caratteri per segmento; passando a Unicode (UCS-2) per emoji o alfabeti non latini il limite scende a 70. I messaggi più lunghi vengono concatenati su più segmenti e l'SDK indica il conteggio prima dell'invio.

Dodici segmenti, ovvero circa 1.836 caratteri GSM-7 o 804 Unicode. Bird non tronca mai: un corpo che supera il limite restituisce un errore 422. Il limite conta i segmenti anziché i caratteri proprio perché le due codifiche contengono quantità diverse.

Fino a 100 in una chiamata batch, ciascuno con il proprio destinatario e testo. Un singolo messaggio va a un solo destinatario, quindi il batch è il modo per distribuire l'invio.

Una chiave del piano gratuito consente 10 invii singoli e 5 chiamate batch al minuto; i piani a pagamento aumentano entrambi i limiti. Ogni risposta include un header IETF RateLimit che indica quanto resta e quando la finestra si resetta, così puoi regolarti su quello anziché su un numero hardcoded.

È stabilito dagli operatori, non da Bird. Un numero lungo 10DLC registrato ottiene un throughput basato sul punteggio di fiducia del brand e sul tipo di campagna: superiore a un numero non registrato, inferiore a uno short code. Gli short code ottengono la velocità più alta e prevedibile.

Per il traffico applicativo negli Stati Uniti, un long code 10DLC copre la maggior parte dei casi d'uso bidirezionali e OTP. I programmi uno-a-molti ad alto volume passano a uno short code; il numero toll-free è un'opzione per Stati Uniti/Canada senza 10DLC.

Un long code o un numero toll-free è disponibile immediatamente e inizia a inviare una volta completata la registrazione o la verifica. Gli short code vengono verificati dagli operatori e richiedono generalmente alcune settimane.

Sì. Long code, short code e numeri toll-free sono bidirezionali: indirizzate il traffico in entrata di un numero verso un webhook e le risposte arrivano come eventi firmati. Gli ID mittente alfanumerici sono solo unidirezionali.

Dipende dal tipo di mittente e dal Paese. Il traffico applicativo negli Stati Uniti richiede A2P 10DLC, i numeri toll-free richiedono la verifica, e molti Paesi richiedono la pre-registrazione dell'ID mittente: tutto gestibile dalla dashboard.

È una breve stringa di testo, di solito il nome del tuo brand, che appare nel campo "mittente" del destinatario al posto di un numero di telefono. È un'etichetta sul messaggio, non un numero di tua proprietà.

Mantienila breve: in genere fino a 11 caratteri sulle reti GSM. Il limite esatto dipende dal paese di destinazione e dall'operatore, e da ciò che ciascuno accetta.

Un numero toll-free è un numero 8xx (800, 888, 877 e gli altri prefissi toll-free) che invia e riceve SMS negli Stati Uniti e in Canada. Gestisce traffico applicativo senza A2P 10DLC, una volta superata la verifica toll-free.

No. I numeri toll-free sono al di fuori del sistema A2P 10DLC. Passano invece attraverso la verifica toll-free, in cui gli operatori esaminano il caso d'uso e il contenuto dei messaggi prima che il numero sia autorizzato a inviare a pieno volume.

Un numero lungo a 10 cifre (10DLC) è un numero telefonico locale standard autorizzato per SMS application-to-person negli Stati Uniti, una volta registrati il brand e la campagna presso gli operatori.

I numeri lunghi 10DLC registrati ottengono un throughput verificato che dipende dal punteggio di fiducia del brand e dal tipo di campagna: superiore a un numero non registrato, inferiore a uno short code.

Uno short code è un numero di 5–6 cifre approvato dagli operatori per SMS ad alto volume uno-a-molti: campagne di marketing, avvisi e OTP ad alta frequenza. È il tipo di mittente con il throughput più elevato e richiede la verifica dell'operatore prima di poter inviare.

Pianifica in settimane, non in minuti. Gli operatori verificano ogni programma short code prima dell'attivazione, quindi uno short code ha tempi di attesa reali, a differenza di un long code, che puoi acquistare e usare per inviare non appena la registrazione viene approvata.

Uno short code dedicato è esclusivamente tuo, quindi la sua reputazione di invio è interamente la tua. Uno short code condiviso suddivide un numero tra più mittenti tramite keyword: più economico, più rapido da avviare, ma erediti la reputazione di tutti gli altri che lo utilizzano.

Lo scegli tu, in un invio a testo libero: passa un numero di proprietà del tuo workspace, uno short code o un ID mittente alfanumerico, se il Paese di destinazione lo consente. Se lo ometti, l'invio viene rifiutato anziché indovinato. L'invio tramite template è l'eccezione, perché seleziona automaticamente il proprio mittente.

Indica a Bird e agli operatori il motivo dell'invio, e le regole di conformità per Paese — come la politica di opt-out e le fasce orarie di silenzio — si basano su di essa. È obbligatoria in un invio a testo libero; un invio tramite template eredita la classificazione del template stesso.

Passa una chiave di idempotenza e una richiesta ripetuta restituirà il risultato originale invece di inviare due volte. Senza chiave, un nuovo tentativo viene trattato come un nuovo messaggio.

Ogni cambio di stato genera un webhook firmato con HMAC (in coda, inviato, consegnato o fallito), contenente la ricevuta di consegna dell'operatore e il conteggio dei segmenti.

Ogni messaggio inviato al tuo numero provisionato arriva come webhook sms.received firmato con HMAC. Verifichi una firma, leggi from, to e text, e lo instradi nella tua logica — lo stesso formato che già gestisci per le ricevute di consegna.

Sì. Rispondi inviando dallo stesso numero su cui è arrivato il messaggio. Imposta from sul tuo numero e to sul mittente originale, e il thread resta su un unico numero dall'inizio alla fine.

Bird adds the sender to your suppression list and fires sms_suppression.created, and blocks later sends from that sender to that number automatically. HELP returns a help reply and START opts them back in, all handled before they reach your code, so you stay compliant without writing the keyword logic yourself.

Ti serve un numero abilitato alla comunicazione bidirezionale. I numeri lunghi, i codici brevi e i numeri verdi supportano la ricezione; gli ID mittente alfanumerici sono solo in uscita e non possono ricevere risposte.

Il messaggio viene consegnato direttamente all'operatore mobile attraverso una delle nostre 240 connessioni dirette, senza passare per una catena di rivenditori. Meno passaggi significa meno punti in cui un messaggio può bloccarsi o una conferma di consegna può andare persa.

Bird riseleziona la rotta in tempo reale. Se un percorso inizia a perdere conferme di ricezione o a rallentare, il messaggio successivo utilizza una connessione più affidabile verso lo stesso operatore, senza alcuna modifica al codice di invio.

Ogni messaggio restituisce una conferma di consegna dall'operatore come webhook sms.delivered o sms.failed, con mcc_mnc, country e latency_ms. Si tratta della conferma diretta dell'operatore, non di una deduzione da parte nostra.

Sì. Eseguiamo una ricerca MNP a ogni invio per identificare l'operatore attuale del destinatario, così un numero portato viene instradato verso l'operatore che lo gestisce effettivamente. Per l'intelligence sui numeri in modo autonomo, consultate Lookup.

L'instradamento bilancia costo e qualità di consegna per destinazione. Il traffico transazionale come i codici OTP privilegia il percorso a qualità massima; il traffico bulk può orientarsi verso il costo minimo. La selezione avviene per messaggio, dietro la stessa chiamata API.

Dalla ricevuta di consegna dell'operatore (DLR) per ogni invio. Bird registra la ricevuta associata al messaggio, quindi aggrega tali ricevute in dati di consegna, errori e latenza. Il conteggio dei messaggi consegnati è la conferma di ricezione dell'operatore, non una stima di Bird.

Yes, from its own endpoint. The stats API has one breakdown per dimension (carrier, country, originator, category, status, error code, tag) plus daily and hourly series, and each row carries the one dimension you asked for. Crossing two of them, such as a carrier inside a country, means two calls and joining the rows yourself. A failure rate that looks fine nationally often turns out to be one carrier rejecting one sender ID.

Entrambi. Ogni stato di consegna arriva già come webhook, quindi puoi costruire il tuo archivio dal flusso di eventi. L'API delle statistiche è disponibile quando preferisci che sia Bird a fare l'aggregazione, anziché gestire un contatore in autonomia.

Passa l'ID del messaggio all'endpoint degli eventi e ottieni la sua cronologia completa: in coda, inviato, consegnato o fallito, ciascuno con un timestamp e, in caso di errore, il codice motivo dell'operatore. È il report di cui hai davvero bisogno quando un cliente dice che un SMS non è mai arrivato.

Sì. L'opt-out è reversibile. Un destinatario che invia START viene rimosso dalla lista di soppressione e può ricevere nuovamente messaggi. La scelta resta al destinatario.

La lista di soppressione è una risorsa API interrogabile. Controlla un numero prima di creare un'audience, così un destinatario che ha effettuato l'opt-out non rientra mai in un invio.

Dipende da dove invii e cosa invii. Il traffico applicativo negli Stati Uniti richiede la registrazione del brand e della campagna A2P 10DLC. Molti paesi richiedono la pre-registrazione del sender ID per i mittenti alfanumerici. La gestione dell'opt-out si applica ovunque e non richiede configurazione.

Bird invia ogni registrazione agli operatori o ai registri e ne riporta lo stato tramite l'API. Il tuo codice può interrogare lo stato della registrazione e attendere l'approvazione, anziché inviare in una campagna non ancora attiva.

No. Utilizza lo stesso client e le stesse chiavi dell'invio, dei numeri e della messaggistica bidirezionale. Lo stato della registrazione e la lista di soppressione sono risorse API accanto alla chiamata di invio, quindi un'unica integrazione copre sia l'invio che le regole associate.

Per contrastare lo spoofing, molti Paesi consegnano solo gli ID mittente alfanumerici che sono stati pre-registrati presso gli operatori locali o l'autorità di regolamentazione. Dove si applica questa regola, un mittente brandizzato non registrato viene rifiutato o riscritto.

Bird. Tu invii l'ID mittente e la destinazione dalla dashboard, Bird lo trasmette al registro locale e l'API ne riporta lo stato, così sai quando il mittente è attivo.

L'approvazione passa attraverso operatori e registri esterni e varia in base al Paese, in genere da giorni a settimane. Controlla lo stato della registrazione tramite l'API e attendi la conferma prima di inviare da quell'ID mittente.

A2P 10DLC è il framework degli operatori statunitensi per gli SMS application-to-person inviati tramite long code standard a 10 cifre. Un'azienda registra il brand dietro il proprio traffico e una campagna che descrive i messaggi, e gli operatori verificano entrambi prima di concedere il throughput.

Il brand è l'entità legale che invia il traffico. Una campagna descrive un caso d'uso specifico di messaggistica sotto quel brand. Un brand può avere più campagne, e i numeri vengono associati a una campagna anziché al brand.

La verifica di brand e campagna passa attraverso gli operatori e il registro e richiede in genere da giorni a settimane. Interroga lo stato della campagna tramite l'API, così il tuo codice attende l'approvazione prima di inviare.

No. 10DLC è un framework statunitense. Altri Paesi hanno le proprie regole, molti richiedono la pre-registrazione dell'ID mittente, e la gestione delle keyword di opt-out si applica ovunque tu invii.

La vostra chiamata a Bird lo è, tramite HTTPS, così come il webhook in entrata che vi inviamo. L'ultimo tratto non è sotto il nostro controllo: l'SMS è un protocollo dell'operatore senza crittografia end-to-end, e il messaggio è leggibile sul dispositivo e dall'operatore. Per questo è meglio non inserire dati sensibili nel corpo del messaggio e preferire WhatsApp o l'email per qualsiasi contenuto riservato.

Ogni evento è firmato con HMAC. Verificate la firma con il secret del vostro endpoint prima di elaborare il payload, e ruotate il secret dalla dashboard quando necessario.

Nella regione in cui è ospitata la vostra organizzazione, us1 o eu1. La vostra API key riporta la regione nel prefisso (bk_us1_…, bk_eu1_…), ed è così che gli SDK e la CLI selezionano automaticamente l'endpoint corretto senza configurazioni aggiuntive.

Solo ciò per cui la configurate. Una key contiene un elenco di scope, ciascuno in lettura o scrittura, quindi una key che invia SMS non può gestire i vostri numeri né leggere un altro canale. Le azioni di control-plane come la gestione dei membri e l'emissione di key sono riservate alla dashboard e nessuna key può accedervi.

Entrambe le cose. Una key accetta una allowlist di intervalli CIDR e rifiuta le richieste da qualsiasi altro indirizzo; la rotazione mantiene la vecchia key funzionante per un periodo di grazia (24 ore per impostazione predefinita, oppure zero per disattivarla immediatamente), così il passaggio non richiede downtime.

Sì. L'audit log è un registro di sola lettura a livello di organizzazione di ogni azione di gestione, con l'autore, il workspace, l'orario e l'esito, ed è esportabile in formato OCSF per il vostro SIEM.

Le certificazioni e la documentazione sulla sicurezza sono disponibili nel Trust Center su trust.bird.com. Il contratto di trattamento dati, l'informativa sulla privacy e la policy di utilizzo accettabile sono pubblicati su bird.com/legal. Per un questionario fornitore, il vostro team Bird di riferimento se ne occupa.