Sign inGet Started

Registrazione 10DLC

Gli operatori statunitensi consegnano i messaggi di testo aziendali da un numero locale (un long code a 10 cifre, o 10DLC) solo dopo che l'azienda e il suo caso d'uso sono registrati presso The Campaign Registry (TCR). Tu compili la registrazione nella dashboard di Bird, e noi la inviamo a TCR e ne seguiamo l'esito. Per iniziare, apri SMS > 10DLC.

Che cos'è la registrazione A2P 10DLC? spiega perché esiste il programma. Per registrarti da un terminale o tramite un agente, consulta Registrarsi dalla CLI o tramite un agente.

Come funziona la registrazione

Registri tre elementi, in questo ordine:

ElementoCosa descriveChi lo esaminaModifiche dopo l'approvazione
BrandLa tua azienda: ragione sociale, codice fiscale, indirizzo e sito webTCR, confrontandolo con i registri pubbliciAlcuni campi; consulta Modificare un brand o una campagna registrati
CampagnaUn tipo di messaggio che invii, ad esempio notifiche sull'account, e il modo in cui le persone danno l'opt-inTCR e gli operatoriNessuna. Crea invece una nuova campagna.
NumeroUn long code statunitense da cui invii, collegato a una campagnaGli operatori confermano ogni numero collegatoScollegalo e collegalo a un'altra campagna

Un brand può avere più campagne. Puoi collegare un numero mentre la sua campagna è ancora in attesa, ma il numero non può inviare messaggi a destinatari statunitensi finché la campagna non viene approvata e gli operatori non confermano il numero.

Quanto costa la registrazione

La finestra di pagamento mostra l'importo esatto prima che tu confermi ogni addebito. I prezzi in vigore sono indicati in Tariffe 10DLC.

AddebitoQuando lo paghi
Tariffa di registrazione del brandOgni volta che invii un brand, incluso ogni reinvio
Tariffa di vetting della campagnaOgni volta che invii una campagna, incluso ogni reinvio. Non viene rimborsata se la campagna viene rifiutata.
Abbonamento della campagnaIl prezzo è indicato su base mensile. La fatturazione inizia quando invii la campagna, prima dell'approvazione, e prosegue finché non la elimini.
Tariffa di vetting del brandUna volta per ogni ordine di vetting, con prezzo in base al tipo di vetting

Collegare un numero a una campagna e modificare un brand approvato è gratuito.

Prima di iniziare

Verifica la tua identità

Prima di poter registrare o reinviare un brand, la tua organizzazione deve completare la verifica dell'identità in Identity Center. Si tratta del nostro controllo su chi sei, e avviene prima che TCR esamini il brand.

Finché la verifica non è completata, Register brand e Resubmit aprono Verify your identity first al posto del modulo, con i passaggi ancora da completare. Se compare Your organization is under review o Not available for your organization, contatta il supporto.

Accedi con un indirizzo e-mail sul dominio del tuo sito web

Il Contact email del brand è l'indirizzo con cui accedi a Bird, e il modulo non ti permette di modificarlo. Quell'indirizzo deve trovarsi sul dominio principale del tuo sito web:

Sito webE-mail di accessoAccettato
acme.comyou@acme.comSì
shop.acme.comyou@acme.comSì, acme.com è il dominio principale
acme.comyou@mail.acme.comNo, l'indirizzo è su un sottodominio
acme.comyou@gmail.comNo, i provider e-mail gratuiti non sono accettati

Se il tuo indirizzo di accesso non corrisponde, può registrare il brand al tuo posto un collega che accede con un indirizzo sul dominio del tuo sito web.

Raccogli i dati della tua azienda

TCR confronta la ragione sociale e il codice fiscale con i registri pubblici. Una discrepanza è il motivo più comune per cui un brand viene rifiutato, quindi copia entrambi esattamente dai tuoi documenti ufficiali. Per un'azienda statunitense, si tratta della lettera CP 575 o 147C dell'IRS.

Ogni brand richiede questi dati:

