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

Aviso de fim do suporte: em 30 de outubro de 2026, a AWS encerrará o suporte para o Amazon Pinpoint. Após 30 de outubro de 2026, você não poderá mais acessar o console do Amazon Pinpoint nem seus recursos (endpoints, segmentos, campanhas, jornadas e analytics). Para acessar mais informações, consulte Amazon Pinpoint end of support. Observação: as APIs relacionadas a SMS, voz, notificações push para dispositivos móveis, OTP e validação de número de telefone não são afetadas por essa alteração e são compatíveis com o AWS End User Messaging.

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.

Monitorar e registrar em log

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:

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

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

  • Obter dados do usuário: get-user-endpoints CLI

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

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

    • Substitua UserId pelo 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:

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

    • Substitua EndpointId pela ID de um endpoint existente que você está criando ou atualizando.

    • Substitua UserId pelo 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:

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

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

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

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

    • Substitua +12065550100 pelo número de telefone que 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:

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

    • Substitua DestinationPhoneNumber 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:

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

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

    • Substitua DestinationPhoneNumber 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:

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

    • Substitua EndpointId 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:

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

    • Substitua UserId pelo 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:

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

    • Substitua TemplateName pelo nome do modelo.

    • Substitua Version pela versão do modelo.

    • Substitua SegmentID pelo ID do segmento a ser direcionado.