Sender ID SMS

Un sender è il from che il destinatario vede sul tuo SMS. Il tuo spazio di lavoro contiene un sender per ogni identità da cui può inviare, e ogni paese di destinazione decide quali tipi di sender accetta e cosa vuole registrato prima. Possedere un sender non equivale a essere autorizzati a inviare da esso: sono due passaggi separati, e questa guida li copre entrambi.

I sender si trovano nella pagina Senders, una riga per sender, con il suo stato e quante destinazioni sono attive, in attesa o richiedono la tua attenzione. La chiamata di invio, incluso il modo in cui un valore from viene validato, è in Invio di SMS.

Tipi di sender

Il sender_type di un sender è il tipo di identità che rappresenta, e determina cosa ogni paese richiede:

Sender ID alfanumerico: una breve stringa di brand come BIRD, da 3 a 11 lettere ASCII, cifre, spazi, trattini, underscore o punti, con almeno una lettera. Spazi, trattini, underscore e punti non possono essere il primo o l’ultimo carattere. I destinatari vedono il tuo nome al posto di un numero e non possono rispondere. Molti paesi richiedono la registrazione prima di consentire il traffico, e alcuni, inclusi gli Stati Uniti, non lo accettano affatto. Questo tipo lo rivendichi tu stesso.
Long code: un numero ordinario che possiedi, in grado di inviare e ricevere. Un long code statunitense richiede un brand e una campagna registrati prima di trasportare traffico application-to-person; vedi Registrazione 10DLC.
Numero toll-free: un numero il cui costo è a carico del destinatario della chiamata, che in Nord America può anche trasportare messaggi. Inviare da uno di questi richiede prima il completamento della verifica toll-free.
Short code: un numero nazionale breve per un programma di messaggistica approvato, con lunghezza e throughput determinati dal mercato e dal programma dell'operatore. Bird assegna gli short code anziché venderli, quindi questo tipo non è self-service.

Un sender riporta anche source_kind, che indica cosa lo supporta: alpha per una stringa sender che hai rivendicato, number per un numero dedicato che possiedi e shared_number per un numero gestito da Bird da cui il tuo spazio di lavoro invia. La dashboard li etichetta come Alphanumeric, Dedicated number e Shared number. Tipi di numero spiega come viene scelto il tipo del numero, e Acquistare e rilasciare un numero spiega come allocarne uno.

Quali tipi un paese accetta, e se li esamina, cambia man mano che operatori e autorità di regolamentazione aggiornano le proprie regole. Destinazioni SMS pubblica la situazione corrente per paese; consultala lì anziché supporre che un paese si comporti come i suoi vicini.

Rivendicare un sender ID alfanumerico

Rivendicare una stringa sender è gratuito e ha effetto immediato. Nella pagina Senders, apri Add sender e scegli Add sender ID, poi inserisci la stringa. Via API:

Esempio di codice

bird sms senders create --type alpha --sender BIRD

La risposta contiene l'id del nuovo sender, con prefisso snd_, e ogni altra operazione in questa guida usa quell'id. Un claim riuscito può inviare dove la registrazione è assente o facoltativa, una volta abilitate le destinazioni. La registrazione obbligatoria deve essere approvata prima.

Due rifiuti possono verificarsi qui. Un 412 significa che la tua organizzazione non ha completato la verifica d'identità richiesta da questa operazione: completala in Identity Center, poi riprova. Un 409 significa che la stringa sender è già stata rivendicata.

alpha è l'unico tipo creato da questa chiamata. Un numero dedicato diventa un sender quando lo allochi dall'inventario, quindi l'acquisto del numero porta con sé il suo sender. Short code e numeri condivisi raggiungono uno spazio di lavoro tramite allocazione da Bird anziché tramite acquisto.

Verificare cosa richiede un paese

Una singola lettura risponde a ciò che ogni paese richiede a un sender. Restituisce una riga per paese raggiungibile dal sender, e ogni riga è completa di per sé:

Esempio di codice

bird sms senders requirements snd_01krdgeqcxet5s7t44vh8rt9mg
bird sms senders requirements snd_01krdgeqcxet5s7t44vh8rt9mg --country-code NL

Ometti --country-code per ottenere ogni paese rilevante per il sender. Un risultato filtrato vuoto significa che il sender non ha alcuna rotta verso quel paese.

