Tutto sugli utenti SMS

Vedi come Markdown

Scopri come creare, configurare e gestire gli utenti API per l'invio di SMS, incluse le autorizzazioni e le restrizioni

Obiettivo

Questa guida ti spiega come creare e gestire gli utenti API.

Prerequisiti

Disporre di un account SMS OVHcloud.

Accesso allo Spazio Cliente OVHcloud

Link diretto: SMS
Per accedere ai tuoi servizi: Telecom > SMS > Seleziona il tuo account SMS

Procedura

Un utente SMS API può essere utile per diverse ragioni:

Consente al proprietario dell'account SMS di rendere sicuri i propri accessi durante l'invio di SMS tramite un'API esterna. Infatti, lo script che effettua la chiamata conosce solo l'identificativo dell'utente e la sua password, e non la sessione dell'identificativo cliente del proprietario.
La creazione di più utenti API può essere utile in un'azienda, in particolare per una migliore tracciabilità. Un utente API che invia SMS in modo abusivo può essere immediatamente individuato dal proprietario dell'account.
Un utente API può essere soggetto a restrizioni (quote) sui suoi crediti SMS. In questo modo, il proprietario dell'account SMS può ripartire i propri crediti tra i diversi account utente API.

Per gestire al meglio il credito del tuo account SMS, puoi fissare un limite e una quota ai tuoi utenti API.

La quota è la quantità di crediti SMS a disposizione dell'utente API.
Il limite corrisponde alla soglia minima di crediti SMS che un utente API deve avere prima di ricevere un alert per ricaricare o meno il saldo di questi crediti.

Passaggio 1: Creare un utente API

Clicca sulla scheda Utenti API. Per aggiungere un utente, clicca sul pulsante Azioni, poi su Aggiungi.

La scelta del nome dell'utente API è libera. La password di un utente API deve essere composta da 8 caratteri alfanumerici.

Passaggio 2: Attribuire una quota a un utente API

La gestione della quota si effettua dalla scheda Utenti API. In corrispondenza dell'utente scelto, clicca sui ..., poi su Quota.

Potrai quindi effettuare due operazioni.

Attivare la quota?: ti permette di stabilire se questo utente è soggetto a una quota.
Nuova quota: imposta la quota dell'utente. Una volta raggiunta questa quota, l'invio di SMS verrà bloccato per questo utente.

Info

L'assegnazione di una quota a un utente API ridurrà di pari importo il credito totale dell'account SMS.

Esempio: un account SMS dispone di un totale di 200 crediti. L'assegnazione di 150 crediti a un utente API andrà a sottrarre 150 crediti dall'account SMS, che disporrà quindi di soli 50 crediti.

Passaggio 3: Attribuire un limite a un utente API

La configurazione di un limite per un utente si effettua dallo stesso menu, cliccando sui ..., poi su Limite.

Saranno quindi disponibili le seguenti impostazioni:

Attivare l'alert?: permette di attivare l'alert di limite.
Soglia di alert: imposta il livello di crediti SMS rimanenti a partire dal quale viene inviata la notifica.
Notifica: permette di scegliere il tipo di notifica: e-mail (inserisci quindi il tuo indirizzo e-mail), SMS (inserisci il tuo numero nel formato internazionale) o entrambi.

Warning

L'invio di una notifica via SMS sarà detratto dal tuo credito SMS.

Passaggio 4: Definire una restrizione per IP per la funzione http2sms

Puoi rendere sicura la funzione http2sms applicando restrizioni per IP per ciascun utente API.

Per attivarla, clicca sui ... a destra dell'utente, poi su Restrizioni.

Puoi inserire fino a 5 diversi indirizzi IP pubblici per l'invio delle tue richieste https.

Per maggiori informazioni sulla funzione http2sms, consulta la guida Inviare SMS da un URL.

Passaggio 5: Specificare un URL di Callback

Per un monitoraggio personalizzato degli avvisi di ricezione SMS (Delivery reporting o DLR), puoi specificare un URL detto di Callback cliccando sui ... a destra dell'utente, poi su Callback.

Quando lo stato di invio dell'SMS viene aggiornato, chiamiamo l'URL specificato. I seguenti valori vengono automaticamente inseriti nella querystring:

id: numero di identificazione dell'SMS
ptt: codice che corrisponde a uno stato dell'SMS. I diversi codici ptt sono descritti nella prima tabella qui di seguito.
date: data del DLR
description: ID del DLR. I diversi ID sono descritti nella seconda tabella qui di seguito
descriptionDlr: descrizione dello stato del DLR

I codici ptt

Per ottenere la descrizione di un codice ptt specifico, puoi utilizzare la seguente API:

🇪🇺GET/sms/ptts

Per maggiori informazioni sull'utilizzo delle API OVHcloud, consulta la nostra guida Primi passi con le API OVHcloud.

Nella tabella seguente trovi un elenco non esaustivo dei principali codici ptt.