CampoCosa inserire
Legal company nameIl nome riportato nei documenti fiscali, esattamente come vi è scritto
Codice fiscalePer un'azienda statunitense, l'Employer Identification Number (EIN) di nove cifre, ad esempio 12-3456789. Per un'azienda canadese, le prime nove cifre del Business Number (BN9).
Tax ID countryIl paese che ha rilasciato il codice fiscale
IndirizzoVia, città, codice postale, stato o regione e paese della sede legale. Un indirizzo statunitense richiede un codice dello stato di due lettere e un codice ZIP. I territori degli Stati Uniti non possono essere registrati.
Brand nameIl nome con cui ti conoscono i clienti
WebsiteUn sito web attivo, che inizia con http:// o https:// e descrive l'attività della tua azienda
VerticalIl tuo settore
Support phoneUn numero di telefono che destinatari e operatori possono chiamare per contattarti

Un'azienda quotata in borsa deve indicare anche Stock symbol, Stock exchange e un Business contact email. Deve inoltre superare il vetting Auth+ prima di poter creare una campagna; consulta Richiedere il vetting.

Puoi anche inserire un Alternative business ID (optional): un numero DUNS, un GIIN o un LEI.

Puoi registrare un'azienda privata, un'azienda quotata in borsa, un'organizzazione non-profit o un ente governativo. Non è possibile registrare brand di ditte individuali.

Registra il tuo brand

  1. Apri SMS > 10DLC e scegli Register brand.

    La pagina 10DLC nella dashboard di Bird con la scheda Brands selezionata, che mostra un brand Goldcrest approvato e un pulsante Register brand.

  2. In What kind of organization are you?, scegli Private company, Public company, Non-profit o Government.

  3. In Your organization, inserisci la ragione sociale, il codice fiscale, il paese del codice fiscale e l'indirizzo esattamente come compaiono nei tuoi documenti fiscali. Per un'azienda quotata in borsa, inserisci anche i dati azionari e l'e-mail di contatto aziendale, e attiva Request Auth+ vetting automatically. In questo modo ordiniamo l'Auth+ non appena TCR approva il brand.

    Il passaggio Your organization del modulo del brand, compilato con una ragione sociale, un EIN, Stati Uniti come paese del codice fiscale e un indirizzo di San Francisco.

  4. In Your public presence, inserisci il nome del brand, il sito web e il settore.

  5. In Contact, inserisci il telefono dell'assistenza. L'e-mail di contatto è già compilata con il tuo indirizzo di accesso.

  6. In Review registration, controlla le risposte e gli eventuali problemi elencati dal controllo automatico, poi scegli Register brand.

  7. Conferma la tariffa di registrazione del brand nella finestra di pagamento.

Il brand compare nella scheda Brands come Pending.

Stati del brand

StatoSignificatoCosa fare
PendingTCR sta esaminando il brandAttendi il risultato. Non puoi creare una campagna con un brand in attesa.
ApprovedTCR ha verificato il brandCrea una campagna. Un'azienda quotata in borsa deve prima avere un vetting Auth+ attivo.
RejectedTCR non è riuscito a verificare il brandApri il brand per leggere il motivo, poi reinvialo. Consulta Correggere un brand o una campagna rifiutati.

Creare una campagna

