Mobile Platform as a Service:Criar uma mensagem de push simples

Envie uma mensagem de push para um único destino ao personalizar o conteúdo ou usar um modelo predefinido.

O push simples envia uma mensagem para um único destino. Personalize o conteúdo ou use um modelo predefinido.

Conteúdo personalizado é adequado para cenários de pequena escala, como testar um certificado de push da Apple ou verificar a integração do SDK para Android. Modelos são indicados para envios repetidos a vários destinos. Crie um push baseado em modelo no console para testar esse recurso antes de usá-lo em grande escala.

Siga as etapas abaixo para criar uma mensagem de push simples.

Pré-requisitos

• Integre o SDK do MPS para iOS (Integração do SDK para iOS) e configure o certificado de push da Apple na página Channel Configuration. Para mais informações, consulte Channel Configuration.

• Integre o SDK do MPS para HarmonyOS (Integração do SDK para HarmonyOS) e configure o certificado de push do HarmonyOS na página Channel Configuration. Para mais informações, consulte Channel Configuration.

• Integre o SDK do MPS para Android e os canais de fornecedores relevantes (Integração do SDK para Android) e conclua as configurações dos canais de push na página Channel Configuration (Configurar canais de push para Android).

Procedimento

1. Faça login no console do mPaaS, selecione o aplicativo desejado e escolha Message Push Service > Message Management.

2. Clique em Create Message Push Task. Na caixa de diálogo exibida, selecione a aba Simple Push.

3. Na aba Simple Push, configure os parâmetros da mensagem de push:

   Parâmetro	Obrigatório	Descrição
   Tipo de mensagem: Silenciosa	Sim	Define se a mensagem deve ser exibida: Sim: Mensagem silenciosa. Não aparece no dispositivo de destino. Não: A mensagem aparece na barra de notificações. No Android, o comportamento varia conforme o canal de push: Canal MPS: O valor é enviado ao cliente como campo de referência. Analise o corpo da mensagem para obter o valor e controlar a exibição adequadamente. Canal do fornecedor: O sistema do fornecedor analisa o campo e controla a exibição da mensagem automaticamente. No iOS, a exibição da mensagem é um comportamento do sistema que não requer outras ações.
   Método de criação do conteúdo da mensagem	Sim	Suporta dois métodos de criação: Criar: Personalize o conteúdo da mensagem, incluindo título, corpo e estilo de exibição. Usar modelo: Use um modelo de push criado anteriormente.
   Modelo de push	Sim	Selecione um modelo na página Message Template do aplicativo atual. Nota Este parâmetro é obrigatório apenas quando o método de criação do conteúdo da mensagem estiver definido como Usar modelo.
   Espaço reservado do modelo	Sim	Insira valores para as variáveis do modelo. O sistema exibe campos de entrada com base nos espaços reservados do modelo selecionado.
   Dimensão do push	Sim	Selecione a dimensão do push: Usuários: Envio por ID de usuário. Chame a API de vinculação para mapear IDs de usuário para IDs de dispositivo (API do Cliente). Android: Envio por ID de dispositivo Android. iOS: Envio por ID de dispositivo iOS.
   ID do Usuário/Dispositivo	Sim	Insira o ID de usuário ou ID de dispositivo correspondente à dimensão de push selecionada. Para Android, insira o Ad-token. Para iOS, insira o Device Token. Para Usuários, insira o ID do usuário (o valor userid passado ao chamar a API de vinculação). Remova quaisquer espaços dos IDs de dispositivo obtidos em logs ou outras fontes.
   Prioridade de push dos canais de mensagem Android	Sim	Exclusivo para Android. Opções: Preferir canais do fornecedor: As mensagens são enviadas pelos canais integrados do fornecedor quando disponíveis. Para canais não integrados, o envio ocorre pelo canal MPS. Canal MPS: As mensagens são enviadas exclusivamente pelo canal MPS. Este parâmetro aplica-se apenas ao Android. iOS e HarmonyOS usam canais do fornecedor por padrão.
   Estilo de exibição	Sim	Estilo de exibição da mensagem no cliente: Padrão: Mostra o título e o texto. Ideal para mensagens simples. Máximo de 100 caracteres, incluindo parâmetros personalizados e símbolos. Texto Grande: Mostra o título e texto estendido, permitindo leitura sem abrir o aplicativo. Recomendado para mensagens mais longas, como notícias ou atualizações. Máximo de 256 caracteres, incluindo parâmetros personalizados e símbolos. Rich text: Suporta mensagens com ícones e imagens grandes. Mais indicado para conteúdo visual. Mantenha o texto em duas linhas ou menos. Nota Obrigatório apenas quando o método de criação de conteúdo for Criar.
   Título da mensagem	Sim	Insira o título da mensagem. Use a área de pré-visualização à direita para verificar a exibição. Nota Obrigatório apenas quando o método de criação de conteúdo for Criar.
   Conteúdo da mensagem	Sim	Insira o corpo da mensagem. Use a área de pré-visualização à direita para verificar a exibição. Nota Obrigatório apenas quando o método de criação de conteúdo for Criar.
   Ícone	Não	Ícone da barra de notificações exibido à direita do conteúdo da mensagem. Suporta formatos JPG, JPEG e PNG. Insira uma URL publicamente acessível. Se você fornecer apenas uma URL padrão, o sistema a usará para todos os canais de fornecedores. Carregue recursos específicos do canal para otimizar a exibição. Ícone padrão: Tamanho recomendado de 140 × 140 px, até 50 KB. Ícone OPPO: Tamanho recomendado de 140 × 140 px, até 50 KB. Ícone Xiaomi: Tamanho recomendado de 120 × 120 px, até 50 KB. Ícone Huawei: Tamanho recomendado de 40 × 40 dp, até 512 KB. Ícone FCM: Sem requisitos específicos de configuração. O sistema busca automaticamente o ícone padrão para adaptação. Nota Obrigatório apenas quando o método de criação de conteúdo for Criar e o Estilo de exibição for Rich Text.
   Imagem grande da mensagem	Não	Imagem grande exibida abaixo do conteúdo da mensagem na barra de notificações. Insira uma URL publicamente acessível. Se você fornecer apenas uma URL padrão, o sistema a usará para todos os canais de fornecedores. Carregue recursos específicos do canal para otimizar a exibição. Imagem grande padrão: Tamanho recomendado de 876 × 324 px, até 1 MB. Suporta formatos JPG, JPEG e PNG. Imagem grande OPPO: Tamanho recomendado de 876 × 324 px, até 1 MB. Suporta formatos JPG, JPEG e PNG. Imagem grande Xiaomi: Tamanho recomendado de 876 × 324 px, até 1 MB. Suporta formatos JPG, JPEG e PNG. Imagem grande iOS: Imagem definida pelo usuário, sem restrições de tamanho. Imagem grande FCM: Sem requisitos específicos de configuração. O sistema busca automaticamente o ícone padrão para adaptação. Nota Obrigatório apenas quando o método de criação de conteúdo for Criar e o Estilo de exibição estiver definido como Rich Text.
   Hora do push	Sim	Selecione quando enviar a mensagem: Agora: Envia a mensagem imediatamente após a criação da tarefa de push. Agendado: Especifique um horário para enviar a mensagem. Por exemplo, envie a mensagem às 08:00 do dia 19 de junho. Cíclico: Envia a mensagem em um horário específico de forma cíclica dentro de um período. Por exemplo, envie a mensagem às 08:00 toda sexta-feira, de 1º de junho a 30 de setembro.

   Use a área Push Preview à direita para visualizar a Notification, Apple Message Body, Android Message Body e HarmonyOS Message Body para cada plataforma.

   Use a área Push Preview à direita para visualizar a Notification, Apple Message Body, Android Message Body e HarmonyOS Message Body para cada plataforma.