Leggi sei campi su una riga prima di inviare:

registration_mode è none, optional o required. none non richiede registrazione per il paese. Quando è abbinato a un sender ID overwritten, la registrazione non è disponibile. Le registrazioni esplicite più vecchie possono ancora essere registrate per le policy none con comportamento unknown o preserved, ma non bloccano mai l'invio. optional consente al sender di continuare a inviare mentre lo registri. required blocca l'invio fino all'approvazione.
program identifica il flusso di registrazione quando il paese ne indica uno, ad esempio alpha o numeric. Può essere null quando non si applica alcun programma specifico.
sender_id_behavior è unknown, preserved o overwritten. È indipendente da registration_mode: una registrazione obbligatoria può comunque sovrascrivere il sender ID dopo l'approvazione. La registrazione facoltativa riporta overwritten prima dell'approvazione e preserved dopo l'approvazione per le categorie di messaggi approvate.
status indica a che punto è il sender rispetto al programma di registrazione del paese. In modalità required, l'invio attende approved. In modalità optional, lo stato tiene traccia del lavoro di registrazione ma non blocca l'invio. Stati di registrazione elenca ogni valore.
destination_enabled indica se il tuo spazio di lavoro ha quel paese attivato. È un'impostazione dello spazio di lavoro, non del sender, e viene verificata per prima: una registrazione completamente approvata rifiuta comunque i messaggi se la destinazione è disattivata. Attiva i paesi in Destinations; Invio di SMS copre l'allowlist.
next elenca ciò che fa avanzare quel paese, in ordine. Una lista vuota significa che non c'è nulla in sospeso. Ogni voce indica un'azione e spiega perché vale la pena eseguirla: un paese in fase di revisione da parte dell'operatore indica la risorsa da consultare anziché ripetere un verdetto che appartiene a quella risorsa.

Le righe riportano anche timeline_min_days e timeline_max_days, il tempo minimo e massimo che l'approvazione di un paese richiede di solito in giorni lavorativi, e null dove il paese non pubblica una stima. Dove una registrazione è stata rifiutata, rejection_reason ne indica il motivo.

Le stesse informazioni si trovano nella pagina di dettaglio di ogni sender nella dashboard, come tabella Destinations con le colonne Status, Country e Category. Un paese che non hai attivato e per cui non ti sei registrato è escluso da quella tabella, perché lì non c'è nulla in sospeso.

Registrare un sender per un paese

La registrazione è per paese, e la chiamata prende il sender e il paese insieme:

Esempio di codice

bird sms senders registrations create snd_01krdgeqcxet5s7t44vh8rt9mg --country-code NL
bird sms senders registrations create snd_01krdgeqcxet5s7t44vh8rt9mg --country-code NL --category marketing

--category limita la registrazione a uno tra transactional, marketing, authentication o service. Omettilo per registrare ogni categoria. La dashboard esegue la stessa chiamata dal pulsante Register nella riga del paese del sender.

Cosa succede dopo dipende dal paese. Dove il paese esamina le registrazioni, il record torna pending e nulla viene addebitato. Dove il paese non esamina nulla, la registrazione è approvata con questa chiamata. Registrare un numero è gratuito; un sender alfanumerico a pagamento prevede una tariffa di attivazione e un addebito mensile ricorrente, fatturati al momento dell'approvazione della registrazione, quindi una registrazione soggetta a esame viene creata senza addebito. Né questa chiamata né la lettura dei requisiti indicano un prezzo, quindi chiedi al responsabile dell'account quanto costa una registrazione prima di effettuarla.

Dove un programma raccoglie le tue risposte tramite un modulo, la registrazione resta a pending finché non lo compili. La riga del paese del sender offre quindi Complete, che apre le domande che il programma pone sulla tua attività e sulla tua messaggistica.

Quattro rifiuti da gestire:

Risposta	Significato
402	Il wallet non ha potuto coprire l'importo dovuto al momento della fatturazione. Ricaricalo e riprova.
409	Una registrazione per questo paese esiste già in uno stato diverso da rifiutata o sospesa, inclusa una ancora pending revisione. Lo stato da solo non determina se il mittente può inviare: controlla registration_mode, destination_enabled e se la registrazione copre la categoria del messaggio.
412	La tua organizzazione ha un requisito di verifica dell'identità non soddisfatto. Completalo in Identity Center e riprova.
422	Il mittente è coperto da un programma con un proprio percorso, come US 10DLC, verifica toll-free o short code. Consulta Programmi con un proprio percorso.