Una campagna indica agli operatori cosa contiene un tipo di traffico e come le persone che lo ricevono hanno acconsentito a riceverlo. Prima ti serve un brand approvato.

  1. In SMS > 10DLC, apri la scheda Campaigns e scegli Create campaign.

  2. In What are you messaging about?, scegli il brand e il caso d'uso. Non potrai modificare il caso d'uso in seguito; consulta Scegliere un caso d'uso.

    Il passaggio del caso d'uso nel modulo della campagna, con il brand Goldcrest selezionato e Customer Care scelto come caso d'uso.

  3. In Campaign details, inserisci un nome, una descrizione e il flusso dei messaggi, scegli dove i destinatari danno l'opt-in e aggiungi dei messaggi di esempio. Se i destinatari danno l'opt-in in un punto che i revisori non possono aprire, allega uno screenshot o una foto che mostri come danno l'opt-in.

  4. In What's in your messages?, seleziona ogni opzione pertinente: link, numeri di telefono, contenuti con limiti di età o prestiti diretti.

  5. In Opt-in, opt-out and help, inserisci le parole chiave e la risposta che le persone ricevono quando danno l'opt-in, quando inviano STOP o quando inviano HELP.

    Il passaggio di opt-in, opt-out e assistenza nel modulo della campagna, con tutte e tre le caselle selezionate, START come parola chiave di opt-in e un messaggio di risposta all'opt-in.

  6. In Review campaign, attendi che il controllo automatico termini. Ogni errore o avviso elencato descrive il problema e Fix ti porta al campo. Poi scegli Create campaign.

  7. Conferma la tariffa di vetting della campagna e l'abbonamento della campagna nella finestra di pagamento.

Se al momento dell'invio sono ancora elencati errori, la dashboard ti chiede di confermare con Submit anyway. Ogni invio viene addebitato, quindi correggi prima gli errori.

La campagna compare nella scheda Campaigns come Pending.

Scegliere un caso d'uso

Il caso d'uso indica agli operatori che tipo di messaggi invia la campagna, ad esempio Two Factor Authentication, Account Notification, Customer Care o Marketing. Scegli quello che corrisponde ai messaggi che invii davvero. Non puoi modificarlo dopo aver creato la campagna, quindi se i tuoi messaggi cambiano, crea una nuova campagna.

Alcuni casi d'uso hanno requisiti aggiuntivi:

  • Mixed e Low Volume richiedono da due a cinque casi d'uso secondari.
  • Political richiede un brand non-profit.
  • M2M (machine-to-machine) non richiede il supporto di opt-in, opt-out o assistenza.

Scrivere una campagna che gli operatori approvano

Gli operatori rifiutano le campagne vaghe o che non corrispondono ai messaggi che invii. Per aumentare le probabilità di approvazione di una campagna:

  • Scrivi una descrizione e un flusso dei messaggi di almeno 40 caratteri ciascuno. Il flusso dei messaggi indica dove e come le persone acconsentono a ricevere i tuoi messaggi, ad esempio tramite una casella di controllo nel modulo di iscrizione.
  • Aggiungi da uno a cinque messaggi di esempio simili a quelli reali, ciascuno lungo da 20 a 1.024 caratteri. K12 Education, Marketing, Mixed, Agents Franchises, Charity, Political, Proxy e Sweepstake ne richiedono almeno due.
  • Supporta opt-in, opt-out e assistenza, con una risposta per ciascuno. Le parole chiave di opt-out devono includere STOP e quelle di assistenza devono includere HELP.
  • Non usare nei messaggi servizi pubblici di abbreviazione dei link come bit.ly. Gli operatori non li consentono.
  • Se le persone danno l'opt-in in un punto che i revisori non possono aprire, ad esempio in un'app, dietro un login, di persona, per telefono o via SMS, allega uno screenshot o una foto che mostri come danno l'opt-in. Per un opt-in su una pagina web pubblica gli allegati sono facoltativi, ma puoi aggiungere uno screenshot del modulo o un PDF dei tuoi termini. Puoi allegare fino a cinque file PNG, JPEG o PDF di massimo 10 MB ciascuno.

Stati della campagna

StatoSignificatoCosa fare
PendingTCR e gli operatori stanno esaminando la campagnaCollega i tuoi numeri subito. Iniziano a inviare dopo l'approvazione.
ApprovedLa campagna può trasportare trafficoCollega i numeri che non hai ancora collegato.
RejectedLa campagna non ha superato la revisioneApri la campagna per leggerne il motivo, poi reinviala. Consulta Correggere un brand o una campagna rifiutati.
ExpiredLa registrazione della campagna è scaduta e i suoi numeri hanno smesso di inviareCrea una nuova campagna e collega i numeri a quella. Una campagna scaduta non può essere reinviata.
SuspendedUn operatore ha sospeso la campagna e i suoi numeri hanno smesso di inviareI numeri riprendono a inviare se la campagna viene ripristinata. Una campagna sospesa non può essere reinviata.

