Sommario
- Introduzione
- Panoramica sugli SMS transazionali
- Pagina "I miei SMS transazionali"
- Inviare tramite API SMS
- Pannello di controllo delle statistiche degli SMS
Introduzione
Non vedi l'ora di connetterti con i tuoi clienti ovunque si trovino? Con l'API SMS di Mailjet, puoi inviare messaggi di testo transazionali in oltre 55 paesi in tutto il mondo.
Ecco come funziona:
- Deposita denaro nel tuo account SMS e genera i token di accesso
- Invia messaggi transazionali utilizzando l'API SMS
- Visualizza le statistiche dei messaggi dal pannello di controllo degli SMS
Questa guida si concentra sull'account SMS (generazione di token, prezzi e depositi, pannello di controllo delle statistiche).
Chiedi al tuo team di sviluppo di consultare la nostra Guida di riferimento sull'API SMS che illustra i metodi, la codifica, i codici di errore e le istruzioni su come usare la nostra API RESTful.
Panoramica sugli SMS transazionali
Esaminiamo alcuni punti generali sull'invio di SMS transazionali:
- Un SMS può contenere fino a 160 caratteri (in codifica GSM7) e possono essere inviati fino a cinque SMS concatenati (fino a 765 caratteri) in una sola volta*.
- Il limite di invio predefinito è di 200 SMS al giorno.
- La pagina dell'account SMS è disponibile solo sul tuo account principale (e non è accessibile dai subaccount).
- I messaggi SMS non possono essere inviati ai tuoi elenchi di contatti. Gli SMS possono essere inviati solo alle persone che hanno dato il consenso a ricevere SMS transazionali e hanno fornito un numero di telefono nel modulo di opt-in.
* Risorsa per gli sviluppatori: Sezione su concatenazione e codifica degli SMS
Pagina "I miei SMS transazionali"
Per iniziare, clicca su "SMS" dal menu principale.
Dalla pagina "SMS transazionali" puoi:
- Generare i token di accesso
- Visualizzare il saldo attuale del tuo account prepagato SMS e depositare denaro
- Analizzare le statistiche degli SMS degli ultimi tre mesi
Generare i token di accesso
Prima di poter utilizzare l'API SMS, devi generare un token di accesso che verrà usato per autenticarti.
Per creare un token di accesso, clicca su "Genera un token".
Inserisci un nome univoco per il token e clicca su "Genera".
Una volta generato il token, copia e salva il valore del token. Per motivi di sicurezza, Mailjet non memorizza il valore del token. Una volta chiusa la finestra modale, il valore del token non può essere visualizzato nuovamente.
Puoi generare un massimo di dieci token attivi. Per visualizzare o cancellare i token correnti, clicca su "Gestisci token".
Risorse per sviluppatori: Come effettuare l'autenticazione con i bearer token
Prezzi degli SMS
Il prezzo dell'invio di un SMS transazionale dipende dal paese di destinazione.
Clicca su "Controlla le tariffe" per conoscere il costo dell'invio di un SMS in base al paese. Se desideri inviare a un paese non incluso nell'elenco, apri un ticket di supporto.
Puoi depositare denaro (USD, euro o sterline) nel tuo account SMS in qualsiasi momento. Il deposito minimo è di un dollaro/euro/sterlina e i depositi non sono rimborsabili.
Il costo di ogni SMS inviato verrà automaticamente detratto dal tuo account SMS.
Aggiungere denaro al tuo account SMS
Nota: come previsto dalle normative internazionali, per il primo acquisto di SMS con una nuova carta di credito è necessaria una procedura di convalida, che può richiedere fino a 48 ore. Una volta convalidato il pagamento, la carta di credito verrà addebitata e il denaro verrà depositato nel tuo account SMS.
Dalla pagina "SMS transazionali", clicca su "Aggiungi denaro".
Inserisci l'importo nella valuta desiderata per il deposito. Usa il Calcolatore SMS per stimare il numero di messaggi transazionali che possono essere inviati in un paese specifico. Clicca su "Continua".
Conferma i dati di fatturazione (Passaggio 2) e clicca su "Continua".
In "Metodo di pagamento", seleziona la carta di credito e clicca su "Continua".
Leggi i Termini di servizio e clicca sulla casella di controllo per confermare che solo gli SMS transazionali possono essere inviati ai contatti che hanno esplicitamente acconsentito a ricevere SMS e che la mancata osservanza di tale disposizione può comportare una multa o la cancellazione del servizio.
Come ultimo passaggio, clicca su "Conferma il tuo ordine".
Ricorda che, se si tratta di un primo acquisto di SMS su una nuova carta di credito, la procedura di convalida potrebbe richiedere fino a 48 ore, durante le quali il denaro depositato apparirà come "in attesa" nel tuo account.
Per ogni deposito effettuato sul tuo Account SMS viene generata una fattura, che può essere visualizzata tramite il link "Esamina la cronologia di fatturazione e le fatture".
La valuta del tuo account SMS
La valuta del tuo deposito sarà la valuta del tuo Account SMS. Se depositi dollari, la valuta del tuo Account SMS sarà impostata su USD; se depositi euro, la valuta del tuo Account SMS sarà impostata su EUR. Il deposito minimo è di un'unità (dollaro/euro/sterlina).
Quando la valuta dell'Account SMS viene cambiata con un nuovo deposito, i fondi presenti nell'account non verranno convertiti o trasferiti nella nuova valuta. I fondi diventeranno invece nuovamente accessibili quando riporti la valuta dell'Account SMS a tale valuta con un nuovo deposito (minimo un'unità).
Ad esempio:
Paul effettua un deposito iniziale di 400 dollari e il suo Saldo prepagato SMS mostra 400 dollari. Per ogni SMS transazionale inviato, il costo viene automaticamente detratto dal Saldo prepagato. Dopo un mese di invio, gli rimangono 125 dollari sul conto.
Paul deposita quindi 200 euro. La valuta del suo Saldo prepagato SMS viene impostata su EUR e il saldo è ora di 200 euro. Ogni SMS inviato sarà detratto dai 200 euro.
I 125 dollari saranno inaccessibili finché Paul non riporterà la valuta del conto in USD con un deposito in dollari (deposito minimo di 1 $).
Inviare tramite API SMS
Una volta generati i token di accesso ed effettuato il deposito sull'Account SMS, l'API SMS può essere utilizzata per:
- Inviare volumi elevati di SMS
- Recuperare i dettagli dei messaggi SMS e le statistiche di invio di base
- Esportare un elenco di messaggi SMS
Ecco le guide tecniche e le risorse di cui il tuo Team di sviluppo avrà bisogno per integrare con successo l'API SMS:
- Guida di riferimento sull'API SMS
- API SMS
- Concatenazione e codifica degli SMS
- Codici di stato degli SMS
- Codici di errore
Pannello di controllo delle statistiche degli SMS
Visualizza le prestazioni degli SMS negli ultimi tre mesi e lo stato di ogni SMS inviato:
- Recapitato: l'SMS è stato recapitato al dispositivo del destinatario.
- In attesa di recapito: l'SMS è stato inviato.
- Respinto: l'SMS non è stato recapitato (mittente in elenco di blocco, numero di destinazione non valido o inattivo, destinatario abbonato a un servizio "Non disturbare", messaggio rifiutato dall'operatore, ecc.) Se è stato fornito un motivo di errore, questo verrà visualizzato nella colonna "Dettagli di stato".