Risoluzione dei problemi - Amazon Pinpoint
Esempi CLI di attività comuni

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 la fine del supporto di Amazon Pinpoint. 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 AWS End User Messaging.

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à.

Risoluzione dei problemi

Nota

I seguenti argomenti per la risoluzione dei problemi sono stati spostati:

In questa sezione puoi familiarizzare con le informazioni sulla risoluzione dei problemi e sulle possibili soluzioni durante l'utilizzo di Amazon Pinpoint.

Monitoraggio e registrazione

Come best practice, è consigliabile registrare gli eventi nei log di Amazon Pinpoint mediante le seguenti operazioni:

Esempi CLI di attività comuni

Gli esempi seguenti sono comandi CLI comuni per Amazon Pinpoint.

  • Recupero dei dati degli endpoint: CLI get-endpoint

    aws pinpoint get-endpoint —application-id AppId —endpoint-id EndpointId
    Nel comando precedente, apporta le modifiche seguenti:

    • Sostituisci AppId con l'ID del progetto Amazon Pinpoint che contiene l'endpoint.

    • Sostituiscilo EndpointId con l'ID di un endpoint esistente che stai recuperando.

  • Ottieni dati utente: get-user-endpointsCLI

    aws pinpoint get-user-endpoints —application-id AppId —user-id UserId
    Nel comando precedente, apporta le modifiche seguenti:

    • Sostituisci AppId con l'ID del progetto Amazon Pinpoint che contiene l'endpoint.

    • Sostituisci UserId con l'ID dell'utente.

  • Aggiornamento o creazione di un nuovo endpoint: CLI update-endpoint

    aws pinpoint update-endpoint —application-id AppId —endpoint-id EndpointId —endpoint-request '{"ChannelType":"SMS","Address":"+12345678","Location":{"Country":"USA"},"User":{"UserId":"UserId"}}'
    Nel comando precedente, apporta le modifiche seguenti:

    • Sostituisci AppId con l'ID del progetto Amazon Pinpoint che contiene l'endpoint.

    • Sostituiscilo EndpointId con l'ID di un endpoint esistente che stai creando o aggiornando.

    • Sostituisci UserId con l'ID dell'utente.

  • Eliminazione dell'endpoint: CLI delete-endpoint

    aws pinpoint delete-endpoint —application-id AppId —endpoint-id EndpointId
    Nel comando precedente, apporta le modifiche seguenti:

    • Sostituisci AppId con l'ID del progetto Amazon Pinpoint che contiene l'endpoint.

    • Sostituiscilo EndpointId con l'ID di un endpoint esistente che stai eliminando.

  • Convalida un numero di telefono: phone-number-validateCLI

    aws pinpoint phone-number-validate —number-validate-request PhoneNumber=+12065550100
    Nel comando precedente, apporta le modifiche seguenti:

    • +12065550100Sostituiscilo con il numero di telefono che desideri convalidare.

  • CLI send-messages di esempio: SMS a un numero

    aws pinpoint send-messages --application-id AppID --message-request '{"MessageConfiguration": {"SMSMessage":{"Body":"This is a test message"}},"Addresses": {"DestinationPhoneNumber": {"ChannelType":"SMS"}}}‘
    Nel comando precedente, apporta le modifiche seguenti:

    • Sostituisci AppId con l'ID del progetto Amazon Pinpoint che contiene l'endpoint.

    • Sostituisci DestinationPhoneNumber con il numero di telefono a cui desideri inviare.

  • CLI send-messages di esempio: numero di origine a SMS

    aws pinpoint send-messages --application-id AppID --message-request '{"MessageConfiguration": {"SMSMessage":{"Body":"hello, how are you?","OriginationNumber": "OriginPhoneNumber"}},"Addresses": {"DestinationPhoneNumber": {"ChannelType":"SMS"}}}‘
    Nel comando precedente, apporta le modifiche seguenti:

    • Sostituisci AppId con l'ID del progetto Amazon Pinpoint che contiene l'endpoint.

    • Sostituiscilo OriginPhoneNumber con il numero di telefono da cui desideri inviare il messaggio.

    • Sostituisci DestinationPhoneNumber con il numero di telefono a cui desideri inviare.

  • CLI send-messages di esempio: SMS a un endpoint

    aws pinpoint send-messages —application-id AppID  —message-request '{"MessageConfiguration": {"SMSMessage":{"Body":"This is a test message"}},"Endpoints": {"EndPointId": {}}}'
    Nel comando precedente, apporta le modifiche seguenti:

    • Sostituisci AppId con l'ID del progetto Amazon Pinpoint che contiene l'endpoint.

    • Sostituiscilo EndPointId con l'ID di un endpoint esistente a cui stai inviando.

  • CLI send-messages di esempio: SMS a un ID utente

    aws pinpoint send-users-messages —application-id AppID —send-users-message-request '{"MessageConfiguration": {"SMSMessage":{"Body":"This is a test"}},"Users": {"UserId": {}}}'
    Nel comando precedente, apporta le modifiche seguenti:

    • Sostituisci AppId con l'ID del progetto Amazon Pinpoint che contiene l'endpoint.

    • Sostituisci UserId con l'ID dell'utente.

  • Creazione di campagne con Modelli di messaggio di Amazon Pinpoint: CLI create-campaign

    aws pinpoint create-campaign —application-id AppId —write-campaign-request file://campaignclirequest.json 

file://campaignclirequest.json 
{
	"Description": "CLITestCampaign",
	"HoldoutPercent": 0,
	"MessageConfiguration": 
	{
		"DefaultMessage": 
		{
			"Body": "TestFromCLI"
		}
	},
	"Name": "TestingCLICampaign",
	"Schedule": 
	{
		"StartTime": "IMMEDIATE"
	},
	"TemplateConfiguration": 
		{
		"EmailTemplate": 
			{
			"Name": "TemplateName",
			"Version": "Version"
			}
		},
	"SegmentId": "SegmentID",
	"SegmentVersion": 1
}
    Nel comando e nel file precedenti, apporta le modifiche seguenti:

    • Sostituisci AppId con l'ID del progetto Amazon Pinpoint che contiene l'endpoint.

    • Sostituisci TemplateName con il nome del modello.

    • Sostituisci Version con la versione del modello.

    • Sostituisci SegmentID con l'ID del segmento da scegliere come target.