4. (Opcional) Configure as seguintes opções avançadas:

   • Redirecionar ao clicar: Ação executada quando um usuário toca na notificação. Este valor é enviado ao cliente como campo de referência para sua implementação.

     • Web page: Redireciona os usuários para uma página da web.

     • Custom page: Redireciona os usuários para uma página nativa.

   • Endereço de redirecionamento: Página de destino quando um usuário toca na notificação.

     • Para Web page, insira a URL de destino.

     • Para Custom page, insira o endereço da página nativa (Android: ActivityName; iOS: VCName).

   • ID de mensagem personalizado: Identificador único gerado pelo sistema para a mensagem. Você pode personalizá-lo. Máximo de 64 caracteres.

   • Nota

     Configure um ID personalizado apenas se o tipo de mensagem for silenciosa.

   • Período de validade: Tempo de retenção da mensagem em segundos. Se a entrega falhar porque o dispositivo está offline ou o usuário fez logout, o MPS tentará novamente dentro deste período quando o dispositivo se reconectar ou uma nova solicitação de vinculação for feita. Padrão: 180 segundos.

     Nota

     O período de validade da mensagem não pode ser inferior a 180 segundos nem superior a 72 horas.

   • Parâmetros de extensão: Ative a opção, clique em Add parameter, defina o par chave-valor e clique em qualquer área para salvar. Os parâmetros de extensão são passados ao cliente junto com o corpo da mensagem. Três tipos estão disponíveis:

     • Parâmetros estendidos do sistema

       Parâmetros reservados pelo sistema com valores fixos: notifyType, action, silent, pushType, templateCode, channel e taskId.

     • Parâmetros estendidos do sistema com significados especiais

       Parâmetros reservados pelo sistema com valores configuráveis:

       Parâmetro	Descrição
       sound	Caminho do arquivo de toque personalizado. Válido apenas para dispositivos Xiaomi e Apple.
       badge	Número do distintivo no ícone do aplicativo. Para Android, implemente a lógica do distintivo em seu aplicativo. Para dispositivos Apple, o sistema exibe automaticamente o valor do distintivo configurado no ícone do aplicativo.
       mutable-content	Identificador de push personalizado do APNs. Incluir este parâmetro em um push indica suporte para UNNotificationServiceExtension no iOS 10. Se este parâmetro não for incluído, trata-se de um push normal. Defina o valor do parâmetro como 1.
       badge_add_num	Número a ser adicionado ao distintivo para pushes do canal Huawei.
       badge_class	Classe Activity de entrada do aplicativo correspondente ao ícone da área de trabalho para o canal Huawei.
       big_text	Habilita o estilo de texto grande. Defina como 1. Válido apenas para dispositivos Xiaomi e Huawei.

     • Parâmetros estendidos definidos pelo usuário

       Pares chave-valor personalizados enviados com o corpo da mensagem para processamento no lado do cliente.

5. Clique em Submit. A mensagem criada aparece na lista de registros de mensagens simples.

   Você também pode enviar mensagens por meio de APIs (Referência da API do lado do servidor).

Operações relacionadas

• Criar uma mensagem - Push múltiplo

• Gerenciar mensagens de push simples

• Gerenciar tarefa de push agendada