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 fazer isso, desde a configuração até a verificação. Ela pode abranger etapas que você já concluiu se tiver configurado um aplicativo cliente JavaScript para FCM.

Configure o SDK

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

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 modular API

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 namespaced API

// 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 o servidor do aplicativo e armazene-o usando o método de sua preferência.

Envie 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. Certifique-se de que o aplicativo esteja em segundo plano no dispositivo.

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

  4. Se esta for sua primeira mensagem, selecione Crie 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 denominado Adicionar um token de registro FCM , insira o token de registro obtido na seção anterior deste guia.

  9. Selecione Teste .

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

Próximos passos

Envie 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 outros comportamentos mais avançados ao seu aplicativo, consulte: