Comece a usar o recurso "Mensagens no app" do Firebase

Veja neste guia de início rápido como configurar o recurso Firebase In-App Messaging e como enviar sua primeira mensagem.


Antes de começar

Instale e inicialize os SDKs do Firebase para Flutter, caso ainda não tenha feito isso.

Adicionar o SDK de Mensagens no app ao seu projeto

  1. No diretório raiz do projeto do Flutter, execute o seguinte comando para instalar o plug-in do recurso Mensagens no app do Firebase:

    flutter pub add firebase_in_app_messaging

  2. Recriar o projeto:

    flutter run

  3. Importar o plug-in do Mensagens no app do Firebase:

    import 'package:firebase_in_app_messaging/firebase_in_app_messaging.dart';

Enviar uma mensagem de teste

Receber o ID de instalação do app

Para economizar energia, o recurso "Mensagens no app" do Firebase só recupera notificações do servidor uma vez por dia. Isso pode dificultar o teste. Por isso, o Console do Firebase permite especificar um dispositivo de teste que exibe mensagens sob demanda.

Este dispositivo de teste é determinado por um FID. Para encontrar o FID do app de teste, verifique a saída do console ao executá-lo.

No Android, a mensagem é semelhante a esta:

I/FIAM.Headless: Starting InAppMessaging runtime with Installation ID YOUR_INSTALLATION_ID

No iOS, execute o aplicativo com o argumento de comando de ambiente de execução -FIRDebugEnabled:

  1. Com seu projeto do Xcode aberto, selecione Produto > Esquema > Editar esquema… na barra de menu superior.
  2. Abra a guia Argumentos da caixa de diálogo mostrada.
  3. Clique em + Adicionar itens em Argumentos transmitidos na inicialização.
  4. Digite "-FIRDebugEnabled" no campo recém-criado.
  5. Clique em Fechar e execute seu aplicativo.

Depois que seu aplicativo começar a ser executado, procure a seguinte linha nos registros do console do Xcode:

[Firebase/InAppMessaging][I-IAM180017] Starting InAppMessaging runtime with Firebase Installation ID YOUR_INSTALLATION_ID

Enviar uma mensagem para seu dispositivo de teste

Depois de iniciar o app no dispositivo de teste e receber o ID de instalação do Firebase (FID), envie uma mensagem para testar a configuração do Mensagens no app do Firebase:

  1. No console do Firebase, acesse DevOps e engajamento > Mensagens.

  2. Inicie o fluxo de trabalho para configurar uma nova campanha:

    • Se esta for sua primeira campanha:

      1. Clique em Criar sua primeira campanha.
      2. Selecione Mensagens no app do Firebase e clique em Criar.

    • Se você já criou campanhas:

      1. Na guia Campanhas, clique em Nova campanha.
      2. Selecione Mensagens no app.

  3. Digite um Título para sua primeira mensagem.

  4. Clique em Testar no dispositivo.

  5. Digite o ID de instalação do Firebase do seu app no campo Adicionar um ID de instalação.

  6. Clique em Testar para enviar a mensagem. Ela será enviada imediatamente.

  7. Para ver a mensagem no dispositivo de teste, feche e abra novamente o app.

Para confirmar se o dispositivo é de teste, procure uma das mensagens de registro a seguir.

Android

I/FIAM.Headless: Setting this device as a test device

iOS

[Firebase/InAppMessaging][I-IAM180017] Seeing test message in fetch response. Turn the current instance into a testing instance.