Una registrazione rifiutata viene reinviata e una sospesa viene riattivata chiamando di nuovo questa stessa operazione, anziché con un'operazione separata.

Stati di registrazione

La registrazione di un paese attraversa gli stati seguenti. La dashboard mostra ciascuno come etichetta nella riga del sender:

Stato	Significato e cosa fare
registration_required	Il registration_mode del paese è required e nessuna registrazione è iniziata. Registra il sender per il paese.
pending	Il lavoro di registrazione è iniziato. Se il programma richiede un modulo, completalo da Complete sulla riga del paese.
under_review	Le informazioni inviate sono in fase di revisione oppure necessitano di modifiche. Il campo program_ref della riga punta alla risorsa del programma, l'unico posto in cui una revisione ancora in corso è distinguibile da una in attesa di te.
bird_approved	La revisione di Bird è superata e l'approvazione dell'operatore è in sospeso. Non è richiesta alcuna azione da parte tua.
carrier_pending	Inviato all'operatore o al registro responsabile dell'approvazione. Non è richiesta alcuna azione da parte tua.
approved	Registrazione approvata.
rejected	La registrazione è stata rifiutata. Leggi rejection_reason, correggi e registra di nuovo da Resubmit.
suspended	Una registrazione precedentemente attiva è sospesa. Registra di nuovo da Register again per riattivarla.
not_required	Nessuna registrazione attiva blocca l'invio. Controlla registration_mode e sender_id_behavior: none non richiede registrazione per il paese e la rende non disponibile quando il sender ID è sovrascritto; optional offre la registrazione senza bloccare il traffico.

Nuovi stati vengono aggiunti man mano che i programmi di registrazione cambiano, quindi tratta un valore sconosciuto come uno che il tuo codice non gestisce ancora anziché come un errore, e leggi il campo next della riga per sapere cosa fare riguardo al paese.

Alcuni programmi aprono diversi paesi con una sola registrazione, quindi una singola verifica toll-free o registrazione di campagna può essere ciò che abilita più destinazioni.

Stato del sender e azioni successive

Lo status di un sender copre ciò che il sender possiede, che è una domanda diversa dal fatto che un determinato paese accetti un messaggio:

active: nulla di ciò che questo sender possiede è in sospeso. Un sender che non si è registrato da nessuna parte risulta active, anche dove ogni paese raggiungibile richiede una registrazione.
pending_number_ownership: la documentazione che prova la proprietà del numero di questo sender non è in ordine, perché non è stata fornita o perché il paese che ha emesso il numero non l'ha ancora accettata. Ogni invio da questo sender viene rifiutato fino alla risoluzione. Panoramica numeri copre quel ciclo di vita.
pending_registrations: il sender possiede registrazioni per paesi e nessuna è ancora approvata. Questo include una registrazione in fase di esame e una rifiutata, quindi leggi next per sapere quale caso si applica.

Accanto a esso, destinations raggruppa i paesi per cui il sender è configurato in base a chi deve agire, e la lista Senders mostra i tre gruppi come colonne:

"Active": paesi verso cui puoi inviare oggi, attivati nelle impostazioni di destinazione e che non richiedono una registrazione obbligatoria oppure ne hanno una approvata. Una registrazione facoltativa può ancora essere in sospeso mentre l'invio resta disponibile con il sender ID sovrascritto.
"Pending": paesi la cui registrazione è in corso e in attesa di Bird o di un operatore. Non è richiesta alcuna azione da parte tua; passano ad "Active" dopo l'approvazione.
"Needs attention": paesi per cui ti sei registrato che non funzionano e sono in attesa di te, perché la registrazione è stata rifiutata o ritirata, oppure perché è approvata ma la destinazione è disattivata.

Questi tre gruppi coprono solo i paesi per cui possiedi una registrazione, quindi un paese per cui potresti registrarti ma non l'hai fatto non compare in nessuno di essi. Per tutto ciò che il sender può raggiungere e cosa ogni paese richiederebbe, leggi cosa richiede un paese.

