Acompanhe tudo o que foi anunciado no Firebase Summit e saiba como usar o Firebase para acelerar o desenvolvimento de apps e executá-los com confiança. Saiba mais

Envie uma mensagem de teste para um aplicativo em segundo plano

Para começar a usar o FCM, crie o caso de uso mais simples: enviar uma mensagem de notificação para um usuário específico quando o aplicativo estiver em segundo plano no dispositivo. Esta página lista todas as etapas para conseguir isso, desde a configuração até a verificação — ela pode abranger as etapas que você já concluiu se tiver configurado um aplicativo cliente JavaScript para FCM.

Configurar o SDK

Se ainda não o fez, adicione o Firebase ao seu projeto JavaScript .

Acesse o token de registro

Quando você precisar recuperar o token de registro atual para uma instância de aplicativo, primeiro solicite permissões de notificação do usuário com Notification.requestPermission() . Quando chamado conforme mostrado, retorna um token se a permissão for concedida ou rejeita a promessa se negada:

function requestPermission() {
  console.log('Requesting permission...');
  Notification.requestPermission().then((permission) => {
    if (permission === 'granted') {
      console.log('Notification permission granted.');

O FCM requer 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:

Web version 9

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);
  // ...
});

Web version 8

// 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 obter o token, envie-o para seu servidor de aplicativos e armazene-o usando seu método preferido.

Enviar uma mensagem de notificação de teste

  1. Instale e execute o aplicativo no dispositivo de destino. Em dispositivos Apple, você precisará aceitar a solicitação de permissão para receber notificações remotas.

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

  3. No console do Firebase, abra a página Mensagens .

  4. Se esta for sua primeira mensagem, selecione Criar sua primeira campanha .

    1. Selecione Mensagens de notificação do Firebase e selecione Criar .
  5. Caso contrário, na guia Campanhas , selecione Nova campanha e depois Notificações .

  6. Digite o texto da mensagem. Todos os outros campos são opcionais.

  7. Selecione Enviar mensagem de teste no painel direito.

  8. No campo Adicionar um token de registro FCM , insira o token de registro obtido em uma seção anterior deste guia.

  9. Selecione Teste .

Depois de selecionar Test , o dispositivo cliente de destino (com o aplicativo em segundo plano) deve receber a notificação.

Próximos passos

Enviar mensagens para aplicativos em primeiro plano

Depois de enviar mensagens de notificação com sucesso enquanto seu aplicativo está em segundo plano, consulte Receber mensagens em um cliente JavaScript para começar a enviar para aplicativos em primeiro plano.

Vá além das mensagens de notificação

Para ir além das mensagens de notificação e adicionar outro comportamento mais avançado ao seu aplicativo, consulte: