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