**Avviso di fine del supporto:** il 30 ottobre 2026, AWS terminerà il supporto per Amazon Pinpoint. Dopo il 30 ottobre 2026, non potrai più accedere alla console Amazon Pinpoint o alle risorse Amazon Pinpoint (endpoint, segmenti, campagne, percorsi e analisi). Per ulteriori informazioni, consulta [Fine del supporto di Amazon Pinpoint](https://docs.aws.amazon.com/console/pinpoint/migration-guide). **Nota: per quanto** APIs riguarda gli SMS, i comandi vocali, i messaggi push su dispositivi mobili, l'OTP e la convalida del numero di telefono non sono interessati da questa modifica e sono supportati da End User Messaging. AWS Le traduzioni sono generate tramite traduzione automatica. In caso di conflitto tra il contenuto di una traduzione e la versione originale in Inglese, quest'ultima prevarrà. # Tutorial: utilizzo di Postman con l'API Amazon Pinpoint Postman è uno strumento popolare per i test APIs in un ambiente easy-to-use grafico. È possibile utilizzare Postman per inviare richieste API a qualsiasi API REST e per ricevere le relative risposte. Postman è una soluzione pratica per testare e risolvere i problemi delle chiamate effettuate all'API Amazon Pinpoint. In questo tutorial sono descritte le procedure per la configurazione e l'utilizzo di Postman con Amazon Pinpoint. **Nota** Postman è sviluppato da una società di terze parti. Non è sviluppato o supportato da Amazon Web Services (AWS). Per ulteriori informazioni sull'utilizzo di Postman o per ricevere assistenza per i problemi correlati a questo strumento, consulta il [Centro di supporto](https://support.postman.com/hc/en-us) sul sito Web di Postman. ## Informazioni sul tutorial Questa sezione contiene una panoramica di questo tutorial. **Destinatari principali** Questo tutorial è rivolto a un pubblico di sviluppatori e di implementatori di sistema. Non è necessario avere familiarità con Amazon Pinpoint o Postman per completare le fasi descritte in questo tutorial. È necessario avere dimestichezza con la gestione di policy IAM e con la modifica degli esempi di codice JSON. Le procedure in questo tutorial sono state pensate per impedire ai nuovi utenti di utilizzare le operazioni API in grado di eliminare definitivamente le risorse Amazon Pinpoint. Gli utenti esperti possono rimuovere questa limitazione modificando la policy associata ai propri utenti . **Caratteristiche utilizzate** Questo tutorial include esempi di utilizzo della seguente funzionalità di Amazon Pinpoint: + Interazione con l'API Amazon Pinpoint tramite Postman **Tempo richiesto** Il completamento di questo tutorial richiede circa 15 minuti. **Limitazioni regionali** Non sono previste limitazioni regionali associati all'utilizzo di questa soluzione. **Costi di utilizzo delle risorse** La creazione di un AWS account è gratuita. Tuttavia, implementando questa soluzione, potresti incorrere in costi di AWS utilizzo se utilizzi Postman per eseguire una delle seguenti operazioni: + Inviare e-mail, SMS, push su dispositivi mobili o messaggi vocali + Creare e inviare campagne + Utilizzare la funzione di convalida del numero di telefono Per ulteriori informazioni sui costi associati all'utilizzo di Amazon Pinpoint, consulta [Prezzi di Amazon Pinpoint](https://aws.amazon.com/pinpoint/pricing/). # Prerequisiti per l'utilizzo di Postman con Amazon Pinpoint Prima di iniziare questo tutorial, completare i prerequisiti descritti di seguito: + Devi avere un AWS account. Per creare un AWS account, vai su [https://console.aws.amazon.com/](https://console.aws.amazon.com/)e scegli **Crea un nuovo AWS account**. + Assicurati che l'account che usi per accedere Console di gestione AWS possa creare nuove politiche e ruoli IAM. + Assicurati di aver creato almeno un progetto di esempio con la funzionalità e-mail attivata e un'identità e-mail verificata. Consulta [Creazione di un progetto Amazon Pinpoint con supporto e-mail ](https://docs.aws.amazon.com/pinpoint/latest/userguide/channels-email-setup-create.html) nella *Guida per l'utente di Amazon Pinpoint*. + Assicurati di avere un ID AWS account. L'ID del tuo AWS account si trova nell'angolo in alto a destra della console oppure puoi utilizzare l'interfaccia a riga di comando (CLI). Vedi [Come trovare](https://docs.aws.amazon.com/accounts/latest/reference/manage-acct-identifiers.html#FindAccountId) l'ID del tuo account. AWS + È necessario scaricare e installare Postman sul computer. È possibile scaricare Postman dal [sito Web Postman](https://www.getpostman.com). + Dopo aver installato Postman sul computer, crea un account Postman. Al primo avvio dell'applicazione Postman, verrà richiesto di effettuare l'accesso o di creare un nuovo account. Segui le istruzioni fornite da Postman per accedere al tuo account o per creare un account se non lo hai già creato. [Successivo](tutorials-using-postman-iam-user.md): **Creazione di policy e ruoli IAM** # Crea policy e ruoli IAM da utilizzare con Amazon Pinpoint Quando usi Postman per testare l'API Amazon Pinpoint, il primo passaggio prevede la creazione di un utente. In questa sezione, dovrai una policy che consenta agli utenti di interagire con tutte le risorse Amazon Pinpoint e quindi creare un utente a cui collegare direttamente la policy. ## Creazione di una policy IAM Scopri come creare una policy IAM. Gli utenti e i ruoli che utilizzano questa policy sono in grado di interagire con tutte le risorse nell'API Amazon Pinpoint. Tale policy consente inoltre l'accesso alle risorse associate alle API E-mail e SMS e Voce di Amazon Pinpoint. **Come creare la policy** 1. Accedi Console di gestione AWS e apri la console IAM all'indirizzo [https://console.aws.amazon.com/iam/](https://console.aws.amazon.com/iam/). 1. Nel pannello di navigazione, scegli **Policy** e **Crea policy**. 1. Nell'**editor delle politiche**, seleziona **JSON**. Elimina qualsiasi codice JSON corrente nell'**editor delle politiche** in modo che sia vuoto. Copia e incolla il seguente codice JSON nell'editor delle **politiche, quindi nell'editor** delle **politiche** sostituisci tutte le istanze di *123456789012* con il tuo ID. Account AWS Il tuo Account AWS ID si trova nell'angolo in alto a destra della console oppure puoi usare la CLI, vedi [Trovare l'ID del tuo AWS account](https://docs.aws.amazon.com/accounts/latest/reference/manage-acct-identifiers.html#FindAccountId). **Nota** Per proteggere i dati nell'account Amazon Pinpoint, questa policy include solo le autorizzazioni che consentono la lettura, la creazione e la modifica delle risorse. Non include le autorizzazioni che consentono l'eliminazione delle risorse. È possibile modificare questa policy utilizzando l'editor visivo nella console IAM. Per ulteriori informazioni, consulta [Gestione di policy IAM](https://docs.aws.amazon.com/IAM/latest/UserGuide/access_policies_manage.html) nella Guida per l'utente di IAM. Puoi anche utilizzare l'[CreatePolicyVersion](https://docs.aws.amazon.com/IAM/latest/APIReference/API_CreatePolicyVersion.html)operazione nell'API IAM per aggiornare questa policy. È inoltre importante tenere presente che questa policy include autorizzazioni che consentono di interagire con i servizi `ses` e `sms-voice`, oltre al servizio `mobiletargeting`. Le autorizzazioni `ses` e `sms-voice` consentono di interagire rispettivamente con le API E-mail e SMS e Voce di Amazon Pinpoint. Le autorizzazioni `mobiletargeting` consentono di interagire con l'API Amazon Pinpoint. ------ #### [ JSON ] **** ``` { "Version":"2012-10-17", "Statement": [ { "Sid": "VisualEditor0", "Effect": "Allow", "Action": [ "mobiletargeting:Update*", "mobiletargeting:Get*", "mobiletargeting:Send*", "mobiletargeting:Put*", "mobiletargeting:Create*" ], "Resource": [ "arn:aws:mobiletargeting:*:123456789012:apps/*", "arn:aws:mobiletargeting:*:123456789012:apps/*/campaigns/*", "arn:aws:mobiletargeting:*:123456789012:apps/*/segments/*" ] }, { "Sid": "VisualEditor1", "Effect": "Allow", "Action": [ "mobiletargeting:TagResource", "mobiletargeting:PhoneNumberValidate", "mobiletargeting:ListTagsForResource", "mobiletargeting:CreateApp" ], "Resource": "arn:aws:mobiletargeting:*:123456789012:*" }, { "Sid": "VisualEditor2", "Effect": "Allow", "Action": [ "ses:TagResource", "ses:Send*", "ses:Create*", "ses:Get*", "ses:List*", "ses:Put*", "ses:Update*", "sms-voice:SendVoiceMessage", "sms-voice:List*", "sms-voice:Create*", "sms-voice:Get*", "sms-voice:Update*" ], "Resource": "*" } ] } ``` ------ Scegli **Next (Successivo)**. 1. Per **Nome della politica**, inserisci un nome per la politica, ad esempio**PostmanAccessPolicy**. Scegli **Crea policy**. 1. (Facoltativo) Puoi aggiungere tag alla policy selezionando **Aggiungi tag**. 1. Scegli **Prossimo: Rivedi**. ## Creare un utente IAM **avvertimento** Gli utenti IAM dispongono di credenziali a lungo termine, il che rappresenta un rischio per la sicurezza. Per ridurre questo rischio, si consiglia di fornire a questi utenti solo le autorizzazioni necessarie per eseguire l'attività e di rimuoverli quando non sono più necessari. Dopo aver creato la policy, è possibile creare un utente a cui collegarla. Quando crei l'utente, IAM fornisce un set di credenziali da utilizzare per consentire a Postman di eseguire operazioni dell'API Amazon Pinpoint. **Per creare l'utente** 1. Aprire la console IAM all'indirizzo [https://console.aws.amazon.com/iam/](https://console.aws.amazon.com/iam/). 1. Sulla console IAM, nel riquadro di navigazione, scegli **Utenti**, quindi scegli **Crea utenti**. 1. In **Dettagli utente**, nel campo **Nome utente**, immetti un nome che identifichi l'account utente, come **PostmanUser**. Quindi scegli **Successivo**. 1. In **Imposta autorizzazioni**, nel campo **Opzioni delle autorizzazioni**, scegli **Allega direttamente le policy**. 1. In **Politiche di autorizzazione**, scegli la policy (**PostmanAccessPolicy**) che hai creato in [Crea una policy IAM](#tutorials-using-postman-iam-user-create-policy). Quindi scegli **Successivo**. 1. Nella pagina **Rivedi e crea**, puoi facoltativamente aggiungere tag per semplificare l'identificazione dell'utente. Per ulteriori informazioni sull'utilizzo di tag, consulta la sezione [Tagging delle risorse IAM](https://docs.aws.amazon.com/IAM/latest/UserGuide/id_tags.html) nella *Guida per l'utente di IAM*. 1. Quando si è pronti per creare l'utente, scegliere **Create user (Crea utente)**. ## Crea chiavi di accesso **avvertimento** Questo scenario richiede agli utenti IAM un accesso programmatico e credenziali a lungo termine, il che rappresenta un rischio per la sicurezza. Per ridurre questo rischio, si consiglia di fornire a questi utenti solo le autorizzazioni necessarie per eseguire l'attività e di rimuoverli quando non sono più necessari. Le chiavi di accesso possono essere aggiornate se necessario. Per ulteriori informazioni, consulta la sezione [Aggiornamento delle chiavi di accesso](https://docs.aws.amazon.com/IAM/latest/UserGuide/id-credentials-access-keys-update.html) nella *Guida per l'utente IAM*. IAM fornisce un set di credenziali che puoi utilizzare per consentire a Postman di eseguire operazioni dell'API Amazon Pinpoint. **Per creare l'utente** 1. Aprire la console IAM all'indirizzo [https://console.aws.amazon.com/iam/](https://console.aws.amazon.com/iam/). 1. Nel riquadro di navigazione della console IAM, scegli **Utenti**. Seleziona l'utente (**PostmanUser**) creato in [Crea un utente IAM](#tutorials-using-postman-iam-user-create-user), quindi seleziona la scheda **Credenziali di sicurezza**. 1. Nella sezione **Chiavi di accesso**, scegliere **Crea chiave di accesso**. 1. Nella pagina **Access key best practice e alternative**, seleziona **Applicazione in esecuzione all'esterno AWS**. Quindi scegli **Successivo**. 1. (Facoltativo) Puoi aggiungere un tag descrittivo alla policy. 1. Selezionare **Create access key (Crea chiave di accesso)**. 1. Nella pagina **Recupera le chiavi di accesso**, copia le credenziali visualizzate nelle colonne **Chiave di accesso** e **Chiave di accesso segreta**. **Nota** È necessario fornire sia l'ID chiave di accesso sia la chiave di accesso segreta più avanti in questo tutorial. Questa è l'unica volta in cui è possibile visualizzare la chiave di accesso segreta. Ti consigliamo di copiarla e conservarla in un luogo sicuro. 1. Dopo aver salvato entrambe le chiavi, scegli **Fatto**. **Successivo**: [Configurazione di Postman](tutorials-using-postman-configuration.md) # Configurare Postman per l'utilizzo con Amazon Pinpoint Dopo aver creato un account utente in grado di accedere all'API Amazon Pinpoint, puoi configurare Postman. In questa sezione, crea uno o più ambienti in Postman. Quindi, importa una raccolta contenente modello di richiesta di ciascuna delle operazioni nell'API Amazon Pinpoint. ## Crea uno spazio di lavoro Postman In Postman, un *workspace* è un container organizzativo per progetti e ambienti. In questa sezione, dovrai creare almeno un workspace da utilizzare con Amazon Pinpoint. **Creare un'area di lavoro** In Postman, scegli Altre azioni, quindi seleziona **File**, **Nuovo**. 1. Nella finestra **Crea nuovo**, scegli **Workspace**. 1. Inserisci un nome, un riepilogo e imposta la visibilità su Personale. Quindi, scegli **Crea workspace**. ## Crea ambienti Postman In Postman, un *ambiente* è un set di variabili che vengono memorizzate come coppie chiave-valore. È possibile utilizzare gli ambienti per modificare la configurazione delle richieste effettuate tramite Postman, senza dover modificare le richieste API. In questa sezione, dovrai creare almeno un ambiente da utilizzare con Amazon Pinpoint. Ogni ambiente creato contiene un set di variabili specifiche per l'account in un'unica Regione AWS. Se utilizzi le procedure di questa sezione per creare più di un ambiente, puoi passare da una regione a un'altra selezionando un ambiente diverso nel menu **Ambiente** in Postman. **Come creare un ambiente** 1. In Postman, scegli il menu Altre azioni, quindi seleziona **File**, **Nuovo**. 1. Nella finestra **Create New (Crea nuovo)**, scegliere **Environment (Ambiente)**. 1. Nella finestra **MANAGE ENVIRONMENTS (GESTISCI AMBIENTI)**, per **Environment Name (Nome ambiente)**, inserire **Amazon Pinpoint - *Region Name***. Sostituisci *Region Name* con uno dei seguenti valori: + Stati Uniti orientali (Virginia settentrionale) + Stati Uniti occidentali (Oregon) + Asia Pacifico (Mumbai) + Asia Pacifico (Sydney) + Europa (Francoforte) + Europa (Irlanda) **Nota** È necessario creare almeno un ambiente per ogni singolo ambiente Regione AWS, che Regione AWS deve contenere un solo progetto. Se non hai creato un progetto in uno dei progetti elencati in precedenza Regioni AWS, consulta [Creazione di un progetto Amazon Pinpoint con supporto via e-mail](https://docs.aws.amazon.com/pinpoint/latest/userguide/channels-email-setup-create.html) nella Guida per l'utente di *Amazon Pinpoint*. 1. Creare sei nuove variabili: `endpoint`, `region`, `serviceName`, `accountId`, `accessKey` e `secretAccessKey`. Utilizza la tabella seguente per determinare il valore da inserire nelle colonne **Valore iniziale** e **Valore corrente** per ogni variabile. [\[See the AWS documentation website for more details\]](http://docs.aws.amazon.com/it_it/pinpoint/latest/userguide/tutorials-using-postman-configuration.html) Una volta create queste variabili, l'aspetto della finestra **MANAGE ENVIRONMENTS (GESTISCI AMBIENTI)** è simile a quello dell'esempio mostrato nella seguente immagine. ![\[\]](http://docs.aws.amazon.com/it_it/pinpoint/latest/userguide/images/Postman_Tutorial_2.1_4.png) Al termine, scegli **Salva**. **Importante** Le chiavi di accesso mostrate nell'immagine precedente sono fittizie. Non condividere le chiavi di accesso IAM con altri utenti. Postman include funzionalità che consentono di condividere ed esportare ambienti. Se utilizzi queste funzionalità, assicurati di non condividere l'ID chiave di accesso e la chiave di accesso segreta con chiunque non debba avere accesso a tali credenziali. Per ulteriori informazioni, consultare la sezione [best practice IAM](https://docs.aws.amazon.com/IAM/latest/UserGuide/best-practices.html) nella *Guida per l'utente IAM*. 1. (Facoltativo) Ripeti i passaggi da 1 a 4 per ogni altro ambiente che desideri creare. **Suggerimento** In Postman, è possibile creare tutti gli ambienti di cui si ha bisogno. Puoi utilizzare gli ambienti nei seguenti modi: Creare un ambiente separato per ogni regione in cui è necessario testare l'API Amazon Pinpoint. Creare ambienti associati a diversi Account AWS. Creare ambienti che utilizzano credenziali associate a un altro utente. 1. Una volta terminata la creazione di ambienti, procedere alla sezione successiva. ## Crea una raccolta Amazon Pinpoint in Postman In Postman, una *raccolta* è un gruppo di richieste API. Le richieste in una raccolta sono in genere unite da uno scopo comune. In questa sezione, dovrai creare una nuova raccolta contenente un modello di richiesta per ciascuna operazione nell'API Amazon Pinpoint. **Per creare la raccolta Amazon Pinpoint** 1. In Postman, scegli il menu Altre azioni, quindi seleziona **File**, **Importa**. 1. Nella finestra **Importa, scegli Importa** **da link**, quindi inserisci il seguente URL: [https://raw.githubusercontent.com/awsdocs/amazon-pinpoint-developer-guide/master/Amazon](https://raw.githubusercontent.com/awsdocs/amazon-pinpoint-developer-guide/master/Amazon%20Pinpoint.postman_collection.json) %20Pinpoint.postman\$1collection.json. Scegli **Importa**. Postman importa la raccolta Amazon Pinpoint, contenente 120 richieste di esempio. ## Test della configurazione di Postman Dopo aver importato la raccolta Amazon Pinpoint, è consigliabile eseguire un test rapido per verificare la corretta configurazione di tutti i componenti. È possibile provare la configurazione inviando una richiesta `GetApps`. Questa richiesta restituisce l'elenco di tutti i progetti esistenti nell'account Amazon Pinpoint nella Regione AWS attuale. Questa richiesta non necessita di configurazioni aggiuntive e per tale motivo rappresenta un valido modo per testare la configurazione. **Per testare la configurazione della raccolta Amazon Pinpoint** 1. Nel riquadro di navigazione, seleziona **Raccolte**, espandi la raccolta **Amazon Pinpoint** e quindi espandi la cartella **App**. 1. Nell'**GetApps**elenco delle richieste, scegli. 1. Usa il selettore **Ambiente** per scegliere l'ambiente che hai creato in Ambienti [Create Postman](#tutorials-using-postman-configuration-create-environments). 1. Scegli **Invia**. Se la richiesta viene inviata correttamente, il riquadro di risposta mostra lo stato `200 OK`. Viene visualizzata una risposta simile all'esempio riportato nella seguente immagine. ![\[\]](http://docs.aws.amazon.com/it_it/pinpoint/latest/userguide/images/Postman_Tutorial_2.3_3.png) **Nota** Se non hai creato alcun progetto nel, Regione AWS restituisce Amazon Pinpoint. `{ "Item": [] }` Questa risposta mostra l'elenco di tutti i progetti Amazon Pinpoint esistenti nell'account nella regione scelta al Passaggio 3. ### Risoluzione dei problemi Quando invii la richiesta, è possibile che venga visualizzato un errore. Di seguito sono elencati i diversi errori comuni che possono verificarsi e le relative fasi per la risoluzione. | Messaggio di errore | Problema | Risoluzione | | --- | --- | --- | | Could not get any response (Impossibile ottenere una risposta) Si è verificato un errore durante la connessione a https://%7B%7Bendpoint%7D%7D/v1/apps. | Non esiste alcun valore attuale per la variabile `{{endpoint}}`, che è impostata quando scegli un ambiente. | Utilizza il selettore di ambiente per scegliere un ambiente. | | Il token di sicurezza incluso nella richiesta non è valido. | Postman non era in grado di individuare il valore attuale dell'ID chiave di accesso o della chiave di accesso segreta. | Scegli l'icona a forma di ingranaggio accanto al selettore di ambiente e quindi scegli l'ambiente attuale. Assicurati che i valori `accessKey` e `secretAccessKey` vengano visualizzati in entrambe le colonne **VALORE INIZIALE** e **VALORE CORRENTE** e verifica di aver inserito le credenziali correttamente. | | «Message»: «Utente: arn:aws:iam: :123456789012:user/ non PinpointPostmanUser è autorizzato a eseguire: mobiletargeting: on resource: arn:aws:mobiletargeting:us-west- 2:123456789012: \$1» GetApps | La policy IAM associata all'utente non include le autorizzazioni appropriate. | [[Verifica che il tuo utente disponga delle autorizzazioni descritte in Creare una policy IAM e di aver fornito le credenziali corrette quando hai creato l'ambiente nell'area di lavoro Create Postman.](#tutorials-using-postman-configuration-create-environments)](tutorials-using-postman-iam-user.md#tutorials-using-postman-iam-user-create-policy) | **Successivo**: [Invio di richieste aggiuntive](tutorials-using-postman-sample-requests.md) # Inviare richieste all'API Amazon Pinpoint Al termine della configurazione e del test di Postman, è possibile iniziare a inviare richieste aggiuntive all'API Amazon Pinpoint. In questa sezione sono incluse informazioni che è necessario conoscere prima di iniziare a inviare le richieste. Include anche due richieste di esempio che descrivono come utilizzare la raccolta Amazon Pinpoint. **Importante** Dopo aver completato le procedure di questa sezione, è possibile inviare richieste all'API Amazon Pinpoint. Tali richieste creano nuove risorse nell'account Amazon Pinpoint, modificano le risorse esistenti, inviano messaggi, modificano la configurazione dei progetti Amazon Pinpoint e utilizzare altre funzionalità di Amazon Pinpoint. Presta attenzione quando esegui queste richieste. ## Esempi nella raccolta Amazon Pinpoint Postman Prima di poterle utilizzare, è necessario configurare la maggior parte delle operazioni nel file di raccolta Postman di Amazon Pinpoint. Per le operazioni `GET` e `DELETE`, in genere occorre solo modificare le variabili impostate nella scheda **Pre-request Script (Script prerichiesta)**. **Nota** Quando utilizzi la policy IAM mostrata in [Creare una policy IAM](tutorials-using-postman-iam-user.md#tutorials-using-postman-iam-user-create-policy), non puoi eseguire nessuna delle `DELETE` richieste incluse in questa raccolta. Ad esempio, l'operazione `GetCampaign` richiede l'indicazione di un `projectId` e di un `campaignId`. Nella scheda **Pre-request Script (Script prerichiesta)**, sono presenti entrambi i valori, che vengono popolati con valori di esempio. È necessario eliminare i valori di esempio e sostituirli con quelli validi per il progetto o la campagna Amazon Pinpoint. Di queste variabili, quella più comunemente usata è la variabile `projectId`. Il valore di questa variabile deve essere l'identificatore univoco del progetto a cui si applica la richiesta. Per ottenere l'elenco di questi identificatori dei progetti, è possibile fare riferimento alla risposta alla richiesta `GetApps` inviata nel passaggio precedente di questo tutorial. In quella risposta, il campo `Id` include l'identificatore univoco di un progetto. Per ulteriori informazioni sull'operazione `GetApps` e sul significato di ciascun campo nella risposta, consulta [App](https://docs.aws.amazon.com/pinpoint/latest/apireference/apps.html) nella *documentazione di riferimento dell'API Amazon Pinpoint*. **Nota** In Amazon Pinpoint, il termine "progetto" equivale al termine "app" o "applicazione". Per le operazioni `POST` e `PUT`, è necessario modificare anche il corpo della richiesta in modo da includere i valori da inviare all'API. Ad esempio, quando si invia una richiesta `CreateApp`, che è una richiesta `POST`, è necessario specificare un nome per il progetto in fase di creazione. È possibile modificare la richiesta nella scheda **Body (Corpo)**. In questo esempio, il valore accanto a `"Name"` viene sostituito con il nome del progetto. Se si desidera aggiungere tag al progetto, è possibile specificarli nell'oggetto `tags`. O, se non si desidera aggiungere i tag, è possibile eliminare l'intero oggetto `tags`. **Nota** L'operazione `UntagResource` richiede anche l'indicazione di parametri URL. Tali parametri si possono specificare nella scheda **Params (Parametri)**. Sostituire i valori nella colonna **VALUE** con i tag che si desidera eliminare per la risorsa specificata. ## Richiesta di esempio: crea un progetto utilizzando l'`CreateApp`operazione Prima di creare segmenti e campagne in Amazon Pinpoint, è prima necessario creare un progetto. In Amazon Pinpoint, un *progetto* è composto da segmenti, campagne, configurazioni e dati che condividono uno scopo comune. Ad esempio, è possibile utilizzare un progetto per contenere tutti i contenuti relativi a una particolare app o a un determinato brand o iniziativa di marketing. Quando si aggiungono le informazioni sui clienti ad Amazon Pinpoint, quelle informazioni sono associate a un progetto. **Per creare un progetto inviando una richiesta CreateApp API** 1. Nel menu **Ambienti**, scegli Regione AWS quello in cui vuoi creare il progetto. ![\[\]](http://docs.aws.amazon.com/it_it/pinpoint/latest/userguide/images/Postman_Tutorial_Environments.png) In questo esempio, Postman è stato configurato in modo tale che il menu **Environments (Ambienti)** mostri le seguenti quattro opzioni: + Stati Uniti orientali (Virginia settentrionale) + Stati Uniti occidentali (Oregon) + Europa (Francoforte) + Europa (Irlanda) 1. Nella cartella **App**, scegli l'**CreateApp**operazione>. ![\[\]](http://docs.aws.amazon.com/it_it/pinpoint/latest/userguide/images/Postman_Tutorial_3.2_2.png) La cartella **App** nella raccolta Postman di Amazon Pinpoint viene espansa e mostra le seguenti richieste: + `GetApp` + `GetApps` + `CreateApp` + `DeleteApp` 1. Nella scheda **Body (Corpo)**, accanto a `"Name"`, sostituire il valore del segnaposto (`"string"`) con un nome della campagna, ad esempio **"MySampleProject"**. 1. Elimina la virgola dopo il nome della campagna, quindi elimina l'intero oggetto `tags` nelle righe da 3 a 5. Al termine, la richiesta deve essere simile all'esempio illustrato nel seguente frammento di codice. ``` { "Name": "MySampleProject" } ``` Postman è configurato per inviare la richiesta come un payload JSON raw. 1. Scegli **Invia**. Se la campagna viene creata correttamente, il riquadro di risposta mostra lo stato `201 Created`. ``` { "Name": "MySampleProject" "Id": "12345678901234567890123456789012", "Arn": "arn:aws:mobiletargeting:us-east-1:123456789012:apps/12345678901234567890123456789012", "tags": {} } ``` ## Esempio: inviare un'e-mail utilizzando l'operazione `SendMessages` È molto comune utilizzare l'API `SendMessages` di Amazon Pinpoint per inviare messaggi transazionali. Uno dei vantaggi dell'invio di messaggi tramite l'API `SendMessages` rispetto alla creazione delle campagne è la possibilità di inviare messaggi a qualsiasi indirizzo, come indirizzi e-mail, numeri di telefono o token di dispositivi. Non è necessario che l'indirizzo a cui vengono inviati i messaggi sia già presente nell'account Amazon Pinpoint. Confrontiamo questa opzione con l'invio di messaggi tramite la creazione di campagne. Prima di inviare una campagna in Amazon Pinpoint, devi aggiungere endpoint all'account Amazon Pinpoint, creare segmenti e quindi creare ed eseguire la campagna. L'esempio in questa sezione mostra come inviare un messaggio e-mail transazionale direttamente a un indirizzo e-mail specifico. È possibile modificare questa richiesta per inviare messaggi tramite altri canali, ad esempio SMS, push su dispositivi mobili o voce. **Per inviare un messaggio di posta elettronica inviando una SendMessages richiesta** 1. Verifica che il canale e-mail sia abilitato per il progetto e che l'indirizzo e-mail o il dominio che desideri utilizzare per inviare e ricevere il messaggio sia configurato. Per ulteriori informazioni, consulta [Abilitazione e disabilitazione del canale e-mail](pinpoint/latest/userguide/channels-email-setup.html) e [Verifica delle identità e-mail](https://docs.aws.amazon.com/pinpoint/latest/userguide/channels-email-manage-verify.html) nella *Guida per l'utente di Amazon Pinpoint*. **Nota** Per completare la procedura riportata in questa sezione, è necessario verificare un indirizzo e-mail. 1. Nel menu **Ambienti**, scegli il Regione AWS dispositivo da cui desideri inviare il messaggio. In questo esempio, Postman è stato configurato in modo tale che il menu **Environments (Ambienti)** mostri le seguenti quattro opzioni: + Stati Uniti orientali (Virginia settentrionale) + Stati Uniti occidentali (Oregon) + Europa (Francoforte) + Europa (Irlanda) 1. Nella cartella **Messaggi**, scegli l'**SendMessages**operazione. ![\[\]](http://docs.aws.amazon.com/it_it/pinpoint/latest/userguide/images/Postman_Tutorial_3.3_3.png) 1. Nella scheda **Pre-request Script (Script pre-richiesta)**, sostituire il valore della variabile `projectId` con l'ID di un progetto già esistente nella regione selezionata nella Fase 2 di questa sezione. 1. Nella scheda **Body (Corpo)**, eliminare la richiesta di esempio illustrata nell'editor della richiesta. Incolla il codice seguente: ``` { "MessageConfiguration":{ "EmailMessage":{ "FromAddress":"sender@example.com", "SimpleEmail":{ "Subject":{ "Data":"Sample Amazon Pinpoint message" }, "HtmlPart":{ "Data":"

Test message

This is a sample message sent from Amazon Pinpoint using the SendMessages API.

" }, "TextPart":{ "Data":"This is a sample message sent from Amazon Pinpoint using the SendMessages API." } } } }, "Addresses":{ "recipient@example.com": { "ChannelType": "EMAIL" } } } ``` 1. Nel codice precedente, sostituiscilo *sender@example.com* con il tuo indirizzo email verificato. Sostituiscilo *recipient@example.com* con l'indirizzo email verificato a cui desideri inviare il messaggio. **Nota** Se l'account è ancora nell'ambiente di sperimentazione (sandbox) per e-mail di Amazon Pinpoint, è possibile inviare e-mail solo agli indirizzi o domini verificati nell'account Amazon Pinpoint. Per ulteriori informazioni su come far rimuovere l'account dall'ambiente di sperimentazione (sandbox), consulta la sezione relativa alla [richiesta dell'accesso all'ambiente di produzione per il canale e-mail](https://docs.aws.amazon.com/pinpoint/latest/userguide/channels-email-setup-production-access.html) nella *Guida per l'utente di Amazon Pinpoint*. 1. Scegli **Invia**. Se il messaggio viene inviato correttamente, il riquadro di risposta mostra lo stato `200 OK`. ``` { "ApplicationId": "12345678901234567890123456789012", "RequestId": "", "Result": { "recipient@example.com": { "DeliveryStatus": "SUCCESSFUL", "StatusCode": 200, "StatusMessage": "", "MessageId": "" } } } ```