Criar modelos de notificação por push

Um modelo de notificação por push é um modelo de mensagem que contém conteúdo e configurações que você pode usar com seus projetos do Amazon Pinpoint. Quando você usa um modelo para enviar uma notificação por push, o Amazon Pinpoint preenche a notificação com o conteúdo e as configurações definidos no modelo.

Ao criar um modelo de notificação por push, você especifica o conteúdo e as configurações que deseja reutilizar em vários componentes de notificações por push baseadas no modelo. Esses componentes, conhecidos como partes de modelo, podem conter texto (como o título ou o corpo de uma notificação) ou configurações (como um som personalizado para reproduzir quando um destinatário recebe uma notificação).

Para personalizar um modelo para canais específicos de notificação por push, você pode criar vários conjuntos de componentes de modelo em cada modelo: um conjunto padrão e, opcionalmente, um ou mais conjuntos específicos de serviços. O conjunto padrão contém o conteúdo e as configurações que você deseja usar por padrão para qualquer canal de notificação por push. Um conjunto específico do serviço contém todo o conteúdo e as configurações que você deseja usar para um serviço de notificação específico, como o Apple Push Notification service ou o Firebase Cloud Messaging. Ao adicionar configurações específicas do serviço a um modelo, você pode personalizar as notificações para exibir conteúdo exclusivo para cada tipo de dispositivo de um destinatário.

Você também pode criar modelos que contenham dados brutos de mensagens. Essa opção é mais avançada, mas é útil se você quiser especificar configurações para um canal específico que não estão presentes no modelo padrão de notificação por push do Amazon Pinpoint.

Criar um modelo de notificação por push padrão

Conclua esse procedimento se quiser especificar o conteúdo básico da mensagem, como título, corpo da mensagem, imagem e ação. Caso precise especificar o conteúdo bruto da mensagem, conclua o procedimento em Criar um modelo de notificação por push com os dados brutos da mensagem.

Para criar um modelo de notificação por push

1. Faça login no console do Amazon Pinpoint em https://console.aws.amazon.com/pinpoint/.

2. No painel de navegação, escolha Modelos de mensagem.

3. Selecione Criar modelo.

4. Em Canal, escolha Notificações push.

5. Em Detalhes do modelo, para Nome do modelo, insira um nome para o modelo. O nome deve começar com uma letra ou um número. Ele pode conter até 128 caracteres. Os caracteres podem ser letras, números, sublinhados (_) ou hifens (-).

6. (Opcional) Para Descrição da versão, insira uma breve descrição do modelo. A descrição pode conter até 500 caracteres.

7. Em Detalhes da notificação por push, faça o seguinte:

   • Em Tipo de notificação, escolha Mensagem padrão.

   • Em Título, insira o título que você deseja exibir acima do corpo da mensagem.

   • Em Corpo, insira o texto que deseja exibir no corpo da mensagem de notificação.

     dica

     Você pode incluir conteúdo personalizado no título e no corpo do modelo. Para fazer isso, adicione variáveis de mensagem que façam referência a atributos específicos, como um atributo que armazena o nome de um usuário. Ao usar variáveis de mensagem, é possível exibir conteúdos diferentes para cada destinatário de uma notificação por push que usa o modelo.

     Para usar uma variável de mensagem, escolha o nome de um atributo existente no Localizador de atributos. O Amazon Pinpoint cria uma variável de mensagem para o atributo e a copia para sua área de transferência. Cole a variável no local desejado. Para obter mais informações, consulte Adicionar conteúdo personalizado a modelos de mensagem.

   • Em Som de alerta personalizado, insira o nome do arquivo de áudio que contém o som personalizado que você deseja reproduzir quando um destinatário receber a notificação por push. Esse nome deve corresponder ao nome de um arquivo de áudio em um dispositivo do destinatário.

   • Em Ação, escolha o que você deseja que o dispositivo de um destinatário faça se o destinatário tocar na notificação por push:

     • Abra seu aplicativo: abra seu aplicativo ou leve-o para o primeiro plano se ele foi enviado para o plano de fundo.

     • Vá para um URL: abra o navegador padrão no dispositivo do destinatário e carregue uma página da web específica. Se você escolher essa opção, insira o URL da página da Web na caixa URL de destino.

     • Abra um link direto: abra o aplicativo e exiba uma interface de usuário específica nele. Se você escolher essa opção, insira o URL da interface na caixa URL de destino.