Codice	Descrizione
1	Notifica di stato intermedio che indica che il messaggio non è stato ancora consegnato a causa di un problema relativo al telefono, ma che è in corso un nuovo tentativo di invio (Intermediate state notification that the message has not yet been delivered due to a phone related problem but is being retried).
2	Utilizzato per indicare che il messaggio non è stato ancora consegnato a causa di un problema relativo all'operatore, ma che è in corso un nuovo tentativo all'interno della rete (Used to indicate that the message has not yet been delivered due to some operator related problem but is being retried within the network).
3	Utilizzato per indicare che il messaggio è stato accettato dall'operatore (Used to indicate that the message has been accepted by the operator).
4	Il messaggio è stato consegnato (The message was delivered).
5	Il messaggio è stato confermato come non consegnato, ma non è disponibile alcuna informazione dettagliata sul mancato invio (The message has been confirmed as undelivered but no detailed information related to the failure is known).
6	Impossibile determinare se il messaggio è stato consegnato o se è fallito, a causa della mancanza di informazioni sulla consegna da parte dell'operatore (Cannot determine whether this message has been delivered or has failed due to lack of final delivery state information from the operator).
8	Utilizzato quando un messaggio è scaduto (non poteva essere consegnato entro il suo periodo di validità) presso l'operatore SMSC, ma non è associato a un motivo del mancato invio (Used when a message expired (could not be delivered within the life time of the message) within the operator SMSC but is not associated with a reason for failure).
20	Utilizzato quando un messaggio non è recapitabile nella sua forma attuale (Used when a message in its current form is undeliverable).
21	Si verifica solo quando l'operatore accetta il messaggio prima di effettuare la verifica del credito dell'abbonato. Se i crediti sono insufficienti, l'operatore ritenta l'invio del messaggio finché l'abbonato non ricarica o finché il messaggio non scade. Se il messaggio scade e l'ultimo motivo del mancato invio è legato al credito, verrà utilizzato questo codice di errore (Only occurs where the operator accepts the message before performing the subscriber credit check. If there is insufficient credit then the operator will retry the message until the subscriber tops up or the message expires. If the message expires and the last failure reason is related to credit then this error code will be used).
23	Utilizzato quando il messaggio non è recapitabile a causa di un MSISDN errato / non valido / sulla lista nera / definitivamente vietato per questo operatore. Questo MSISDN non deve essere utilizzato nuovamente per le richieste di messaggi a questo operatore (Used when the message is undeliverable due to an incorrect / invalid / blacklisted / permanently barred MSISDN for this operator. This MSISDN should not be used again for message submissions to this operator).
24	Utilizzato quando un messaggio non è recapitabile perché l'abbonato è temporaneamente assente, ad esempio se il suo telefono è spento o non può essere localizzato sulla rete (Used when a message is undeliverable because the subscriber is temporarily absent, e.g. their phone is switch off, they cannot be located on the network).
25	Utilizzato quando l'invio del messaggio è fallito a causa di uno stato temporaneo nella rete dell'operatore. Questo può essere dovuto al livello SS7, al SMSC o al gateway (Used when the message has failed due to a temporary condition in the operator network. This could be related to the SS7 layer, SMSC or gateway).
26	Utilizzato quando l'invio del messaggio è fallito a causa di un errore temporaneo del telefono, ad esempio carta SIM piena, PME occupato, memoria piena ecc. Questo non significa che il telefono non sia in grado di ricevere questo tipo di messaggi / contenuto (vedi codice di errore 27) (Used when a message has failed due to a temporary phone related error, e.g. SIM card full, SME busy, memory exceeded etc. This does not mean the phone is unable to receive this type of message/content (refer to error code 27)).
27	Utilizzato quando un terminale è definitivamente incompatibile o non in grado di ricevere questo tipo di messaggi (Used when a handset is permanently incompatible or unable to receive this type of message).
28	Utilizzato se un messaggio fallisce o viene rifiutato a causa di un sospetto di SPAM sulla rete dell'operatore. In alcune aree geografiche potrebbe indicare che l'operatore non ha alcuna traccia del MO obbligatorio richiesto per un MT (Used if a message fails or is rejected due to suspicion of SPAM on the operator network. This could indicate in some geographies that the operator has no record of the mandatory MO required for an MT).
29	Utilizzato quando questo contenuto specifico non è autorizzato sulla rete / shortcode (Used when this specific content is not permitted on the network / shortcode).
33	Utilizzato quando l'abbonato non può ricevere un contenuto per adulti a causa di un blocco parentale (Used when the subscriber cannot receive adult content because of a parental lock).
39	Nuovo guasto dell'operatore (New operator failure).
73	L'invio del messaggio è fallito perché le combinazioni portate non sono raggiungibili (The message was failed due to the ported combinations being unreachable).
74	L'invio del messaggio è fallito perché il MSISDN è in roaming (The message was failed due to the MSISDN being roaming).
76	L'invio del messaggio è fallito perché le combinazioni portate sono bloccate per il cliente (il cliente è stato messo sulla lista nera per la destinazione portata) (The message was failed due to the ported combinations being blocked for client (the client has been blacklisted from the ported destination)).
202	L'invio del messaggio è fallito a causa delle combinazioni portate bloccate per il cliente. Contatta l'assistenza clienti per maggiori informazioni (The message was failed due to the ported combinations being blocked for the client. Please contact Client Support for additional information).

I diversi ID del DLR

Stato	Descrizione
0	In creazione o in attesa (Creating or pending)
1	Riuscito (Success)
2	Fallito (Failed)
4	In attesa (Waiting)
8	In buffer (Buffered)
16	In errore / non addebitato (Error / not billed)

Per saperne di più

Contatta la nostra Community di utenti.

Questa pagina ti è stata utile?