Gestione dei numeri di telefono disattivati

Un numero di telefono disattivato significa che l'abbonato di telefonia mobile ha terminato il servizio o trasferito il proprio numero di telefono a un altro provider di rete mobile. Alla fine, i numeri disattivati vengono riciclati e riassegnati a nuovi abbonati. Pertanto, è possibile inviare erroneamente un messaggio SMS a un numero di telefono che ora appartiene a un altro abbonato che non ha aderito al tuo programma di messaggistica SMS.

I provider di rete mobile pubblicano spesso rapporti di disattivazione che contengono un elenco aggiornato di numeri di telefono disattivati nelle loro reti. Questi report vengono pubblicati per contribuire a mantenere aggiornato e conforme l'elenco di invio degli SMS.

Nota

Molti dei numeri di cellulare riportati nei rapporti di disattivazione sono numeri che sono stati trasferiti a un altro provider di rete mobile dall'abbonato. La modifica dei provider di rete mobile richiede l'autorizzazione del nuovo provider di rete mobile. Esiste il rischio di rimuovere un numero disattivato che l'utente finale ritiene debba ancora ricevere messaggi. Puoi interagire con i tuoi utenti finali attraverso diversi canali (e-mail o chiamate vocali) se scopri che il loro numero di telefono è disattivato.

Perché è importante?

Negli Stati Uniti, la Federal Communications Commission (FCC) considera spam l'invio di messaggi a un numero di telefono di un abbonato che non ha aderito ai tuoi progetti. Questa posizione può portare a reclami da parte dell'utente finale e del provider di rete mobile, che possono quindi portare a verifiche e mettere l'invio dei messaggi SMS a rischio di essere completamente bloccato dai provider di rete mobile. Nel peggiore dei casi, la FCC può imporre multe o potresti essere oggetto di un'azione legale collettiva.

Inoltre, quando invii messaggi SMS tramite Amazon Pinpoint, ti viene addebitato un costo per ogni messaggio inviato. Mantenendo aggiornati i tuoi elenchi di utenti finali, puoi evitare addebiti per messaggi non necessari.

Amazon Pinpoint fornisce una copia dei rapporti di disattivazione per consentirti di mantenere aggiornati periodicamente i tuoi elenchi di utenti finali. Questi report provengono da provider di rete mobile e vengono elaborati quotidianamente. Ogni rapporto contiene un elenco di numeri di telefono che sono stati disattivati sulle reti dei provider di rete mobile e devono essere scaricati e confrontati con l'elenco degli utenti finali esistente. Elimina tutti i numeri di telefono dagli elenchi degli utenti finali che sono stati disattivati.

Per ulteriori informazioni sulla gestione degli elenchi di utenti finali esistenti, consulta Eliminazione degli endpoint da Amazon Pinpoint e Gestione degli elenchi di disattivazione nella Amazon Pinpoint Developer Guide.

Richiesta di report di disattivazione

Prima di poter ottenere una copia di un rapporto di disattivazione, devi prima richiedere un rapporto di disattivazione tramite una richiesta dell'API Amazon S3 GET OBJECT utilizzando l'opzione buckets REQUESTER PAYS per scaricare un file. Per ulteriori informazioni sui bucket Requester Pays, consulta Scaricamento di oggetti nei bucket Requester Pays nella Amazon S3 User Guide.

Le richieste effettuate ai bucket S3 e agli oggetti che richiedono l'opzione richiedente paga. I costi delle richieste S3 dipendono dal tipo di richiesta e vengono addebitati in base alla quantità di richieste. Per ulteriori informazioni sui costi delle richieste S3, consulta i prezzi di Amazon S3.

Nota

I rapporti di disattivazione recuperano solo i numeri di telefono degli Stati Uniti.

Amazon Pinpoint offre due tipi di report di disattivazione. Per facilità d'uso, se desideri il rapporto di disattivazione più recente, puoi inviare una richiesta utilizzando il formato oggetto più recente. Se desideri un rapporto di disattivazione per una data specifica, puoi inviare una richiesta utilizzando il formato oggetto specifico per la data.

Nota

Amazon Pinpoint archivia solo oggetti specifici degli ultimi 90 giorni di data.

Per richiedere un rapporto di disattivazione, puoi utilizzare il modello seguente.

Bucket name format: {region}-pinpoint-sms-voice/

Latest object format: /sms-deact-reports/{iso2}/latest-deact-report.csv

Date specific object format: /sms-deact-reports/{iso2}/{YYYY}-{MM}-{DD}-deact-report.csv

Per connettersi a livello di programmazione a un servizio AWS, è possibile utilizzare un endpoint. Vuoi sostituire {region} con il tuo endpoint regionale. Per un elenco delle regioni Amazon Pinpoint supportate per il nome del bucket, consulta gli endpoint e le quote di Amazon Pinpoint nella AWSGuida generale.

Nell'esempio seguente viene illustrato come richiedere l'ultimo rapporto di disattivazione utilizzandoAWS CLI il comando.

aws s3api get-object --bucket us-east-1-pinpoint-sms-voice --key sms-deact-reports/us/latest-deact-report.csv OUTFILE.csv --request-payer requester

Nell'esempio seguente viene illustrato come richiedere un rapporto di disattivazione specifico per una data utilizzandoAWS CLI il comando.

aws s3api get-object --bucket us-east-1-pinpoint-sms-voice --key sms-deact-reports/us/2022-09-28-deact-report.csv OUTFILE.csv --request-payer requester

Dopo l'invio della richiesta Amazon S3 GET OBJECT API, il rapporto di disattivazione viene scaricato nel file OUTFILE.csv specificato nel comando.

Utilizzando l'API Amazon S3, puoi ottenere un elenco di rapporti di disattivazione. È possibile elencare i report di disattivazione solo all'interno dellasms-deact-reports/us/ cartella incorporata.

L'esempio seguente mostra come ottenere l'elenco dei report di disattivazione disponibili.

aws s3api list-objects-v2 --bucket us-east-1-pinpoint-sms-voice --prefix "sms-deact-reports/us/" --request-payer requester