Collega i tuoi numeri

Collega a una campagna ogni long code statunitense da cui invii. La campagna può essere Pending o Approved.

  1. Apri SMS > Senders e seleziona il numero.
  2. Nella sezione 10DLC registration, scegli Link to campaign.
  3. Scegli la campagna, poi scegli Link.

La finestra Link to a 10DLC campaign su un numero statunitense, con la campagna Account support selezionata e un pulsante Link.

Un numero appartiene a una sola campagna alla volta, e una campagna può contenere fino a 49 numeri. I collegamenti in attesa e non riusciti contano nel limite di 49 finché non li scolleghi, quindi per collegare altri numeri crea una seconda campagna.

La tabella SMS senders della campagna mostra lo stato di ogni collegamento:

StatoSignificato
PendingIn attesa dell'approvazione della campagna o della conferma degli operatori. Il numero non può ancora inviare a destinatari statunitensi e Senders lo mostra come Carrier pending.
ActiveGli operatori hanno confermato il numero. Il numero può inviare a destinatari statunitensi con questa campagna.
FailedGli operatori non hanno accettato il numero per questa campagna. Scollegalo e riprova, oppure collegalo a un'altra campagna.
UnlinkedIl numero è stato rimosso dalla campagna e può essere collegato a un'altra.

Per scollegare un numero, scegli Unlink nella sua sezione 10DLC registration e conferma con Yes, unlink. Il numero smette subito di inviare ai destinatari statunitensi.

Prima di inviare, attiva anche gli Stati Uniti come paese di destinazione. Consulta Invio di SMS.

Richiedere il vetting

Il vetting è una revisione aggiuntiva di un brand approvato, svolta da un fornitore terzo. Sono disponibili due tipi di vetting:

  • Auth+ è obbligatorio per un'azienda quotata in borsa prima che possa creare qualsiasi campagna. Il fornitore scrive all'e-mail di contatto aziendale indicata nel brand, e il vetting resta in attesa finché quella persona non conferma. Di solito richiede alcuni giorni lavorativi.
  • Standard restituisce un punteggio che può aumentare il tuo throughput presso gli operatori, cioè il volume di messaggi che gli operatori accettano da te.

Per ordinare un vetting:

  1. Apri un brand approvato e scegli Request vetting.
  2. Scegli il Vetting type, poi scegli Continue.
  3. Conferma la tariffa di vetting nella finestra di pagamento.

Ogni ordine compare nel brand come scheda a sé, ad esempio Standard vetting, con una cronologia e uno Score. Un vetting che termina come Failed o Expired richiede un nuovo ordine.

Se durante la registrazione hai attivato Request Auth+ vetting automatically, l'ordine Auth+ compare non appena TCR approva il brand. La relativa tariffa viene addebitata quando effettuiamo l'ordine.

Correggere un brand o una campagna rifiutati

Apri il brand o la campagna rifiutati per vedere perché TCR li ha rifiutati. Ogni motivo elenca i campi interessati.

  1. Correggi i campi indicati dai motivi. Se un motivo riguarda la ragione sociale o il codice fiscale, confrontali carattere per carattere con i tuoi documenti fiscali.
  2. Scegli Resubmit. Il modulo si apre con le risposte precedenti già compilate.
  3. Invia il modulo e conferma la tariffa. Ogni reinvio viene addebitato come un nuovo invio.

Quando reinvii una campagna, non puoi cambiarne il brand, il caso d'uso, i sotto-casi d'uso o le impostazioni di opt-in, opt-out e assistenza. Per cambiare uno di questi elementi, crea una nuova campagna.

Se TCR rifiuta un brand la cui ragione sociale, il cui codice fiscale e il cui tipo di entità corrispondono già ai tuoi documenti ufficiali, contatta il supporto di Bird prima di pagare per reinviare gli stessi dati. Indica l'ID del brand e il motivo del rifiuto. Tieni pronta la lettera CP 575 o 147C dell'IRS e attendi che il supporto ti dica se e come inviarla.

