Mobile Platform as a Service:Criar um modelo

Um modelo de mensagem consiste em corpo, placeholders e outros atributos. Os placeholders permitem adicionar conteúdo dinâmico. Não é possível enviar mensagens push personalizadas com modelos sem placeholders.

Os modelos tornam a configuração de mensagens mais flexível e reduzem a entrada repetitiva de dados. Eles são obrigatórios para envios por modelo, envios em lote e transmissões.

Esta seção descreve como configurar um modelo de push. Ao configurar o modelo, use o formato #nome_do_placeholder# para marcar o conteúdo dinâmico. É possível usar placeholders no Template title, no body e na redirection URL.

Procedimento

1. Faça login no console do mPaaS, selecione seu aplicativo e acesse a página Message Push Service > Message templates.

2. No painel à direita, clique em Create template e configure as informações do modelo na janela pop-up exibida. A tabela a seguir descreve os parâmetros relacionados.

   Parâmetro	Obrigatório	Descrição
   Nome do modelo	Sim	Nome do modelo criado no console. Deve ter entre 1 e 200 caracteres e pode conter letras, dígitos e sublinhados (_). O nome deve ser único, pois identifica o modelo em chamadas de API. Nota O nome do modelo não pode conter vírgulas.
   Descrição	Sim	Descrição do modelo. Deve ter entre 1 e 200 caracteres e pode conter letras, números e sublinhados (_).
   Título do modelo	Sim	Título do modelo. Deve ter entre 1 e 200 caracteres.
   Corpo do modelo	Sim	Corpo do modelo. O texto deve ter entre 1 e 200 caracteres.
   Tipo de mensagem: mensagem silenciosa	Sim	Define se a mensagem será exibida: Sim: A mensagem não será exibida no dispositivo de destino e permanecerá invisível para o usuário. Não: A mensagem aparecerá na barra de notificações. Para dispositivos Android, as operações variam conforme o canal de push selecionado: Canal MPS: Este parâmetro é enviado ao cliente como campo de referência. Analise o corpo da mensagem para obter o conteúdo desse campo e controlar a exibição. Canal do fabricante: Este parâmetro chega ao dispositivo de destino como um campo. O sistema do fabricante analisa o conteúdo e controla a exibição automaticamente, sem necessidade de operações adicionais. Em dispositivos iOS, o sistema do fabricante controla a exibição das mensagens. Nenhuma operação extra é necessária.
   Estilo de exibição	Sim	Define como a mensagem aparece no cliente. Escolha uma das três opções: Padrão (texto curto), Texto grande ou Texto rico. Padrão: Ideal para mensagens com conteúdo conciso e claro, contendo apenas título e texto. Recomenda-se limitar o texto a 100 caracteres, incluindo parâmetros personalizados e símbolos. Texto grande: Adequado para textos longos, como notícias e informativos, permitindo que o usuário obtenha informações rapidamente sem abrir o aplicativo. Contém apenas título e texto. Mantenha o limite de 256 caracteres, incluindo parâmetros personalizados e símbolos. Texto rico: Suporta ícones e imagens, sendo indicado para conteúdos variados. Para garantir uma boa apresentação, mantenha o texto em até duas linhas.
   Ícone	Não	Ícone exibido à direita da mensagem, nos formatos JPG, JPEG ou PNG. Insira a URL publicamente acessível do ícone. Se você fornecer apenas a URL do ícone padrão sem enviar materiais para os canais de terceiros correspondentes, o ícone padrão será baixado e usado automaticamente nas mensagens enviadas por esses canais. Como cada canal possui requisitos distintos para o material do ícone, recomenda-se enviar o arquivo individualmente para cada canal de terceiros, respeitando suas especificações. Ícone padrão: Tamanho sugerido de 140 * 140px, sem exceder 50 KB. Ícone OPPO: Tamanho sugerido de 140 * 140px, sem exceder 50 KB. Ícone Xiaomi: Tamanho sugerido de 120 * 120px, sem exceder 50 KB. Ícone Huawei: Tamanho sugerido de 40 * 40dp, sem exceder 512 KB. Ícone FCM: Se não houver requisitos específicos, o ícone padrão será usado automaticamente.
   Imagem grande	Não	Imagem exibida na parte inferior da mensagem, nos formatos JPG, JPEG ou PNG. Insira a URL publicamente acessível da imagem. Se você fornecer apenas a URL da imagem padrão sem enviar materiais para os canais de terceiros correspondentes, a imagem grande padrão será baixada e usada automaticamente nas mensagens enviadas por esses canais. Visto que os canais de terceiros possuem exigências diferentes para a imagem, recomenda-se enviar o material separadamente para cada canal, de acordo com seus requisitos. Imagem grande padrão: Tamanho sugerido de 876 * 324px, sem exceder 1 MB. Imagem grande OPPO: Tamanho sugerido de 876 * 324px, sem exceder 1 MB. Imagem grande Xiaomi: Tamanho sugerido de 876 * 324px, sem exceder 1 MB. Imagem grande iOS: Suporta imagens personalizadas, sem limitação de tamanho. Imagem grande FCM: Na ausência de requisitos específicos, a imagem padrão será usada automaticamente.
   Redirecionar ao clicar	Sim	Este parâmetro é enviado ao cliente como campo de referência. Implemente as operações subsequentes consultando esse campo. Página web: Redireciona o usuário para uma página web. É necessário inserir a URL da página de destino. Página personalizada: Redireciona o usuário para uma página nativa. Informe o endereço da página nativa de destino (Android: ActivityName; iOS: VCName).
   Endereço de redirecionamento	Não	Página acessada quando o usuário toca na mensagem no celular. Este parâmetro serve apenas como referência para o cliente; desenvolva a lógica de implementação por conta própria. Defina este parâmetro com base no valor de Redirecionar ao clicar.

3. Clique em Submit para crie o modelo. Após a criação bem-sucedida, a página Message templates será exibida com o novo modelo listado no topo.