8. (Opcional) Para personalizar o modelo para canais de notificação por push específicos, escolha a guia de canal apropriada em Personalizar conteúdo para serviços de push individuais. Depois, escolha as opções que deseja para o serviço.

   Se você marcar a caixa de seleção Substituir conteúdo por push padrão em uma guia de serviço, o Amazon Pinpoint substituirá automaticamente o conteúdo padrão e as configurações escolhidas na etapa anterior pelas opções escolhidas na guia. Se você quiser manter o conteúdo e as configurações padrão e simplesmente personalizar o modelo para usar configurações específicas do canal adicionais, não marque essa caixa de seleção.

   Apple

   Utilize essas opções para especificar conteúdo personalizado e configurações para notificações por push enviadas por meio do canal do Apple Push Notification (APNs) para aplicativos em execução em dispositivos iOS.

   Além do conteúdo e das configurações padrão, você pode incluir uma imagem personalizada ou vídeo em notificações por push que usam o modelo. Para fazer isso, digite o URL do arquivo de imagem ou vídeo na caixa Mídia iOS. O URL deve ser acessível ao público. Caso contrário, o dispositivo do destinatário não poderá exibir a imagem ou o vídeo.

   Google

   Utilize essas opções para especificar conteúdo personalizado e configurações para notificações por push enviadas por meio do canal Google Firebase Cloud Messaging (FCM) para aplicativos em execução em dispositivos Android.

   Além do conteúdo e das configurações padrão, você pode escolher as seguintes opções para exibir imagens personalizadas em notificações por push que usam o modelo:

   • Imagem Android: digite o URL da imagem para exibir no corpo da notificação por push.

   • Ícone Android: digite o URL da imagem de ícone grande para exibir na visualização de conteúdo da notificação por push.

   • Ícone Android pequeno: digite o URL da imagem de ícone pequeno a ser exibida na barra de status e na visualização de conteúdo da notificação por push.

   Amazon

   Use essas opções para especificar conteúdo personalizado e configurações para notificações por push que você envia por meio do canal Amazon Device Messaging (ADM) para aplicativos que estão sendo executados em dispositivos Amazon, como tablets Kindle Fire.

   Além do conteúdo e das configurações padrão, você pode escolher as seguintes opções para exibir imagens personalizadas em notificações por push que usam o modelo:

   • Imagem Android: digite o URL da imagem para exibir no corpo da notificação por push.

   • Ícone Android: digite o URL da imagem de ícone grande para exibir na visualização de conteúdo da notificação por push.

   • Ícone Android pequeno: digite o URL da imagem de ícone pequeno a ser exibida na barra de status e na visualização de conteúdo da notificação por push.

   Baidu

   Use essas opções para especificar conteúdo personalizado e configurações para notificações por push enviadas pelo canal Baidu para aplicativos que usam a plataforma Baidu Cloud Push.

   Além do conteúdo e das configurações padrão, você pode escolher as seguintes opções para exibir imagens personalizadas em notificações por push que usam o modelo:

   • Imagem Android: digite o URL da imagem para exibir no corpo da notificação por push.

   • Ícone Android: digite o URL da imagem de ícone grande para exibir na visualização de conteúdo da notificação por push.

   • Ícone Android pequeno: digite o URL da imagem de ícone pequeno a ser exibida na barra de status e na visualização de conteúdo da notificação por push.

9. Se você tiver adicionado conteúdo personalizado ao modelo usando variáveis de mensagem, especifique um valor padrão para cada variável. Se fizer isso, o Amazon Pinpoint substituirá a variável pelo valor especificado, caso um valor correspondente não exista para um destinatário. Recomendamos que você faça isso para cada variável no modelo.

   Para especificar valores padrão para variáveis, expanda a seção Valores de atributo padrão. Depois, insira o valor padrão que deseja usar para cada variável. Se você não especificar um valor padrão e não existir um valor para o destinatário, o Amazon Pinpoint não enviará a mensagem.

10. Quando terminar de inserir conteúdo e configurações para o modelo, escolha Criar.

Criar um modelo de notificação por push com os dados brutos da mensagem

Conclua esse procedimento se quiser especificar manualmente a carga da mensagem bruta. Você só precisa especificar a carga bruta da mensagem se quiser usar um atributo de um serviço específico de notificação por push que o Amazon Pinpoint não permite que você configure. Se você não precisar especificar o conteúdo bruto da mensagem, conclua o procedimento em Criar um modelo de notificação por push padrão vez disso.

Um exemplo de caso de uso que exige o uso de um modelo de mensagem bruta é quando você deseja enviar mensagens aos usuários do navegador Safari para desktop. Nesse caso, você precisa incluir um atributo específico na carga da mensagem bruta. Para obter mais informações, consulte Enviar notificações por push no Safari.

Para criar um modelo de notificação por push

1. Faça login no console do Amazon Pinpoint em https://console.aws.amazon.com/pinpoint/.

2. No painel de navegação, escolha Modelos de mensagem.

3. Selecione Criar modelo.

4. Em Canal, escolha Notificações push.

5. Em Detalhes do modelo, para Nome do modelo, insira um nome para o modelo. O nome deve começar com uma letra ou um número. Ele pode conter até 128 caracteres. Os caracteres podem ser letras, números, sublinhados (_) ou hifens (-).

6. (Opcional) Para Descrição da versão, insira uma breve descrição do modelo. A descrição pode conter até 500 caracteres.

7. Em Detalhes da notificação por push, em Tipo de notificação, escolha Mensagem bruta. O editor de mensagens exibirá uma estrutura do código a ser usado para o modelo. No editor de mensagens, insira as configurações que deseja usar para cada serviço de notificação por push, incluindo quaisquer configurações opcionais, como imagens, sons e ações, que deseja especificar para o modelo. Para obter mais informações, consulte a documentação relativa aos serviços de notificação por push usados por você.

8. Quando terminar de inserir conteúdo para a mensagem bruta, escolha Criar.

Para testar o modelo antes de usá-lo em uma notificação por push enviada aos usuários, é possível enviar uma notificação de teste que usa o modelo. Ao fazer isso, primeiro conclua a etapa 10 para especificar valores padrão para todas as variáveis no modelo. Caso contrário, a notificação por push talvez não seja enviada ou processada corretamente.