Modificare un brand o una campagna registrati

Per aggiornare un brand approvato, aprilo, scegli Edit details, apporta le modifiche e scegli Save changes. L'aggiornamento di un brand è gratuito. Il brand resta Approved mentre TCR esamina l'aggiornamento, quindi le sue campagne continuano a inviare. Non puoi avviare un altro aggiornamento finché TCR non ha finito di esaminare quello in corso. Se TCR accetta l'aggiornamento ma non riesce più a verificare il brand, il brand passa a Rejected.

La pagina di modifica elenca in Locked after approval i campi che non puoi cambiare: tipo di entità, ragione sociale, codice fiscale, paese del codice fiscale e, per un'azienda quotata in borsa, simbolo azionario, borsa di riferimento ed e-mail di verifica aziendale. Per cambiare uno di questi dati, registra un nuovo brand.

Non puoi modificare una campagna dopo averla creata. Per cambiare ciò che una campagna dichiara, crea una nuova campagna. Un numero appartiene a una sola campagna alla volta e smette di inviare ai destinatari statunitensi non appena lo scolleghi, quindi attendi che la nuova campagna sia Approved prima di spostarvi i numeri.

Registrarsi dalla CLI o tramite un agente

I comandi bird sms 10dlc della Bird CLI e gli strumenti sms_10dlc_* corrispondenti sul server MCP registrano gli stessi brand, campagne e collegamenti dei numeri della dashboard. Per il 10DLC non esiste un'operazione REST API pubblica.

Comandi

  1. Leggi cosa richiede la registrazione: bird sms 10dlc brands requirements <business-entity-type> per un brand o bird sms 10dlc campaigns requirements <use-case-category> per una campagna.
  2. Registra il brand con bird sms 10dlc brands create. Il comando invia il brand a TCR e addebita la tariffa di registrazione del brand.
  3. Crea la campagna con bird sms 10dlc campaigns create. Il comando invia la campagna e addebita la tariffa di vetting della campagna e il primo addebito dell'abbonamento della campagna.
  4. Collega i numeri con bird sms 10dlc campaigns numbers assign <campaign-id>.

Per stampare una richiesta di creazione senza inviarla, aggiungi --dry-run.

Accedi con una credenziale OAuth

I comandi che registrano, reinviano o ordinano il vetting richiedono un accesso OAuth che includa l'ambito sms_management:write. Per questi comandi la CLI non accetta una chiave API.

  • La credenziale salvata da bird auth create-org include questo ambito. Dopo una registrazione da terminale, non eseguire bird auth login per il 10DLC: un nuovo login sostituisce la credenziale della registrazione con una che include solo gli ambiti richiesti dal login.
  • Un bird auth login esistente o un client MCP connesso funziona quando la sua autorizzazione include l'ambito.
  • Rimuovi BIRD_API_KEY prima di eseguire questi comandi. Se contiene una chiave API, la CLI usa la chiave al posto del tuo accesso e il comando non riesce.

Conferma ogni registrazione in un browser

Prima che la inviamo e la addebitiamo, una persona conferma in un browser ogni registrazione di brand, reinvio di brand, ordine di vetting, creazione di campagna e reinvio di campagna:

  • La CLI stampa un link di revisione e attende la conferma della persona.
  • Tramite MCP, il server chiede al client di aprire il link di revisione per la persona, oppure restituisce subito un risultato in sospeso con il link di revisione e un confirmation_id. Il risultato è disponibile dopo la conferma della persona.

Controlli degli agenti elenca gli altri limiti su ciò che un agente può fare e spendere: chiavi con ambito limitato, l'elenco dei paesi SMS bloccati per impostazione predefinita, i limiti di spesa SMS giornalieri e il portafoglio prepagato.

Passaggi successivi

Continua con la documentazione, le guide e gli esempi per questo argomento.