Una lettura del sender che calcola le azioni successive le restituisce in next, lo stesso campo di routing che le righe dei requisiti riportano. Un sender conosce solo sé stesso, quindi dove il lavoro è per paese indica la lettura dei requisiti anziché indovinare quale paese intendevi.

Programmi con un proprio percorso

Il program di un paese indica lo schema di registrazione che applica a un tipo di sender. Due di essi trovano risposta nella chiamata di registrazione di questa guida, e tre hanno un proprio percorso:

Programma	A cosa si applica	Dove avviene
alpha	un sender ID alfanumerico	Registrare un sender per un paese, più il modulo richiesto dal paese
numeric	un long code	Registrare un sender per un paese, più il modulo richiesto dal paese
10dlc	un long code statunitense	Registrare un brand e una campaign, poi collegare il numero: Registrazione 10DLC
tfn	un numero toll-free statunitense	Verifica toll-free, nella pagina Toll-free verifications
short_code	uno short code	Bird gestisce la richiesta; non è richiesto nulla da parte tua, a meno che non venga rifiutata: in quel caso il next della riga ti indirizza al supporto

La chiamata all'operazione di registrazione per un sender coperto da 10dlc, tfn o short_code restituisce 422. Usa invece il programma dedicato.

La verifica toll-free inizia come una bozza che compili in uno o più aggiornamenti, poi invii per l'esame dell'operatore. Passa attraverso draft, submitted, under_review, info_requested, approved e rejected. Una verifica a info_requested può essere modificata e reinviata; una rifiutata può essere reinviata finché la finestra di reinvio è aperta. L'invio consegna il dossier all'operatore per l'esame, quindi una persona autorizza quel passaggio: CLI e il server MCP di Bird possono creare la bozza e correggere una verifica, e l'invio stesso avviene nella dashboard.

Smettere di inviare da un sender

Tre operazioni di rimozione si distinguono per ciò che conservano, e tutte e tre sono azioni nella dashboard sulla pagina di dettaglio del sender. Le tariffe di attivazione già addebitate non vengono rimborsate da nessuna di esse:

Azione	Cosa fa
Deregister un paese	Annulla l'addebito ricorrente e mantiene la registrazione. Registrare di nuovo quel paese riprende la stessa registrazione senza pagare la tariffa di attivazione una seconda volta. Dove il paese richiede una registrazione, gli invii cessano; dove la registrazione è opzionale, gli invii continuano, perché la registrazione non li condizionava.
Remove una registrazione	Rimuove completamente la registrazione del paese, annulla l'addebito ricorrente e smette di elencare la destinazione per il sender. Registrare di nuovo il paese è una nuova registrazione e paga di nuovo la tariffa di attivazione.
Eliminare il sender	Rilascia un sender alfanumerico. Tutte le registrazioni per paese su di esso vengono rimosse, il suo addebito ricorrente viene annullato e smette di essere utilizzabile. Rivendicare la stessa stringa in seguito crea un nuovo sender con nuove registrazioni e paga le tariffe di attivazione una seconda volta.

Un sender supportato da un numero non viene eliminato qui: rilascia invece il numero dedicato, che elimina con sé il suo sender. Un sender su un numero condiviso gestito da Bird non può essere rimosso.

Una riga 10DLC o toll-free viene annullata attraverso il proprio programma, scollegando la campagna o annullando la verifica, anziché tramite deregistrazione.

Passi successivi

Confronta numeri e sender ID SMS, oppure rivedi la registrazione dei sender per il tuo rollout.

Pagina	Cosa copre
Invio di SMS	La chiamata di invio, i formati from accettati e la allowlist delle destinazioni
Registrazione 10DLC	Il modello brand, campagna e numero alla base dell'invio A2P negli Stati Uniti
Tipi di numero	Scegliere tra numeri mobile, locali, nazionali, toll-free e short code
Destinazioni SMS	Quali tipi di sender ogni paese accetta e quali richiedono registrazione
Opt-out e keyword	Le risposte keyword che un sender deve rispettare e le soppressioni che generano

Risorse correlate

Prosegui con la documentazione, le guide e gli esempi per questo argomento. Le risorse sono in inglese.

Guarda la guidaRegistering your SMS sender ID Comprendi il concettoWhat is sender ID registration, and why do some countries require it?Esplora la funzionalitàSMS sender IDs Segui il percorso di apprendimentoBuild your first integration

Ottieni un brief di implementazione