---
title: "Tutto sugli utenti SMS"
description: "Scopri come creare, configurare e gestire gli utenti API per l'invio di SMS, incluse le autorizzazioni e le restrizioni"
url: https://docs.ovhcloud.com/it/guides/web-cloud/messaging/sms/sms-users
lang: it
lastUpdated: 2026-06-15
---
# Tutto sugli utenti SMS
## Obiettivo
Questa guida ti spiega come creare e gestire gli utenti API.
## Prerequisiti
- Disporre di un [account SMS OVHcloud](https://www.ovhcloud.com/it/sms/).
***
### 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](/it/guides/web-cloud/messaging/sms/send-sms-http2sms.md).
### 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](https://eu.api.ovh.com/console/?section=/sms&branch=v1#get-/sms/ptts)
Per maggiori informazioni sull'utilizzo delle API OVHcloud, consulta la nostra guida [Primi passi con le API OVHcloud](/it/guides/manage-and-operate/api/first-steps.md).
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](https://community.ovhcloud.com/).