Check out what’s new from Firebase at Google I/O 2022. Learn more

Enviar uma mensagem de teste a um app em segundo plano

Para começar com o FCM, crie o caso de uso mais simples: o envio de uma mensagem de notificação a um usuário específico quando o app estiver em segundo plano. Nesta página estão listadas todas as etapas, desde a configuração até a verificação. Se você configurou um app cliente JavaScript para o FCM, pode ser que já tenha concluído algumas das etapas mostradas.

Configurar o SDK

Adicione o Firebase ao projeto JavaScript, caso ainda não tenha feito isso.

Acessar o token de registro

Quando você precisar recuperar o token de registro atual de uma instância de app, chame getToken. Se a permissão de notificação não tiver sido concedida, esse método solicitará ao usuário permissões de notificação. Caso contrário, ele retorna um token ou rejeita a promessa devido a um erro.

O FCM exige um arquivo firebase-messaging-sw.js. A menos que você já tenha um arquivo firebase-messaging-sw.js, crie um arquivo vazio com esse nome e coloque-o na raiz do seu domínio antes de recuperar um token. Você pode adicionar conteúdo significativo ao arquivo posteriormente no processo de configuração do cliente.

Para recuperar o token atual:

Versão 9 para a Web

import { getMessaging, getToken } from "firebase/messaging";

// Get registration token. Initially this makes a network call, once retrieved
// subsequent calls to getToken will return from cache.
const messaging = getMessaging();
getToken(messaging, { vapidKey: '<YOUR_PUBLIC_VAPID_KEY_HERE>' }).then((currentToken) => {
  if (currentToken) {
    // Send the token to your server and update the UI if necessary
    // ...
  } else {
    // Show permission request UI
    console.log('No registration token available. Request permission to generate one.');
    // ...
  }
}).catch((err) => {
  console.log('An error occurred while retrieving token. ', err);
  // ...
});

Versão 8 para a Web

// Get registration token. Initially this makes a network call, once retrieved
// subsequent calls to getToken will return from cache.
messaging.getToken({ vapidKey: '<YOUR_PUBLIC_VAPID_KEY_HERE>' }).then((currentToken) => {
  if (currentToken) {
    // Send the token to your server and update the UI if necessary
    // ...
  } else {
    // Show permission request UI
    console.log('No registration token available. Request permission to generate one.');
    // ...
  }
}).catch((err) => {
  console.log('An error occurred while retrieving token. ', err);
  // ...
});

Depois de receber o token, envie-o para o servidor do app e armazene-o usando seu método preferido.

Enviar uma mensagem de notificação de teste

  1. Instale e execute o app no dispositivo de destino.

  2. Verifique se o app está em segundo plano no dispositivo.

  3. Abra o Editor do Notificações e selecione Nova notificação.

  4. Digite o texto da mensagem.

  5. Selecione Enviar mensagem de teste.

  6. No campo Adicionar um token de registro do FCM, insira o token de registro obtido na seção anterior deste guia.

  7. Clique em Testar.

Depois de clicar em Testar, o dispositivo cliente de destino que tem o app em segundo plano receberá a notificação no navegador.

Próximas etapas

Enviar mensagens aos apps em primeiro plano

Depois de enviar com êxito mensagens de notificação enquanto o app está em segundo plano, consulte Receber mensagens em um cliente JavaScript para iniciar o envio para apps em primeiro plano.

Ir além das mensagens de notificação

Para ir além das notificações e adicionar outros comportamentos mais avançados ao seu app, consulte os seguintes artigos: