**Aviso de fim do suporte:** em 30 de outubro de 2026, 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 obter mais informações, consulte [Fim do suporte do Amazon Pinpoint](https://docs.aws.amazon.com/console/pinpoint/migration-guide). **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á.
# Configurar o Postman para uso com o Amazon Pinpoint
Agora que você criou um usuário que pode acessar a API do Amazon Pinpoint, é possível configurar o Postman. Nesta seção, você cria um ou mais ambientes no Postman. Em seguida, importe uma coleção que contenha um modelo de solicitação para cada uma das operações na API do Amazon Pinpoint.
## Criar um espaço de trabalho do Postman
No Postman, um *espaço de trabalho* é um contêiner organizacional para projetos e ambientes. Nesta seção, você criará pelo menos um espaço de trabalho para usar com o Amazon Pinpoint.
**Criar um espaço de trabalho**
No Postman, vá até o campo de mais ações, escolha **Arquivo** e, depois, **Novo**.
1. Na janela **Criar novo**, escolha **Espaço de trabalho**.
1. Insira um nome, um resumo e defina a visibilidade como pessoal. Em seguida, escolha **Criar espaço de trabalho**.
## Criar ambientes do Postman
No Postman, um *ambiente* é um conjunto de variáveis que são armazenadas como pares de chave-valor. Você pode usar ambientes para alterar a configuração das solicitações feitas por meio do Postman, sem precisar alterar as próprias solicitações da API.
Nesta seção, você criará pelo menos um ambiente para usar com o Amazon Pinpoint. Cada ambiente que você cria contém um conjunto de variáveis que são específicas para sua conta em uma única Região da AWS. Se você usar os procedimentos nesta seção para criar mais de um ambiente, poderá alternar facilmente entre Regiões, escolhendo um ambiente diferente no menu **Ambiente** no Postman.
**Para criar um ambiente**
1. No Postman, vá até o menu de mais ações, escolha **Arquivo** e, depois, **Novo**.
1. Na janela **Create New (Criar novo)**, escolha **Environment (Ambiente)**.
1. Na janela **MANAGE ENVIRONMENTS (GERENCIAR AMBIENTES)**, de **Environment Name (Nome do ambiente)**, insira **Amazon Pinpoint - *Region Name***. *Region Name*Substitua por um dos seguintes valores:
+ Leste dos EUA (N. da Virgínia)
+ Oeste dos EUA (Oregon)
+ Ásia-Pacífico (Mumbai)
+ Ásia-Pacífico (Sydney)
+ Europa (Frankfurt)
+ Europa (Irlanda)
**nota**
No mínimo, você só precisa criar um ambiente para um único Região da AWS, que Região da AWS deve conter um projeto. Se você não criou um projeto em um dos listados anteriormente Regiões da AWS, consulte [Criação de um projeto do Amazon Pinpoint com suporte por e-mail](https://docs.aws.amazon.com/pinpoint/latest/userguide/channels-email-setup-create.html) no Guia do usuário do *Amazon Pinpoint*.
1. Crie seis novas variáveis: `endpoint`, `region`, `serviceName`, `accountId`, `accessKey` e `secretAccessKey`. Use a tabela a seguir para determinar qual valor inserir nas colunas **Valor inicial** e **Valor atual** para cada variável.
[\[See the AWS documentation website for more details\]](http://docs.aws.amazon.com/pt_br/pinpoint/latest/userguide/tutorials-using-postman-configuration.html)
Depois de criar essas variáveis, a janela **MANAGE ENVIRONMENTS (GERENCIAR AMBIENTES)** é semelhante ao exemplo mostrado na imagem a seguir.
![\[\]](http://docs.aws.amazon.com/pt_br/pinpoint/latest/userguide/images/Postman_Tutorial_2.1_4.png)
Ao concluir, escolha **Salvar**.
**Importante**
As chaves de acesso mostradas na imagem anterior são fictícias. Não compartilhe suas chaves de acesso do IAM com outras pessoas.
O Postman inclui recursos que permitem compartilhar e exportar ambientes. Se você usar esses recursos, tenha o cuidado de não compartilhar seu ID de chave de acesso e chave de acesso secreta com ninguém que não tenha acesso a essas credenciais.
Para obter mais informações, consulte [Práticas recomendadas do IAM](https://docs.aws.amazon.com/IAM/latest/UserGuide/best-practices.html) no *Guia do usuário do IAM*.
1. (Opcional) Repita as etapas de 1 a 4 para cada ambiente adicional que você deseja criar.
**dica**
No Postman, você pode criar quantos ambientes forem necessários. Você pode usar ambientes das seguintes maneiras:
Crie um ambiente separado para cada Região onde você precisa testar a API do Amazon Pinpoint.
Crie ambientes associados a diferentes Contas da AWS.
Crie ambientes que usam credenciais associadas a outro usuário.
1. Ao terminar de criar ambientes, vá para a próxima seção.
## Criar uma coleção do Amazon Pinpoint no Postman
No Postman, uma *coleção* é um grupo de solicitações de API. Solicitações em uma coleção geralmente são unidas por um propósito comum. Nesta seção, você criará uma coleção que contém um modelo de solicitação para cada operação na API do Amazon Pinpoint.
**Como criar a coleção do Amazon Pinpoint**
1. No Postman, vá até o menu de mais ações, escolha **Arquivo** e, depois, **Importar**.
1. Na janela **Importar, escolha Importar** **do link** e, em seguida, insira o seguinte 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.
Escolha **Importar**. O Postman importa a coleção do Amazon Pinpoint, que contém 120 solicitações de exemplo.
## Testar a configuração do Postman
Depois de importar a coleção do Amazon Pinpoint, recomenda-se um teste rápido para garantir que todos os componentes estejam configurados corretamente. Você pode testar sua configuração enviando uma solicitação `GetApps`. Essa solicitação retorna uma lista de todos os projetos existentes na sua conta do Amazon Pinpoint na Região da AWS atual. Como essa solicitação não exige nenhuma configuração adicional, trata-se de uma boa maneira de testar a configuração.
**Como testar a configuração da coleção do Amazon Pinpoint**
1. No painel de navegação à esquerda, selecione **Coleções**, expanda a coleção do **Amazon Pinpoint** e expanda a pasta **Aplicativos**.
1. Na lista de solicitações, escolha **GetApps**.
1. Use o seletor **Ambiente** para escolher o ambiente que você criou em [Criar ambientes do Postman](#tutorials-using-postman-configuration-create-environments).
1. Selecione **Enviar**. Se a solicitação for enviada com sucesso, o painel de resposta mostrará um status de `200 OK`. Você verá uma resposta que é semelhante ao exemplo na imagem a seguir.
![\[\]](http://docs.aws.amazon.com/pt_br/pinpoint/latest/userguide/images/Postman_Tutorial_2.3_3.png)
**nota**
Se você não tiver nenhum projeto criado no Região da AWS , o Amazon Pinpoint retornará. `{ "Item": [] }`
Essa resposta mostra uma lista de todos os projetos do Amazon Pinpoint que existem na sua conta na Região escolhida na etapa 3.
### Solução de problemas
Ao enviar sua solicitação, talvez você veja um erro. Consulte a lista a seguir para ver vários erros comuns que você pode encontrar e as etapas que você pode seguir para resolvê-los.
| Mensagem de erro | Problema | Resolução |
| --- | --- | --- |
| Could not get any response Houve um erro na conexão com https://%7B%7Bendpoint%7D%7D/v1/apps. | Não há um valor atual para a variável `{{endpoint}}`, que é definida quando você escolhe um ambiente. | Use o seletor de ambiente para escolher um ambiente. |
| O token de segurança incluído na solicitação é inválido. | O Postman não conseguiu encontrar o valor atual de seu ID de chave de acesso ou chave de acesso secreta. | Escolha o ícone de engrenagem perto do seletor de ambiente e escolha o ambiente atual. Certifique-se de que os valores `accessKey` e `secretAccessKey` apareçam nas colunas **VALOR INICIAL** e **VALOR ATUAL** e que você tenha inserido as credenciais corretamente. |
| “Mensagem”: “Usuário: arn:aws:iam: :123456789012:user/ não está autorizado a realizar: mobiletargeting: on resource: arn:aws:mobiletargeting:us-west- 2:123456789012PinpointPostmanUser: \$1” GetApps | A política do IAM associada ao seu usuário não incluem as permissões apropriadas. | Certifique-se de que seu usuário tenha as permissões descritas em [Criar uma política do IAM](tutorials-using-postman-iam-user.md#tutorials-using-postman-iam-user-create-policy) e que você forneceu as credenciais corretas ao criar o ambiente em [Criar um espaço de trabalho do Postman](#tutorials-using-postman-configuration-create-environments). |
**Próximo**: [Enviar solicitações adicionais](tutorials-using-postman-sample-requests.md)