/
Enviar notificação push avançada / Send Raw notification

Enviar notificação push avançada / Send Raw notification

Envia notificações personalizadas para um dispositivo móvel usando o Firebase Cloud Message (FCM).

 

Figura 1 - Bloco Enviar notificação push avançada

Para utilizar esse bloco é necessário ter um projeto no Firebase e adicionar ao Cronapp o plugin Google Firebase - Push Notification. Para mais informações, acesse o tutorial Push notification.

Compatibilidade

  • Bloco servidor: cronapi.pushnotification.Operations.sendRawNotification()

Retorno

Bloco sem retorno.

Parâmetros

Chave do Servidor

Chave do servidor gerada ao criar o projeto no Firebase.

  • Posição: 1

  • Inglês: Server Key

  • Tipo: Texto / String

  • Exemplo: "AAAAViA8Hz:APA91bGoOBTPTg5nIkSinOKGthqflkdr9VVGKdahdugginb..."

Destinatário

Token do dispositivo que receberá a notificação push.

  • Posição: 2

  • Inglês: Addressee

  • Tipo: Objeto / Object

  • Exemplo: "fsINDGCIOLITUZUNMI1Oes:PHA99eylzZCIGNTVMCQNDiotISISniataoig..."

Corpo

JSON contendo os dados da notificação. 

Para garantir que o JSON criado seja compatível com as funcionalidades padrões do Firebase, é importante utilizar algumas palavras-chave específicas, tais como "notification", "title" e "body". Para obter mais informações, consulte o tópico Mensagens de notificação na documentação do Firebase.

Para o envio de notificações push de forma mais simplificada, caso não seja necessário personalizar os dados da notificação, utilize o bloco de programação Enviar notificação push.

 

  • Posição: 3

  • Inglês: Body

  • Tipo: JSON / JSON

  • Exemplo:

    { "notification":{ "title":"Novidades do Cronapp!", "body":"Tutorial Push notification", "image":"https://www.cronapp.io/img/logo.png" } }

Exemplo

Na função abaixo, na variável "dadosNotificacao", estamos criando uma estrutura JSON (chave/valor) a partir dos blocos criar mapa com. No primeiro bloco, inserimos o parâmetro "notification" para sinalizar que se trata de uma notificação. No segundo bloco, inserimos os parâmetros "title", que recebe o título da notificação; "body", para o texto do corpo da notificação; e "image", onde é informada a URL da imagem que será exibida na notificação.

Em seguida, no bloco Enviar notificação push avançada, inserimos no parâmetro Chave do Servidor, a chave obtida no Firebase, no Destinatário, o token do dispositivo móvel, e no Corpo, a variável "dadosNotificacao" contendo os dados da notificação.

Figura 2 - Exemplo de uso do bloco

Para testar a aplicação, será necessário compilar e instalar o aplicativo no dispositivo móvel Android ou iOS. Para mais informações, veja o tópico Compilar aplicação mobile da documentação Push Notification.

Após executar a função acima (Figura 2), se o aplicativo estiver fechado ou em segundo plano no dispositivo, a notificação com os dados informados será exibida na bandeja de notificações (Figura 2.1). Ao clicar na notificação, o aplicativo será aberto. 

 

Figura 2.1 - Resultado exibido a partir das configurações da Figura 2

Nesta página