SMS

Short code, long code, toll-free o alfanumerico: quale tipo di mittente SMS dovrei usare?

Scegli un tipo di mittente supportato dalla destinazione, poi usa un numero quando i destinatari devono poter rispondere.

Un mittente che funziona in una destinazione può non essere ammesso in un'altra. Il supporto alle risposte dipende anche dal singolo numero e dalla sua rotta.

Quali sono i quattro tipi di mittente?

Bird supporta long code, short code, numeri toll-free e sender ID alfanumerici. I relativi valori API sono long_code, short_code, toll_free e alphanumeric.

La policy del paese può ammettere i numeri toll-free e rifiutare i long code. Anche i requisiti di registrazione possono differire:

The toll_free value is distinct from long_code. A country can permit one and refuse the other, and the two usually demand different registration.

  • Long code. Un normale numero di telefono usato per la messaggistica. Invio e ricezione dipendono dalle sue capability SMS e dal supporto della destinazione.
  • Toll-free. Un numero con capability SMS in una fascia toll-free supportata, con propri requisiti di verifica e instradamento.
  • Short code. Un'identità numerica breve usata per programmi di messaggistica. Lunghezza, disponibilità, velocità di invio e registrazione variano in base al mercato.
  • Alfanumerico. Un nome visualizzato come mittente, con un limite di 11 caratteri. Un nome di brand più lungo richiede un'identità di invio più corta. I destinatari non possono indirizzargli una risposta.

Quali tipi di mittente possono ricevere una risposta?

Long code, numeri toll-free e short code idonei possono supportare le risposte. Verifica le capability SMS del numero e la rotta della destinazione, perché la forma del numero non garantisce il supporto alle risposte.

Se il tuo programma ha bisogno di messaggi in entrata, scegli un numero che supporti le risposte, perché i destinatari non possono rispondere a un nome alfanumerico. Questo requisito vale anche quando un iscritto deve inviare una parola chiave di stop al mittente.

La policy del paese riporta il supporto alle risposte come direction con valore one_way o two_way per ogni tipo di mittente. Con un numero e una rotta supportati, i messaggi SMS in entrata possono raggiungere la tua applicazione.

Come scelgo senza conoscere le regole di ogni paese?

Consulta le policy pubblicate per i tipi di mittente della destinazione, poi verifica i requisiti del mittente che intendi usare. Un paese pubblica voci di policy per i tipi di mittente che riporta. Un tipo assente non è supportato. Un tipo presente ha comunque un proprio stato di disponibilità.

Ogni voce di policy riporta questi campi:

  • status, uno tra available, restricted, coming_soon o unavailable.
  • registration_mode, uno tra none, optional o required, e il program che gestisce la registrazione quando prevista.
  • sender_id_behavior: preserved mantiene il sender ID inviato, overwritten lo sostituisce prima della consegna e unknown indica che il comportamento non è confermato. Questo è indipendente dalla modalità di registrazione: una registrazione obbligatoria può comunque sovrascrivere il sender ID dopo l'approvazione. La registrazione facoltativa mantiene il sender ID approvato e lo sovrascrive prima dell'approvazione.
  • registration_timeline_min e registration_timeline_max, in giorni lavorativi, quando il paese pubblica una stima.
  • throughput_mps, la velocità di invio massima pubblicata in messaggi al secondo per quel tipo di mittente e destinazione. Ad esempio, un valore di 30 indica un tetto di 30 messaggi al secondo. Un valore null non fornisce alcuna velocità pubblicata. Verifica la capacità disponibile di account, mittente e operatore perché possono limitare ulteriormente la velocità di invio effettiva.
  • direction, unidirezionale o bidirezionale.
  • allowed_source_countries, i paesi da cui il mittente può originare. Un elenco vuoto non impone alcuna restrizione sul paese di origine.

Puoi confrontare le policy pubblicate dei paesi in destinazioni SMS. Consulta separatamente i requisiti del tuo mittente, perché la policy del paese non stabilisce lo stato di registrazione di quel mittente:

bird sms senders requirements <sender-id> --country-code NL

Una lista allowed_source_countries non vuota limita l'idoneità ai mittenti provenienti da quei paesi. Un mittente da un altro paese non ha rotta in base a quella policy. La registrazione non può rendere idonea quella provenienza.

Cosa decide quale mittente Bird usa effettivamente?

Per un invio API a testo libero, indica il mittente idoneo in from. API non sceglie un pool di mittenti quando ometti questo campo. Un invio con template di sistema seleziona il mittente dal template. Il valore from restituito identifica il mittente usato per quel messaggio.

La priorità di instradamento della policy del paese non seleziona il mittente per una richiesta a testo libero. È la tua applicazione a fornirlo.

Registrazione e accesso alla destinazione sono separati. Un mittente registrato può comunque essere bloccato quando lo spazio di lavoro non ha abilitato la destinazione, con E12020.

Cosa dovrei fare concretamente?

  1. Scegli un tipo di mittente supportato dalla destinazione, incluse eventuali restrizioni sul paese di origine.
  2. Scegli un numero supportato quando le risposte sono necessarie, incluse le parole chiave di stop in entrata.
  3. Prevedi la registrazione obbligatoria e l'eventuale registrazione facoltativa che scegli, usando la tempistica pubblicata per pianificare il rilascio.
  4. Confronta il limite massimo di invio pubblicato con il tuo traffico di picco, poi verifica la capacità di account, mittente e operatore.
  5. Conferma la registrazione del mittente e l'accesso alla destinazione dello spazio di lavoro prima di inviare.

In breve

  1. Bird distingue quattro tipi di mittente.

    API elenca long_code, short_code, alphanumeric e toll_free. Una destinazione può ammettere un tipo e rifiutarne un altro.

  2. Le risposte richiedono un numero e una rotta supportati.

    Un mittente alfanumerico è solo in invio. Un numero ha bisogno della capability SMS e di una rotta in entrata supportata per ricevere risposte.

  3. La policy del paese definisce i tipi di mittente ammessi.

    La policy della destinazione riporta la disponibilità dei tipi di mittente e gli eventuali paesi di origine consentiti. La registrazione non crea una rotta mancante.

  4. Registrazione e capacità dipendono dal tipo di mittente e dalla destinazione.

    I tempi di registrazione pubblicati sono stime. La velocità massima di invio è espressa in messaggi al secondo.

Mettilo in pratica.

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

Costruisci sulla stessa rete.

Una chiave API di test è subito tua. L'accesso alla produzione si sblocca quando aggiungi un metodo di pagamento e verifichi un mittente.

La tua prossima idea.
Pronta a partire.