Solução de problemas - Amazon Pinpoint
Exemplos de tarefas comuns em CLI

Aviso de fim do suporte: em 30 de outubro de 2026, AWS encerrará o suporte para o Amazon Pinpoint. Depois de 30 de outubro de 2026, você não poderá mais acessar o console do Amazon Pinpoint ou os recursos do Amazon Pinpoint (endpoints, segmentos, campanhas, viagens e análises). Para obter mais informações, consulte Fim do suporte do Amazon Pinpoint. Observação: APIs relacionados a SMS, voz, push móvel, OTP e validação de número de telefone não são afetados por essa alteração e são compatíveis com o AWS End User Messaging.

As traduções são geradas por tradução automática. Em caso de conflito entre o conteúdo da tradução e da versão original em inglês, a versão em inglês prevalecerá.

Solução de problemas

nota

Os seguintes tópicos de solução de problemas foram movidos:

Familiarize-se com as informações de solução de problemas e possíveis soluções para ajudar a resolver problemas ao usar o Amazon Pinpoint.

Monitoramento e registro

Como prática recomendada, considere registrar eventos no Amazon Pinpoint da seguinte forma:

Exemplos de tarefas comuns em CLI

Os exemplos a seguir são comandos comuns da CLI para o Amazon Pinpoint.

  • Obter dados do endpoint: get-endpoint CLI

    aws pinpoint get-endpoint —application-id AppId —endpoint-id EndpointId
    No comando anterior, faça as seguintes alterações:

    • AppIdSubstitua pelo ID do projeto Amazon Pinpoint que contém o endpoint.

    • EndpointIdSubstitua pelo ID de um endpoint existente que você está recuperando.

  • Obter dados do usuário: get-user-endpointsCLI

    aws pinpoint get-user-endpoints —application-id AppId —user-id UserId
    No comando anterior, faça as seguintes alterações:

    • AppIdSubstitua pelo ID do projeto Amazon Pinpoint que contém o endpoint.

    • UserIdSubstitua pela ID do usuário.

  • Atualizar ou criar um novo endpoint: update-endpoint CLI

    aws pinpoint update-endpoint —application-id AppId —endpoint-id EndpointId —endpoint-request '{"ChannelType":"SMS","Address":"+12345678","Location":{"Country":"USA"},"User":{"UserId":"UserId"}}'
    No comando anterior, faça as seguintes alterações:

    • AppIdSubstitua pelo ID do projeto Amazon Pinpoint que contém o endpoint.

    • EndpointIdSubstitua pelo ID de um endpoint existente que você está criando ou atualizando.

    • UserIdSubstitua pela ID do usuário.

  • Excluir o endpoint: delete-endpoint CLI

    aws pinpoint delete-endpoint —application-id AppId —endpoint-id EndpointId
    No comando anterior, faça as seguintes alterações:

    • AppIdSubstitua pelo ID do projeto Amazon Pinpoint que contém o endpoint.

    • EndpointIdSubstitua pelo ID de um endpoint existente que você está excluindo.

  • Valide um número de telefone: CLI phone-number-validate

    aws pinpoint phone-number-validate —number-validate-request PhoneNumber=+12065550100
    No comando anterior, faça as seguintes alterações:

    • +12065550100Substitua pelo número de telefone que você deseja validar.

  • send-messages Exemplos CLI: SMS para um número

    aws pinpoint send-messages --application-id AppID --message-request '{"MessageConfiguration": {"SMSMessage":{"Body":"This is a test message"}},"Addresses": {"DestinationPhoneNumber": {"ChannelType":"SMS"}}}‘
    No comando anterior, faça as seguintes alterações:

    • AppIdSubstitua pelo ID do projeto Amazon Pinpoint que contém o endpoint.

    • DestinationPhoneNumberSubstitua pelo número de telefone para o qual você deseja enviar.

  • send-messages Exemplos CLI: número de origem para SMS

    aws pinpoint send-messages --application-id AppID --message-request '{"MessageConfiguration": {"SMSMessage":{"Body":"hello, how are you?","OriginationNumber": "OriginPhoneNumber"}},"Addresses": {"DestinationPhoneNumber": {"ChannelType":"SMS"}}}‘
    No comando anterior, faça as seguintes alterações:

    • AppIdSubstitua pelo ID do projeto Amazon Pinpoint que contém o endpoint.

    • OriginPhoneNumberSubstitua pelo número de telefone do qual você deseja enviar a mensagem.

    • DestinationPhoneNumberSubstitua pelo número de telefone para o qual você deseja enviar.

  • send-messages Exemplos CLI: SMS para um endpoint

    aws pinpoint send-messages —application-id AppID  —message-request '{"MessageConfiguration": {"SMSMessage":{"Body":"This is a test message"}},"Endpoints": {"EndPointId": {}}}'
    No comando anterior, faça as seguintes alterações:

    • AppIdSubstitua pelo ID do projeto Amazon Pinpoint que contém o endpoint.

    • EndPointIdSubstitua pelo ID de um endpoint existente para o qual você está enviando.

  • send-messages Exemplos CLI: SMS para um userId

    aws pinpoint send-users-messages —application-id AppID —send-users-message-request '{"MessageConfiguration": {"SMSMessage":{"Body":"This is a test"}},"Users": {"UserId": {}}}'
    No comando anterior, faça as seguintes alterações:

    • AppIdSubstitua pelo ID do projeto Amazon Pinpoint que contém o endpoint.

    • UserIdSubstitua pela ID do usuário.

  • Criar campanha com a CLI Modelos de mensagens do Amazon Pinpoint 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
}
    No comando e arquivo anterior, faça as seguintes alterações:

    • AppIdSubstitua pelo ID do projeto Amazon Pinpoint que contém o endpoint.

    • TemplateNameSubstitua pelo nome do modelo.

    • VersionSubstitua pela versão do modelo.

    • SegmentIDSubstitua pela ID do segmento a ser segmentado.