

**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 a mensagem
<a name="campaigns-message"></a>

Depois de especificar o segmento de destino da campanha, você poderá configurar a mensagem para a campanha. 

Se você criou a campanha como padrão, configure uma única mensagem. Se você configurar a campanha como uma campanha A/B de teste, definirá dois ou mais *tratamentos*. Um *tratamento* é uma variação da sua mensagem que a campanha envia a partes diferentes da segmentação.

**Pré-requisito**  
Antes de começar, conclua [Especificar o público-alvo da campanha](campaigns-segment.md).

## Configurar a campanha
<a name="campaigns-message-channel"></a>

1. Se você criou essa campanha como uma campanha de A/B teste (em vez de uma campanha padrão), especifique a porcentagem de membros do segmento que devem receber cada tratamento. Uma campanha de A/B teste pode incluir até cinco tratamentos. Selecione **Adicionar outro tratamento** para continuar.

1. Na página **Create your message (Criar sua mensagem)**, configure a mensagem para a campanha. As opções de mensagem variam dependendo do canal escolhido para a campanha.

   Se você estiver criando uma campanha de e-mail, consulte [Configurar uma mensagem de e-mail](#campaigns-message-email).

   Se você estiver criando uma campanha no aplicativo, consulte [Configurar uma mensagem no aplicativo](#campaigns-message-inapp).

   Se você estiver criando uma campanha de SMS, consulte [Configurar uma mensagem SMS](#campaigns-message-sms).

   Se você estiver criando uma campanha de notificação por push, consulte [Configurar uma notificação por push](#campaigns-message-push).

   Se você estiver criando uma campanha que envia mensagens por meio de um canal personalizado, consulte [Configurar uma mensagem de canal personalizado](#campaigns-message-custom).

### Configurar uma mensagem de e-mail
<a name="campaigns-message-email"></a>

**Como configurar uma mensagem de e-mail**

1. Escolha o nível de prioridade da página **Criar mensagem** e siga um destes procedimentos:
   + Para criar e escrever uma mensagem para a campanha, selecione **Create a new email message (Criar uma mensagem de e-mail)**.
**nota**  
O tamanho máximo da mensagem de e-mail para **Criar uma nova mensagem** é de 200 KB. Você pode usar modelos de e-mail para enviar mensagens de e-mail maiores.
   + Para criar uma mensagem baseada em um modelo de e-mail:

     1. Selecione **Choose an existing email template (Escolher um modelo de e-mail existente)** e selecione **Choose a template (Escolher um modelo)**.

     1. Procure o modelo que você deseja usar. Quando você seleciona um modelo na lista, o Amazon Pinpoint exibe uma visualização da versão ativa do modelo. (A versão ativa geralmente é a versão de um modelo que foi revisada e aprovada para uso, dependendo do seu fluxo de trabalho.)

     1. Quando localizar o modelo desejado, selecione-o e selecione **Choose template (Escolher modelo)**.

     1. Em **Versão do modelo**, especifique se você deseja que o Amazon Pinpoint atualize automaticamente a mensagem para incluir todas as alterações que você pode fazer no modelo antes que a mensagem seja enviada. Para saber mais sobre essas opções, consulte [Gerenciar versões de modelos de mensagem](message-templates-versioning.md).

     1. Ao concluir a escolha das opções do modelo da mensagem, vá para a etapa 5.

1. Em **Subject (Assunto)**, insira a linha de assunto para a mensagem de e-mail.

1. Em **Message (Mensagem)**, insira o corpo do e-mail.
**dica**  
Você pode inserir o corpo do e-mail usando a visualização HTML ou Design. Na visualização HTML, você pode inserir manualmente o conteúdo HTML para o corpo do e-mail, incluindo recursos como formatação e links. No modo Design, você pode usar um editor de rich text com uma barra de ferramentas de formatação para aplicar recursos de formatação, como links. Para alternar as visualizações, escolha **HTML** ou **Design** no seletor de visualização acima do editor de mensagens.

1. 
**nota**  
Você deve configurar um perfil de envio de orquestração de e-mail antes de poder usar cabeçalhos de e-mail. Para obter mais informações, consulte [Criação de um perfil de envio de orquestração de e-mail no Amazon Pinpoint](channels-email-orchestration-sending-role.md).

   Em **Cabeçalhos**, escolha **Adicionar novos cabeçalhos** para adicionar até 15 cabeçalhos à mensagem de e-mail. Para obter uma lista de cabeçalhos compatíveis, consulte os [Amazon SES header fields](https://docs.aws.amazon.com/ses/latest/dg/header-fields.html) no [Guia do desenvolvedor do Amazon Simple Email Service](https://docs.aws.amazon.com/ses/latest/dg/Welcome.html).
   + Em **Nome**, insira o nome do cabeçalho.
   + Em **Valor**, insira o valor do cabeçalho.

   (Opcional) Para adicionar um link de cancelamento de inscrição com um clique a um e-mail promocional, adicione os dois cabeçalhos a seguir:

   1. Crie um cabeçalho com `List-Unsubscribe` no **Nome** e defina o **Valor** como seu link de cancelamento da assinatura. O link deve oferecer suporte a solicitações HTTP POST para processar a solicitação de cancelamento de assinatura do destinatário.

   1. Crie um cabeçalho com `List-Unsubscribe-Post` no **Nome** e defina o **Valor** como `List-Unsubscribe=One-Click`.

1. (Opcional) No campo abaixo do editor de mensagens, insira o conteúdo que deseja exibir no corpo das mensagens enviadas aos destinatários cujos aplicativos de e-mail não exibem HTML.

1. Se você criou essa campanha como uma campanha de A/B teste (em vez de uma campanha padrão), repita as etapas nesta seção para cada tratamento. Você pode alternar entre tratamentos usando as guias na parte superior da seção **Detalhes de e-mail**.

1. Em **Endereço de e-mail do remetente**, escolha o endereço de e-mail verificado usado para configurar o canal de e-mail.

1. Escolha para onde deseja enviar a mensagem de teste. Isso pode ser um segmento existente de até dez endereços de e-mail ou endpoint IDs.

1. Escolha **Próximo**.

### Configurar uma mensagem no aplicativo
<a name="campaigns-message-inapp"></a>

Use mensagens no aplicativo para enviar mensagens direcionadas aos usuários de seus aplicativos. As mensagens no aplicativo são altamente personalizáveis. Elas podem incluir botões que abrem sites ou levam os usuários a partes específicas do seu aplicativo. Você pode configurar as cores de fundo e do texto, posicionar o texto e adicionar imagens à notificação. Você pode enviar uma única mensagem ou criar um *carrossel* que contenha até cinco mensagens pelas quais os usuários possam passar.

Ao criar uma mensagem no aplicativo, é possível escolher criar uma campanha a partir de um modelo existente ou criar uma nova mensagem.

Se você optar por criar uma campanha de A/B testes, poderá aplicar um modelo diferente a cada tratamento. Uma campanha de A/B testes pode conter até cinco tratamentos diferentes.

1. Na página **Criar sua mensagem**, proceda de uma das seguintes maneiras:
   + Para criar uma nova mensagem para a campanha, selecione **Criar uma nova mensagem no aplicativo** e vá para a etapa 2.
   + Para criar uma mensagem com base em um modelo existente no aplicativo, faça o seguinte:

     1. Selecione **Escolher um modelo de mensagens no aplicativo existente**, e selecione **Escolher um modelo**.

     1. Selecione o modelo que deseja usar. Quando você seleciona um modelo na lista, o Amazon Pinpoint exibe uma visualização da versão ativa do modelo. A versão ativa geralmente é a versão de um modelo que foi revisada e aprovada para uso.

     1. Quando localizar o modelo desejado, selecione-o e clique em **Escolher modelo**.

     1. Em **Versão do modelo**, especifique se você deseja que o Amazon Pinpoint atualize automaticamente a mensagem para incluir todas as alterações feitas ao modelo antes que a mensagem seja enviada. Para saber mais sobre essas opções, consulte [Gerenciar versões de modelos de mensagem](message-templates-versioning.md).

     1. Ao concluir a escolha das opções do modelo da mensagem, vá para a etapa 11.

1. Na seção **Detalhes da mensagem no aplicativo**, em **Layout**, escolha o tipo de layout da mensagem. Você pode escolher entre as seguintes opções:
   + **Banner superior**: a mensagem exibida como um banner na parte superior da página.
   + **Banner inferior**: uma mensagem exibida como um banner na parte inferior da página.
   + **Banner central**: uma mensagem exibida como um banner no meio da página.
   + **Tela cheia**: uma mensagem que cobre toda a tela.
   + **Modal**: uma mensagem exibida em uma janela na frente da página.
   + **Carrossel**: um layout com rolagem de até cinco mensagens exclusivas.

1. Em **Cabeçalho**, configure o título que aparece no início da mensagem. Se você criou uma mensagem de carrossel, deverá criar a primeira mensagem para o carrossel, que inclui o cabeçalho.

   1. Para que o **Texto do cabeçalho** seja exibido no banner. Você pode inserir até 64 caracteres.

   1. Em **Cor do texto do cabeçalho**, escolha a cor do texto para o cabeçalho. Outra opção é inserir valores RGB ou um código de cor hexadecimal.

   1. Em **Alinhamento do cabeçalho**, escolha se você deseja que o texto seja justificado **à esquerda**, **ao centro** ou **à direita**.

1. Em **Mensagem**, configure o corpo da mensagem.

   1. Em **Mensagem**, insira o texto do corpo da mensagem. A mensagem pode conter até 150 caracteres.

   1. Em **Cor do texto**, escolha a cor do texto para o corpo da mensagem. Outra opção é inserir valores RGB ou um código de cor hexadecimal.

   1. Em **Alinhamento do texto**, escolha se você deseja que o texto seja justificado **à esquerda**, **ao centro** ou **à direita**.

1. (Opcional) Altere a cor de fundo da mensagem. Em **Plano de fundo**, escolha uma cor de fundo para a mensagem. Outra opção é inserir valores RGB ou um código de cor hexadecimal.

1. (Opcional) Adicione uma imagem à mensagem. Em **URL da imagem**, insira a URL da imagem que você deseja que apareça na mensagem. Somente arquivos .jpg e .png são aceitos. As dimensões da imagem dependem do tipo de mensagem:
   + Para um **Banner**, a imagem deve ter 100 pixels por 100 pixels, ou uma proporção de 1:1.
   + Para um **Carrossel**, a imagem deve ter 300 pixels por 200 pixels, ou uma proporção de 3:2.
   + Para uma mensagem **Tela cheia**, a imagem deve ter 300 pixels por 200 pixels, ou uma proporção de 3:2.

1. (Opcional) Adicione um botão à mensagem. Em **Botão principal**, faça o seguinte:

   1. Escolha **Adicionar botão principal**.

   1. Em **Texto do botão**, insira o texto a ser exibido no botão. Você pode inserir até 64 caracteres.

   1. (Opcional) Em **Cor do texto do botão**, escolha uma cor para o texto do botão. Outra opção é inserir valores RGB ou um código de cor hexadecimal.

   1. (Opcional) Em **Adicionar cor de fundo**, escolha uma cor de fundo para o botão. Outra opção é inserir valores RGB ou um código de cor hexadecimal.

   1. (Opcional) Em **Raio da borda**, insira um valor do raio. Valores mais baixos resultam em cantos mais retos, enquanto números maiores resultam em cantos mais arredondados. 

   1. Em **Ações**, escolha o evento que ocorre quando o usuário toca no botão:
      + **Fechar**: ignora a mensagem.
      + **Ir para o URL**: abre um site.
      + **Acessar link direto**: abre um aplicativo ou abre um local específico em um aplicativo. 

      Se você quiser que o comportamento do botão seja diferente para diferentes tipos de dispositivos, você pode substituir a ação padrão. Em **Ação**, use as guias para escolher o tipo de dispositivo para o qual você deseja modificar o comportamento do botão. Por exemplo, escolha **iOS** para modificar o comportamento do botão para dispositivos iOS. Em seguida, escolha **Substituir as ações padrão**. Por fim, especifique uma ação.

1. (Opcional) Adicione um botão secundário à mensagem. Em **Botão secundário**, escolha **Adicionar botão secundário**. Siga os procedimentos na etapa anterior para configurar o botão secundário.

1. (Opcional) Adicione dados personalizados à mensagem. Dados personalizados são pares de chave-valor entregues com sua mensagem. Por exemplo, pode ser que queira enviar um código promocional junto com sua mensagem. Se você estiver enviando uma mensagem de carrossel, poderá adicionar dados personalizados a cada uma das mensagens do carrossel. Para adicionar dados personalizados, faça o seguinte:

   1. Em **Dados personalizados**, escolha **Adicionar novo item**.

   1. Insira uma **Chave**. Por exemplo, pode ser {{PromoCode}}. 

   1. Insira um **Valor** para a chave. O seu {{PromoCode}} pode ser{{12345}}.

   1. Quando a mensagem é enviada, o código {{12345}} é incluído na sua mensagem.

   1. Para adicionar mais pares de chave-valor, escolha **Adicionar novo item**. É possível adicionar até 10 pares de chave-valor à mensagem. Quando terminar de adicionar dados personalizados, avance para a próxima etapa.

1. Se sua mensagem for um carrossel, você poderá adicionar até mais quatro mensagens exclusivas. Para adicionar mensagens a um carrossel, expanda a seção **Visão geral do carrossel**. Em seguida, escolha **Adicionar nova mensagem**. Repita as etapas anteriores para configurar a mensagem.

   Conforme você adiciona mensagens ao carrossel, a página de **Visualização** é atualizada, exibindo ícones na parte inferior da página e mostrando o número de mensagens incluídas no carrossel.

   A imagem a seguir mostra um carrossel com duas mensagens:  
![Um exemplo de carrossel mostrando dois itens de vestuário para compra.](http://docs.aws.amazon.com/pt_br/pinpoint/latest/userguide/images/channels-inapp-carousel.png)

1. (Opcional) Se você criou essa campanha como uma campanha de A/B teste (em vez de uma campanha padrão), repita as etapas nesta seção para cada tratamento. Você pode alternar entre tratamentos usando as guias na parte superior da seção **Modelo de mensagens no aplicativo**.

1. Escolha **Próximo**.

### Configurar uma mensagem SMS
<a name="campaigns-message-sms"></a>

**Importante**  
Se você envia mensagens SMS para destinatários na Índia usando um ID de remetente, precisará executar etapas adicionais. Para obter mais informações, consulte o [India sender ID registration process](https://docs.aws.amazon.com//sms-voice/latest/userguide/registrations-sms-senderid-india.html) no *Guia do usuário do AWS End User Messaging SMS*.

**Como configurar uma mensagem SMS**

1. Na página **Criar sua mensagem**, proceda de uma das seguintes maneiras:
   + Para criar e escrever uma mensagem para a campanha, selecione **Criar uma mensagem SMS** e vá para a etapa 2.
   + Para criar uma mensagem com base em um modelo SMS, faça o seguinte:

     1. Selecione **Choose an existing SMS template (Escolher um modelo SMS existente)**, e selecione **Choose a template (Escolher um modelo)**.

     1. Selecione o modelo que deseja usar. Quando você seleciona um modelo na lista, o Amazon Pinpoint exibe uma visualização da versão ativa do modelo. A versão ativa geralmente é a versão de um modelo que foi revisada e aprovada para uso.

     1. Quando localizar o modelo desejado, selecione-o e selecione **Choose template (Escolher modelo)**.

     1. Em **Versão do modelo**, especifique se você deseja que o Amazon Pinpoint atualize automaticamente a mensagem para incluir todas as alterações feitas ao modelo antes que a mensagem seja enviada. Para saber mais sobre essas opções, consulte [Gerenciar versões de modelos de mensagem](message-templates-versioning.md).

     1. Ao concluir a escolha das opções do modelo da mensagem, vá para a etapa 6.

1. Na seção **Configurações de SMS**, em **Tipo de mensagem**, escolha uma das seguintes opções:
   + **Promocional**: mensagens não essenciais, como mensagens de marketing.
   + **Transacional**: mensagens críticas que oferecem suporte a transações de clientes, como senhas de uso único para autenticação multifator.
**nota**  
Essa configuração em nível de campanha substitui o tipo de mensagem padrão que você define na página de configurações de SMS.

1. (Opcional) Para o **Número de telefone de origem**, selecione um número de telefone do qual enviar a mensagem. Essa lista contém todos os números de telefone dedicados associadas à sua conta. Se sua conta contiver vários números de telefone dedicados e você não escolher um número de origem, o Amazon Pinpoint procurará um código curto em sua conta; se encontrar um, ele usará esse código curto para enviar a mensagem. Se um código curto não for encontrado em sua conta, ele procurará um número 10DLC (somente para destinatários dos EUA), depois um número gratuito (somente para destinatários dos EUA) e, em seguida, um código longo.

1. (Opcional) Em **ID do remetente**, insira o ID alfanumérico do remetente que você deseja usar para enviar essa mensagem.
**Importante**  
O remetente só IDs é suportado em determinados países . Em alguns países, você deve registrar seu ID de remetente junto a entidades governamentais ou regulatórias antes de poder usá-lo. Especifique uma ID de remetente somente se você souber que o remetente IDs tem suporte nos países de seus destinatários. Para obter mais informações sobre a disponibilidade e os requisitos do ID de remetente, consulte [Supported countries and regions (SMS channel)](https://docs.aws.amazon.com//sms-voice/latest/userguide/phone-numbers-sms-by-country.html) no *Guia do usuário do AWS End User Messaging SMS*.

1. Em **Mensagem**, insira o corpo da mensagem.
**dica**  
As mensagens SMS podem conter um número limitado de caracteres. As mensagens longas são divididas em várias partes da mensagem, e você será cobrado separadamente por cada uma dessas partes. O número máximo de caracteres que você pode incluir depende dos caracteres usados nas mensagens. Para obter mais informações, consulte [SMS character limits](https://docs.aws.amazon.com//sms-voice/latest/userguide/sms-limitations-character.html) no *Guia do usuário do AWS End User Messaging SMS*.

1. (Opcional) Se você criou essa campanha como uma campanha de A/B teste (em vez de uma campanha padrão), repita as etapas nesta seção para cada tratamento. Você pode alternar entre tratamentos usando as guias na parte superior da seção **Detalhes de SMS**.

1. Escolha **Próximo**.

### Configurar uma notificação por push
<a name="campaigns-message-push"></a>

**Como configurar uma notificação por push**

1. Na página **Criar sua mensagem**, proceda de uma das seguintes maneiras:
   + Para criar e escrever uma mensagem para a campanha, selecione **Create a new push notification (Criar uma notificação por push)**.
   + Para criar uma mensagem baseada em um modelo de notificação por push: 

     1. Selecione **Choose an existing push notification template (Escolher um modelo de notificação por push existente)** e selecione **Choose a template (Escolher um modelo)**.

     1. Procure o modelo que você deseja usar. Quando você seleciona um modelo na lista, o Amazon Pinpoint exibe uma visualização da versão ativa do modelo. (A versão ativa geralmente é a versão de um modelo que foi revisada e aprovada para uso, dependendo de seu fluxo de trabalho.)

     1. Quando localizar o modelo desejado, selecione-o e selecione **Choose template (Escolher modelo)**.

     1. Em **Versão do modelo**, especifique se você deseja que o Amazon Pinpoint atualize automaticamente a mensagem para incluir todas as alterações que você pode fazer no modelo antes que a mensagem seja enviada. Para saber mais sobre essas opções, consulte [Gerenciar versões de modelos de mensagem](message-templates-versioning.md).

     1. Se você criou essa campanha como uma campanha de A/B teste (em vez de uma campanha padrão), repita as etapas nesta seção para cada tratamento. Você pode alternar entre tratamentos usando as guias na parte superior da seção **Detalhes da notificação push**.

     1. Ao terminar, escolha **Avançar**.

1. Em **Notification type (Tipo de notificação)**, especifique o tipo de mensagem que você deseja enviar:
   + **Notificação padrão**: uma notificação por push que tem um título, um corpo de mensagem e outros conteúdos e configurações. Os destinatários são alertados por seus dispositivos móveis quando recebem a mensagem.
   + **Notificação silenciosa**: um par atributo-valor JSON personalizado que o Amazon Pinpoint enviará ao aplicativo sem produzir notificações nos dispositivos dos destinatários. Use [notificações silenciosas](https://docs.aws.amazon.com/pinpoint/latest/apireference/apps-application-id-campaigns-campaign-id.html) para enviar dados que o aplicativo está programado para receber e processar. Por exemplo, você pode usar notificações silenciosas para atualizar a configuração do aplicativo ou exibir as mensagens em uma central de mensagens no aplicativo.
   + **Mensagem bruta**: uma notificação por push que especifica todo o conteúdo e configurações de uma notificação como um objeto JSON. Use mensagens brutas para casos como o envio de dados personalizados para um aplicativo para processamento por esse aplicativo, em vez do serviço de notificação por push.

     Se você escolher a opção **Raw message (Mensagem bruta)**, o editor de mensagens exibirá uma estrutura do código a ser usado para a mensagem. No editor de mensagens, insira o conteúdo e as configurações que você quer usar em cada serviço de notificação por push, incluindo quaisquer configurações opcionais, como imagens, sons e ações, que desejar especificar. Para obter mais informações, consulte a documentação relativa aos serviços de notificação por push usados por você. Depois de inserir todo o conteúdo bruto da mensagem, repita essa etapa para cada tratamento, se você criou essa campanha como uma campanha A/B de teste. Ao terminar, escolha **Avançar**.

#### Para criar uma notificação padrão
<a name="campaigns-message-push-standard"></a>

**Para criar uma notificação padrão**

1. Em **Title (Título)**, insira o título que você deseja exibir acima da mensagem.

1. Em **Body (Corpo)**, insira o corpo da mensagem. Suas notificações por push podem ter até 200 caracteres. Um contador de caracteres abaixo do campo faz uma contagem regressiva começando em 200 quando você adiciona caracteres à mensagem.

1. Em **Action (Ação)**, selecione a ação que você deseja que ocorra quando um destinatário tocar na notificação:
   + **Abrir o aplicativo**: o aplicativo é iniciado ou se torna o aplicativo em primeiro plano se tiver sido enviado para o segundo plano.
   + **Visitar um URL**: o navegador padrão do dispositivo móvel do destinatário é iniciado e abre uma página da web no URL especificado. Por exemplo, essa ação pode ser útil para levar os usuários a uma postagem de blog.
   + **Abrir um link direto**: seu aplicativo é aberto em uma página específica ou componente no aplicativo. Por exemplo, essa ação pode ser útil para direcionar os usuários a promoções especiais para compras dentro do aplicativo.

1. (Opcional) Em **Mídia URLs**, insira o URLs para todos os arquivos de mídia que você deseja exibir na notificação push. Eles URLs devem estar acessíveis ao público para que os serviços de notificação push para Android ou iOS possam recuperar as imagens.

1. Se você criou essa campanha como uma campanha de A/B teste (em vez de uma campanha padrão), repita as etapas nesta seção para cada tratamento. Você pode alternar entre tratamentos usando as guias na parte superior da seção **Detalhes da notificação push**.

1. Escolha **Próximo**.

#### Para criar uma notificação silenciosa
<a name="campaigns-message-push-silent"></a>

**Para criar uma notificação silenciosa**

1. Em **Message (Mensagem)**, insira o conteúdo da mensagem no formato JSON. O conteúdo exato da mensagem varia de acordo com o serviço de notificação que você usa e os valores que seu aplicativo espera receber.

1. Se você criou essa campanha como uma campanha de A/B teste (em vez de uma campanha padrão), repita as etapas nesta seção para cada tratamento. Você pode alternar entre tratamentos usando as guias na parte superior da seção **Detalhes da notificação push**.

1. Escolha **Próximo**.



### Configurar uma mensagem de canal personalizado
<a name="campaigns-message-custom"></a>

Esta seção contém informações sobre como configurar uma campanha para enviar mensagens usando um canal personalizado. É possível usar canais personalizados para enviar mensagens para seus clientes por meio de qualquer serviço que tenha uma funcionalidade de API ou webhook, incluindo serviços de terceiros. 

#### Enviar uma mensagem personalizada usando uma função do Lambda
<a name="campaigns-message-custom-lambda"></a>

Para enviar mensagens por meio de um serviço que tenha uma API, é necessário criar uma função do AWS Lambda que chame a API. Para obter mais informações sobre a criação dessas funções, consulte [Criação de canais personalizados](https://docs.aws.amazon.com/pinpoint/latest/developerguide/channels-custom.html) no *Guia do desenvolvedor do Amazon Pinpoint*.

**Como configurar um canal personalizado que usa uma função do Lambda para chamar uma API**

1. Na página **Criar sua mensagem**, em **Escolher o tipo de canal de mensagens personalizado**, escolha **Função do Lambda**.

1. Em **Função do Lambda**, escolha o nome da função do Lambda que deseja executar quando a campanha for veiculada.

1. Em **Opções de endpoint**, escolha os tipos de endpoint que você quer que o Amazon Pinpoint envie para a função do Lambda ou webhook associado ao canal personalizado.

    Por exemplo, se o segmento escolhido para esta campanha contiver vários tipos de endpoint, mas você quiser enviar a campanha somente para endpoints que tenham o atributo de tipo de endpoint Custom, escolha **Custom (Personalizado)**. Não é necessário escolher o tipo de endpoint Custom. Por exemplo, é possível optar por enviar a campanha de canal personalizado somente para endpoints com o atributo de tipo Email.

1. Escolha **Próximo**.

#### Enviar uma mensagem personalizada usando um webhook
<a name="campaigns-message-custom-webhook"></a>

Também é possível criar canais personalizados que enviam informações sobre os membros de seu segmento para serviços que usam webhooks.

**Como configurar um canal personalizado que usa webhooks**

1. Na página **Create your message (Criar sua mensagem)**, em **Choose your custom message channel type (Escolher o tipo de canal de mensagens personalizado)**, escolha **URL**.

1. Em **Inserir o URL do canal de mensagens personalizado**, insira o URL do webhook.

   O URL que você especificar deve começar com "https://." It can only contain alphanumeric characters, plus the following symbols: hyphen (-), period (.), underscore (\_), tilde (\~), question mark (?), slash or solidus (/), pound or hash sign (\#), and semicolon (;). The URL must comply with [RFC3986](https://datatracker.ietf.org/doc/html/rfc3986).

1. Em **Opções de endpoint**, escolha os tipos de endpoint que você quer que o Amazon Pinpoint envie para a função do Lambda. Por exemplo, se o segmento escolhido para esta campanha contiver vários tipos de endpoint, mas você quiser enviar a campanha somente para endpoints que tenham o recurso de tipo de endpoint "Personalizado", escolha **Personalizado**.

1. Escolha **Próximo**.

## Usar variáveis de mensagens
<a name="campaigns-message-variables"></a>

Para criar uma mensagem personalizada para cada destinatário, use *variáveis de mensagem*. As *variáveis de mensagens* se referem a recursos de usuário específicos. Esses atributos podem incluir características que você cria e armazena para usuários, como o nome, a cidade, o dispositivo ou o sistema operacional do usuário. Quando o Amazon Pinpoint envia a mensagem, ele substitui as variáveis pelos valores dos atributos correspondentes do destinatário. Para obter informações sobre os atributos que podem ser usados, consulte [Propriedades do endpoint](https://docs.aws.amazon.com/pinpoint/latest/apireference/apps-application-id-endpoints-endpoint-id.html#apps-application-id-endpoints-endpoint-id-properties) na *Referência de API do Amazon Pinpoint*.

Para incluir uma variável na mensagem, adicione o nome de um atributo existente à mensagem. Coloque o nome entre dois pares de chaves ({}) e use a capitalização exata do nome, por exemplo, `{{Demographic.AppVersion}}`.

Muitas vezes, os atributos mais úteis para variáveis de mensagem são atributos personalizados que você cria e armazena para os usuários. Ao usar atributos personalizados e variáveis, você pode enviar mensagens personalizadas que são exclusivas a cada destinatário.

Por exemplo, se tiver um aplicativo de fitness para corredores e ele incluir atributos personalizados para o nome, a atividade preferida e os recordes pessoais de cada usuário, você poderá usar a seguinte mensagem:

`Hey {{User.UserAttributes.FirstName}}, congratulations on your new {{User.UserAttributes.Activity}} record of {{User.UserAttributes.PersonalRecord}}!`

Quando o Amazon Pinpoint envia essa mensagem, o conteúdo varia para cada destinatário depois que as variáveis são substituídas. As possíveis mensagens finais são:

`Hi Jane Doe, congratulations on your new half marathon record of 1:42:17!`

Ou:

`Hi John Doe, congratulations on your new 5K record of 20:52!`

## Testar a mensagem
<a name="campaigns-message-test"></a>

O Amazon Pinpoint pode exibir a visualização de uma mensagem de e-mail antes de programar o envio da mensagem. Para e-mails e outros tipos de mensagens, você também pode enviar uma mensagem de teste para um pequeno grupo de destinatários para fins de teste. Você pode enviar mensagens de teste nos seguintes canais: e-mail, notificação por push, notificação no aplicativo ou SMS.

### Visualizar uma mensagem de e-mail sem enviá-la
<a name="campaigns-message-test-preview"></a>

A visualização Design no editor de mensagens do Amazon Pinpoint mostra uma visualização de uma mensagem de e-mail como se fosse renderizada por seu navegador da Web.

Se você estiver trabalhando na visualização HTML e não na visualização Design, será possível exibir uma pré-visualização de uma mensagem de e-mail ao lado do conteúdo HTML da mensagem. Esse recurso é útil quando você deseja verificar se uma mensagem está sendo renderizada como esperado, antes de enviar um teste. 

Observe que essa visualização mostra apenas como a mensagem seria exibida se fosse renderizada por seu navegador da Web. Como melhor prática, você ainda deve enviar e-mails de teste para vários destinatários e visualizar essas mensagens de teste usando uma variedade de dispositivos e clientes de e-mail.

**Para visualizar um e-mail**

1. Na área acima da visualização HTML do editor de mensagens, escolha **Sem visualização** e, depois, escolha **Visualização**. O Amazon Pinpoint exibe um painel de visualização ao lado do editor de HTML.

1. (Opcional) Para exibir o conteúdo HTML e a pré-visualização em uma janela maior, escolha **Fullscreen (Tela cheia)** na área acima do editor de mensagens.

### Enviar mensagem de teste
<a name="campaigns-message-test-send"></a>

Pode ser útil enviar uma mensagem de teste para destinatários reais para ter certeza de que sua mensagem é exibida corretamente quando seus clientes a recebem. Ao enviar uma versão de teste de uma mensagem, você pode testar melhorias incrementais no conteúdo e na aparência de sua mensagem sem afetar o status de sua campanha.

Quando você envia mensagens de teste, considere os seguintes fatores:
+ Você é cobrado pelo envio de mensagens de teste como se fossem mensagens da campanha regular. Por exemplo, se você enviar 10.000 e-mails de teste em um mês, será cobrada uma taxa de 1,00 USD para enviar os e-mails de teste. Para obter mais informações sobre a definição de preços, consulte [Definição de preços do Amazon Pinpoint](https://aws.amazon.com/pinpoint/pricing/).
+ As mensagens de teste são contabilizadas para as cotas de envio de sua conta. Por exemplo, se a sua conta está autorizada a enviar 10.000 e-mails por um período de 24 horas e você enviar 100 e-mails de teste, poderá enviar até 9.900 e-mails adicionais no mesmo período de 24 horas.
+ Quando você envia uma mensagem de teste para usuários específicos, pode especificar até 10 endereços. Use uma vírgula (,) para separar vários endereços.
**nota**  
A palavra "endereço" (usada nesta seção) pode fazer referência a qualquer um dos seguintes: um endereço de e-mail, número de telefone celular, um ID de endpoint ou um token de dispositivo.
+ Quando você envia uma mensagem SMS para testar números de telefone específicos, os números devem ser listados no formato E.164. Ou seja, eles devem incluir um caractere de mais (\+), o código do país sem um zero à esquerda e o número completo do assinante, incluindo o código de área. Por exemplo, \+12065550142. Os números no formato E.164 não devem conter parênteses, pontos, hífens ou qualquer outro símbolo que não seja o caractere de mais (\+). Os números de telefone E.164 podem ter um máximo de 15 dígitos.
+ Quando você envia uma notificação push de teste, os endereços devem ser tokens de endpoint IDs ou de dispositivo.
+ Quando você envia uma notificação de teste no aplicativo, a mensagem de teste só fica ativa por 30 minutos após o envio. Além disso, se você enviar várias mensagens de teste para o mesmo endpoint, a nova mensagem substituirá todas as mensagens anteriores. Por fim, quando você remove um endpoint de uma mensagem de teste, a mensagem não fica mais disponível para esse endpoint.
+ Quando você envia uma mensagem de teste para um segmento, só pode escolher um segmento. Além disso, você pode escolher apenas segmentos que contenham 100 endpoints ou menos.
+ Quando você envia uma mensagem de teste para um segmento, o Amazon Pinpoint cria uma campanha para esse teste. O nome da campanha contém a palavra "teste", seguida por quatro caracteres alfanuméricos aleatórios e seguidos pelo nome da campanha. Essas campanhas não são contabilizadas para o número máximo de campanhas ativas que sua conta pode conter. O Amazon Pinpoint não cria uma nova campanha quando você envia uma mensagem de teste para destinatários específicos.
+ Os eventos associados às mensagens de teste são contabilizados nas métricas da campanha pai. Por exemplo, o gráfico de **Endpoint deliveries (Resultados de endpoint)** na página de análise de **Campaigns (Campanhas)** inclui o número de mensagens de teste que foram entregues com êxito.

Há duas maneiras de enviar uma mensagem de teste. Você pode enviá-la para um segmento existente ou enviá-la para uma lista de endereços especificada. O método que você deve escolher depende do seu caso de uso. Por exemplo, se você tiver um grupo regular de pessoas para testar suas mensagens, pode ser útil criar um segmento contendo todos os seus endpoints. Se você precisa enviar mensagens de teste para um grupo de testadores que é alterado regularmente ou para um endereço gerado dinamicamente, é mais fácil especificar manualmente seus destinatários.

**Para enviar uma mensagem de teste para um segmento**

1. No editor de mensagens, escolha **Send a test message (Enviar uma mensagem de teste)**.

1. Na caixa de diálogo **Send a test message (Enviar uma mensagem de teste)**, em **Send a test message to (Enviar uma mensagem de teste para)**, selecione **A segment (Um segmento)**.

1. Use a lista suspensa para escolher o segmento para o qual você deseja enviar a mensagem de teste.
**nota**  
O Amazon Pinpoint exclui automaticamente todos os segmentos que contêm 100 endpoints ou mais dessa lista.

1. Escolha **Send Message (Enviar mensagem)**.

**Para enviar uma mensagem de teste para destinatários específicos**

1. No editor de mensagens, escolha **Send a test message (Enviar uma mensagem de teste)**.

1. Na caixa de diálogo **Send a test message (Enviar uma mensagem de teste)**, em **Send a test message to (Enviar uma mensagem de teste para)**, escolha uma das opções na tabela a seguir.    
[See the AWS documentation website for more details](http://docs.aws.amazon.com/pt_br/pinpoint/latest/userguide/campaigns-message.html)

1. Escolha **Send Message (Enviar mensagem)**.

**Próximo**  
[Programar a campanha](campaigns-schedule.md)