**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á.
# Tutorial: como usar o Postman com a API do Amazon Pinpoint
O Postman é uma ferramenta popular para testes APIs em um ambiente easy-to-use gráfico. Você pode usar o Postman para enviar solicitações de API para qualquer API REST e para receber respostas para suas solicitações. Usar o Postman é uma maneira conveniente de testar e solucionar problemas em chamadas feitas para a API do Amazon Pinpoint. Este tutorial inclui procedimentos para configurar e usar o Postman com o Amazon Pinpoint.
**nota**
O Postman foi desenvolvido por uma empresa terceirizada. Não é compatível e não é desenvolvido pela Amazon Web Services (AWS). Para saber mais sobre como usar o Postman ou obter assistência para problemas relacionados, consulte o [Centro de suporte](https://support.postman.com/hc/en-us) no site do Postman.
## Sobre este tutorial
Esta seção contém uma visão geral deste tutorial.
**Público-alvo**
Este tutorial é destinado a desenvolvedores e implementadores de sistemas. Você não precisa estar familiarizado com o Amazon Pinpoint nem com o Postman para concluir as etapas deste tutorial. É necessário saber gerenciar as políticas do IAM e modificar exemplos de código JSON.
Os procedimentos neste tutorial foram criados para impedir que novos usuários utilizem operações de API que possam excluir permanentemente recursos do Amazon Pinpoint. Os usuários avançados podem remover essa restrição modificando a política que está associada aos seus usuários do .
**Atributos usados**
Este tutorial inclui exemplos de uso para o seguinte recurso do Amazon Pinpoint:
+ Interação com a API do Amazon Pinpoint usando o Postman
**Tempo necessário**
Ele levará aproximadamente 15 minutos para ser concluído.
**Restrições regionais**
Não há restrições regionais associadas ao uso desta solução.
**Custos pelo uso de recursos**
Não há cobrança pela criação de uma AWS conta. No entanto, ao implementar essa solução, você poderá incorrer em custos de AWS uso se usar o Postman para fazer o seguinte:
+ Enviar e-mail, SMS ou mensagens de voz ou por push para dispositivos móveis
+ Criar e enviar campanhas
+ Usar o recurso de validação de número de telefone
Para obter mais informações sobre as cobranças associadas ao uso do Amazon Pinpoint, consulte [Definição de preços do Amazon Pinpoint](https://aws.amazon.com/pinpoint/pricing/).
# Pré-requisitos para usar o Postman com o Amazon Pinpoint
Antes de começar este tutorial, conclua os seguintes pré-requisitos:
+ Você deve ter uma conta da AWS. Para criar uma conta da AWS, acesse [https://console.aws.amazon.com/](https://console.aws.amazon.com/) e escolha **Criar uma nova conta da AWS**.
+ Certifique-se de que a conta que você usa para entrar no Console de gerenciamento da AWS possa criar novas políticas e perfis do IAM.
+ Certifique-se de ter criado pelo menos um projeto de amostra que tenha o e-mail ativado e uma identidade de e-mail verificada. Consulte [Criação de um projeto do Amazon Pinpoint com suporte a e-mail](https://docs.aws.amazon.com/pinpoint/latest/userguide/channels-email-setup-create.html) no *Guia do usuário do Amazon Pinpoint*.
+ Verifique se você tem um ID de conta da AWS. O ID da conta da AWS pode ser encontrado no canto superior direito do console ou usando a interface de linha de comandos (CLI). Consulte [Como encontrar o ID da conta da AWS](https://docs.aws.amazon.com/accounts/latest/reference/manage-acct-identifiers.html#FindAccountId).
+ É preciso baixar e instalar o Postman no computador. Você pode baixar o Postman no [site do Postman](https://www.getpostman.com).
+ Depois de instalar o Postman no computador, você deve criar uma conta nele. Quando você inicia o aplicativo do Postman pela primeira vez, é solicitado que você faça login ou crie uma conta. Siga as instruções fornecidas pelo Postman para fazer login em sua conta ou criar uma se ainda não tiver.
**Próximo**: [criar políticas e perfis do IAM](tutorials-using-postman-iam-user.md)
# Criar perfis e políticas do IAM para uso com o Amazon Pinpoint
Quando você usa o Postman para testar a API do Amazon Pinpoint, a primeira etapa é criar um usuário. Nesta seção, você cria uma política que permite que os usuários interajam com todos os recursos do Amazon Pinpoint. Depois, você cria um usuário e anexa a política diretamente a ele.
## Criar uma política do IAM.
Saiba como criar uma política do IAM. Usuários e funções que usam essa política podem interagir com todos os recursos na API do Amazon Pinpoint. Ele também fornece acesso a recursos associados à API de e-mail do Amazon Pinpoint, bem como à API de SMS e voz do Amazon Pinpoint.
**Para criar a política**
1. Faça login no Console de gerenciamento da AWS e abra o console do IAM em [https://console.aws.amazon.com/iam/](https://console.aws.amazon.com/iam/).
1. No painel de navegação, selecione **Políticas** e, em seguida, **Criar política**.
1. Na seção **Editor de políticas**, escolha **JSON**. Exclua qualquer JSON atual no **Editor de políticas** para que fique em branco. Copie e cole o seguinte JSON no editor de **políticas e, em seguida, no editor** de **políticas**, substitua todas as instâncias de *123456789012* pelo seu Conta da AWS ID.
Seu Conta da AWS ID pode ser encontrado no canto superior direito do console, ou você pode usar a CLI, consulte [Encontrando o ID da sua AWS conta](https://docs.aws.amazon.com/accounts/latest/reference/manage-acct-identifiers.html#FindAccountId).
**nota**
Para proteger os dados na sua conta do Amazon Pinpoint, essa política inclui apenas permissões de leitura, criação e modificação de recursos. Ela não inclui permissões que permitem excluir recursos. Você pode modificar essa política usando o editor visual no console do IAM. Para obter mais informações, consulte [Gerenciar políticas do IAM](https://docs.aws.amazon.com/IAM/latest/UserGuide/access_policies_manage.html) no Guia do usuário do IAM. Você também pode usar a [CreatePolicyVersion](https://docs.aws.amazon.com/IAM/latest/APIReference/API_CreatePolicyVersion.html)operação na API do IAM para atualizar essa política.
Além disso, essa política inclui permissões para a interação com os serviços `ses` e `sms-voice`, além do serviço `mobiletargeting`. As permissões `ses` e `sms-voice` permitem que você interaja com a API de e-mail do Amazon Pinpoint e a API de SMS e voz do Amazon Pinpoint, respectivamente. As permissões `mobiletargeting` permitem que você interaja com a API do 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": "*"
}
]
}
```
------
Escolha **Próximo**.
1. Em **Nome da política**, insira um nome para a política, como **PostmanAccessPolicy**. Selecione **Criar política**.
1. (Opcional) Você pode adicionar tags à política selecionando **Adicionar tag**.
1. Escolha **Próximo: revisar**.
## Criar um usuário do IAM
**Atenção**
Os usuários do IAM têm credenciais de longo prazo, o que representa um risco de segurança. Para ajudar a reduzir esse risco, recomendamos que você forneça a esses usuários somente as permissões necessárias para realizar a tarefa e que você os remova quando não forem mais necessários.
Depois de criar a política, você pode criar um usuário e anexar a política a ele. Ao criar o usuário, o IAM fornece um conjunto de credenciais que permitem que o Postman execute operações da API do Amazon Pinpoint.
**Para criar o usuário**
1. Abra o console do IAM em [https://console.aws.amazon.com/iam/](https://console.aws.amazon.com/iam/).
1. No console do IAM, no painel de navegação, selecione **Usuários** e, depois, **Criar usuários**.
1. Em **Detalhes do usuário**, em **Nome do usuário**, insira um nome que identifique o usuário, como **PostmanUser**. Escolha **Próximo**.
1. Em **Definir permissões**, em **Opções de permissões**, escolha **Anexar políticas diretamente**.
1. Em **Políticas de permissões**, escolha a política (**PostmanAccessPolicy**) que você criou em [Criar uma política do IAM](#tutorials-using-postman-iam-user-create-policy). Escolha **Próximo**.
1. Na página **Revisar e criar**, você tem a opção de adicionar tags que ajudam a identificar o usuário. Para obter mais informações sobre o uso de tags, consulte [Marcar recursos do IAM](https://docs.aws.amazon.com/IAM/latest/UserGuide/id_tags.html) no *Guia do usuário do IAM*.
1. Quando você estiver pronto para criar o usuário, escolha **Create user (Criar usuário)**.
## Criar chaves de acesso
**Atenção**
Este cenário precisa de usuários do IAM com acesso programático e credenciais de longo prazo, o que representa um risco de segurança. Para ajudar a reduzir esse risco, recomendamos que você forneça a esses usuários somente as permissões necessárias para realizar a tarefa e que você os remova quando não forem mais necessários. As chaves de acesso podem ser atualizadas, se necessário. Para obter mais informações, consulte [Atualizar chaves de acesso](https://docs.aws.amazon.com/IAM/latest/UserGuide/id-credentials-access-keys-update.html) no *Guia do usuário do IAM*.
O IAM fornece um conjunto de credenciais que você pode usar para permitir que o Postman realize operações de API do Amazon Pinpoint.
**Para criar o usuário**
1. Abra o console do IAM em [https://console.aws.amazon.com/iam/](https://console.aws.amazon.com/iam/).
1. No painel de navegação do console do IAM, selecione **Usuários**. Selecione o usuário (**PostmanUser**) criado em [Criar um usuário do IAM](#tutorials-using-postman-iam-user-create-user) e, em seguida, selecione a guia **Credenciais de segurança**.
1. Na seção **Chaves de acesso**, escolha **Criar chave de acesso**.
1. Na página **Práticas recomendadas e alternativas para chaves de acesso**, selecione **Aplicação executada fora da AWS**.
Escolha **Próximo**.
1. (Opcional) Você pode adicionar uma tag de descrição à política.
1. Selecione **Create access key (Criar chave de acesso)**.
1. Na página **Recuperar chaves de acesso**, copie as credenciais mostradas nas colunas **ID de chave de acesso** e **(Chave de acesso secreta)**.
**nota**
Será necessário fornecer o ID de chave de acesso e a chave de acesso secreta posteriormente neste tutorial. Esta é a única vez que você poderá visualizar a chave de acesso secreta. Recomendamos que você copie e salve-a em um local seguro.
1. Depois de salvar as duas chaves, escolha **Concluído**.
**Próximo**: [Configurar o Postman](tutorials-using-postman-configuration.md)
# 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)
# Enviar solicitações para a API do Amazon Pinpoint
Ao terminar de configurar e testar o Postman, você poderá começar a enviar solicitações adicionais para a API do Amazon Pinpoint. Esta seção inclui informações que você precisa saber antes de iniciar o envio de solicitações. Isso também inclui dois exemplos de solicitações que descrevem como usar a coleção Amazon Pinpoint.
**Importante**
Ao concluir os procedimentos desta seção, você enviará solicitações para a API do Amazon Pinpoint. Essas solicitações criam recursos em sua conta do Amazon Pinpoint, modificam recursos existentes, enviam mensagens, alteram a configuração de seus projetos do Amazon Pinpoint e usam outros recursos do Amazon Pinpoint. Tenha cuidado ao executar essas solicitações.
## Exemplos na coleção do Amazon Pinpoint Postman
Você precisa configurar a maioria das operações na coleção do Amazon Pinpoint Postman para usá-las. Para as operações `GET` e `DELETE`, normalmente, você só precisa modificar as variáveis definidas na guia **Pre-request Script (Script de pré-solicitação)**.
**nota**
Ao usar a política do IAM que é mostrada em [Criar uma política do IAM](tutorials-using-postman-iam-user.md#tutorials-using-postman-iam-user-create-policy), você não pode executar nenhuma das solicitações `DELETE` incluídas nesta coleção.
Por exemplo, a operação `GetCampaign` exige que você especifique um `projectId` e um `campaignId`. Na guia **Pre-request Script (Script de pré-solicitação)**, essas variáveis estão presentes e são preenchidas com valores de exemplo. Exclua os valores de exemplo e substitua-os pelos valores apropriados para a campanha e o projeto do Amazon Pinpoint.
Dessas variáveis, a mais comumente usada é a variável `projectId`. O valor dessa variável deve ser o identificador exclusivo para o projeto ao qual sua solicitação se aplica. Para obter uma lista desses identificadores para seus projetos, consulte a resposta à solicitação `GetApps` que você enviou na etapa anterior deste tutorial. Nessa resposta, o campo `Id` fornece o identificador exclusivo de um projeto. Para saber mais sobre a operação `GetApps` e o significado de cada campo na resposta, consulte [Aplicativos](https://docs.aws.amazon.com/pinpoint/latest/apireference/apps.html) na *Referência de API do Amazon Pinpoint*.
**nota**
No Amazon Pinpoint, um “projeto” é o mesmo que um “app” ou “aplicativo”.
Para as operações `POST` e `PUT`, você também precisa modificar o corpo da solicitação para incluir os valores que você deseja enviar para a API. Por exemplo, quando envia uma solicitação `CreateApp`, que é uma solicitação `POST`, é necessário especificar um nome para o projeto que você criar. É possível modificar a solicitação na guia **Body (Corpo)**. Neste exemplo, substitua o valor ao lado de `"Name"` pelo nome do projeto. Se quiser adicionar tags ao projeto, especifique-os no objeto `tags`. Ou, se não desejar adicionar tags, exclua todo o objeto `tags`.
**nota**
A operação `UntagResource` também exige que você especifique parâmetros de URL. Você pode especificar esses parâmetros na guia **Params (Parâmetros)**. Substitua os valores na coluna **VALUE (Valor)** pelas tags que você deseja excluir para o recurso especificado.
## Exemplo de solicitação: criar um projeto com a operação `CreateApp`
Antes de criar segmentos e campanhas no Amazon Pinpoint, primeiro você precisa criar um projeto. No Amazon Pinpoint, um *projeto* consiste em segmentos, campanhas, configurações e dados unidos por um propósito comum. Por exemplo, você pode usar um projeto para conter todo o conteúdo relacionado a um determinado aplicativo ou a uma marca ou iniciativa de marketing específica. Quando você adiciona informações do cliente ao Amazon Pinpoint, essas informações são associadas a um projeto.
**Para criar um projeto enviando uma solicitação de CreateApp API**
1. No menu **Ambientes**, escolha Região da AWS aquele em que você deseja criar o projeto.
![\[\]](http://docs.aws.amazon.com/pt_br/pinpoint/latest/userguide/images/Postman_Tutorial_Environments.png)
Neste exemplo, o Postman foi configurado para que o menu **Environments (Ambientes)** mostre as quatro opções a seguir:
+ Leste dos EUA (N. da Virgínia)
+ Oeste dos EUA (Oregon)
+ Europa (Frankfurt)
+ Europa (Irlanda)
1. Na pasta **Apps**, escolha a **CreateApp**operação>.
![\[\]](http://docs.aws.amazon.com/pt_br/pinpoint/latest/userguide/images/Postman_Tutorial_3.2_2.png)
A pasta **Aplicativos** na coleção Amazon Pinpoint Postman foi expandida e mostra as seguintes solicitações:
+ `GetApp`
+ `GetApps`
+ `CreateApp`
+ `DeleteApp`
1. Na guia **Body (Corpo)**, ao lado de `"Name"`, substitua o valor do espaço reservado (`"string"`) por um nome para a campanha, como **"MySampleProject"**.
1. Exclua a vírgula depois do nome da campanha e, depois, exclua o objeto `tags` inteiro nas linhas de 3 a 5. Ao terminar, sua solicitação deverá se parecer com o exemplo mostrado no trecho de código a seguir.
```
{
"Name": "MySampleProject"
}
```
O Postman é configurado para enviar a solicitação como uma carga JSON bruta.
1. Selecione **Enviar**. Se a campanha for criada com êxito, o painel de resposta mostrará o status `201 Created`.
```
{
"Name": "MySampleProject"
"Id": "12345678901234567890123456789012",
"Arn": "arn:aws:mobiletargeting:us-east-1:123456789012:apps/12345678901234567890123456789012",
"tags": {}
}
```
## Exemplo: enviar um e-mail usando a operação `SendMessages`
É muito comum usar a API `SendMessages` do Amazon Pinpoint para enviar mensagens transacionais. Uma vantagem de enviar mensagens usando a API `SendMessages` em vez de criar campanhas é que você pode usar a API para enviar mensagens para qualquer endereço, como um endereço de e-mail, número de telefone ou token de dispositivo. O endereço para o qual você enviar mensagens não precisa existir em sua conta do Amazon Pinpoint. Compare esse método com o envio de mensagens por meio da criação de campanhas. Antes de enviar uma campanha no Amazon Pinpoint, você deve adicionar endpoints à sua conta do Amazon Pinpoint, criar segmentos, criar a campanha e realizar a campanha.
O exemplo nesta seção mostra como enviar uma mensagem de e-mail transacional diretamente para um determinado endereço de e-mail. Você pode modificar essa solicitação para enviar mensagens por meio de outros canais, como SMS, push ou voz para dispositivos móveis.
**Para enviar uma mensagem de e-mail enviando uma SendMessages solicitação**
1. Verifique se o canal de e-mail está habilitado para o projeto e se o endereço de e-mail ou domínio que você deseja usar para enviar e receber a mensagem está configurado. Para obter mais informações, consulte [Ativação e desativação do canal de e-mail](pinpoint/latest/userguide/channels-email-setup.html) e [Verificação de identidades de e-mail](https://docs.aws.amazon.com/pinpoint/latest/userguide/channels-email-manage-verify.html) no *Guia do usuário do Amazon Pinpoint*.
**nota**
Para concluir o procedimento desta seção, você precisa verificar um endereço de e-mail
1. No menu **Ambientes**, escolha Região da AWS aquele do qual você deseja enviar a mensagem.
Neste exemplo, o Postman foi configurado para que o menu **Environments (Ambientes)** mostre as quatro opções a seguir:
+ Leste dos EUA (N. da Virgínia)
+ Oeste dos EUA (Oregon)
+ Europa (Frankfurt)
+ Europa (Irlanda)
1. Na pasta **Mensagens**, escolha a **SendMessages**operação.
![\[\]](http://docs.aws.amazon.com/pt_br/pinpoint/latest/userguide/images/Postman_Tutorial_3.3_3.png)
1. Na guia **Pre-request Script (Script de pré-solicitação)**, substitua o valor da variável `projectId` pelo ID de um projeto que já existe na região que você selecionou na etapa 2 desta seção.
1. Na guia **Body (Corpo)**, exclua a solicitação de exemplo que é mostrada no editor de solicitações. Cole o seguinte código:
```
{
"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. No código anterior, substitua pelo seu endereço *sender@example.com* de e-mail verificado. *recipient@example.com*Substitua pelo endereço de e-mail verificado para o qual você deseja enviar a mensagem.
**nota**
Se sua conta ainda estiver na sandbox de e-mails do Amazon Pinpoint, você só poderá enviar e-mails de endereços ou domínios verificados na sua conta do Amazon Pinpoint. Para obter mais informações sobre como remover a conta da sandbox, consulte [Solicitar acesso de produção para e-mail no](https://docs.aws.amazon.com/pinpoint/latest/userguide/channels-email-setup-production-access.html) no *Guia do usuário do Amazon Pinpoint*.
1. Selecione **Enviar**. Se a mensagem for enviada com êxito, o painel de respostas mostrará o status `200 OK`.
```
{
"ApplicationId": "12345678901234567890123456789012",
"RequestId": "",
"Result": {
"recipient@example.com": {
"DeliveryStatus": "SUCCESSFUL",
"StatusCode": 200,
"StatusMessage": "",
"MessageId": ""
}
}
}
```