# 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**](https://bird.com/dashboard/w/sms/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](/docs/guides/sms/sending-sms#sender). ## 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](/docs/guides/sms/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](/docs/guides/numbers/number-types) spiega come viene scelto il tipo del numero, e [Acquistare e rilasciare un numero](/docs/guides/numbers/buying-numbers) 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](/products/sms/destinations) 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**](https://bird.com/dashboard/w/sms/senders), apri **Add sender** e scegli **Add sender ID**, poi inserisci la stringa. Via API: ```cli 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**](https://bird.com/dashboard/w/trust), 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é: ```cli 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](#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**](https://bird.com/dashboard/w/sms/destinations); [Invio di SMS](/docs/guides/sms/sending-sms#before-you-send-enable-the-destination-country) 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: ```cli 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**](https://bird.com/dashboard/w/trust) 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](#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](/docs/guides/numbers/overview#the-status-of-an-allocated-number) 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**](https://bird.com/dashboard/w/sms/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](#verificare-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](#registrare-un-sender-per-un-paese), più il modulo richiesto dal paese | | `numeric` | un long code | [Registrare un sender per un paese](#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](/docs/guides/sms/10dlc) | | `tfn` | un numero toll-free statunitense | Verifica toll-free, nella pagina [**Toll-free verifications**](https://bird.com/dashboard/w/sms/tfn-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](/products/sms/numbers), oppure rivedi la [registrazione dei sender](/products/sms/compliance/sender-id-registration) per il tuo rollout. | Pagina | Cosa copre | | ----------------------------------------------------------- | ---------------------------------------------------------------------------------- | | [Invio di SMS](/docs/guides/sms/sending-sms) | La chiamata di invio, i formati `from` accettati e la allowlist delle destinazioni | | [Registrazione 10DLC](/docs/guides/sms/10dlc) | Il modello brand, campagna e numero alla base dell'invio A2P negli Stati Uniti | | [Tipi di numero](/docs/guides/numbers/number-types) | Scegliere tra numeri mobile, locali, nazionali, toll-free e short code | | [Destinazioni SMS](/products/sms/destinations) | Quali tipi di sender ogni paese accetta e quali richiedono registrazione | | [Opt-out e keyword](/docs/guides/sms/opt-outs-and-keywords) | Le risposte keyword che un sender deve rispettare e le soppressioni che generano | ## Related resources - [Registering your SMS sender ID](/learn/sms/registering-your-sms-sender-id) (video) - [What is sender ID registration, and why do some countries require it?](/explained/sms/what-is-sender-id-registration) (answer) - [SMS sender IDs](/sms-api/features/compliance/sender-id-registration) (product) - [Build your first integration](/learn/paths/integration) (course) [Get an implementation brief](/learn/workspace?topic=sms-senders)