No momento, o Reconnect suporta apenas a integração da Firebase para notificações push. Integrações adicionais virão em breve.
Integre sua conta Firebase com o Reconnect para enviar notificações push para usuários de Android e iOS.
Configurando a integração
Pré-requisito: uma conta Firebase integrada à sua aplicação.
Para criar a integração no Reconnect:
- Na guia de integrações, clique em Create Channel Integration, em seguida, selecione Push Notifications.
- Selecione a opção da Firebase.
- Envie seu arquivo de chave de conta de serviço. Aprenda como obter o arquivo na próxima seção.
Observe o seguinte:- O arquivo está disponível para download no seu projeto no Firebase.
- Ele deve ser um arquivo JSON.
- Clique em Validar e Salvar. O conteúdo do arquivo será validado de acordo com os serviços da Firebase. Se houver uma falha na validação, um erro será mostrado e o arquivo será removido. Se a validação tiver sucesso, a integração ficará salva e estará pronta para uso.
Obtendo o arquivo de chave de conta de serviço da Firebase
Para obter o arquivo de chave da Firebase, você deve criar uma nova conta de serviço e, em seguida, gerar o token.
Passo 1: crie uma nova conta de serviço na Firebase
No seu projeto na Firebase, faça o seguinte:
- Acesse Project Overview › Project Settings.
- Nas guias Cloud Messaging ou Service accounts, selecione Manage Service Accounts.
Isso levará você até o console do Google Cloud (console.cloud.google.com). - Clique em + Create Service Account.
- Insira um nome para a conta de serviço (por exemplo: DY, DYServiceAccount ou DynamicYield).
- Insira o ID da sua conta de serviço.
- Opcionalmente, insira uma descrição para melhor compreensão. Por exemplo: "Para notificações push que usam os serviços da DY".
- Clique em Create and Continue.
Passo 2: defina uma função de acesso e gere o token
- Na área Grant this service account access to project, clique em Pick a Predefined Role e, em seguida, selecione uma das funções a seguir, que possuem a permissão cloudmessaging.messages.create (para saber mais sobre funções, consulte a seção Understanding Roles na documentação da Firebase):
- Firebase Admin (roles/firebase.admin): fornece permissões amplas através de todos os serviços da Firebase, incluindo o Firebase Cloud Messaging. Permite que a conta envie notificações push, mas é excessivamente permissiva para operações ligadas apenas ao FCM.
- Firebase Grow Admin (roles/firebase.growthAdmin): fornece permissões através de vários serviços da Firebase que sejam relacionados a crescimento, como Firebase Cloud Messaging e Firebase Remote Config.
- Firebase Admin SDK Administrator Service Agent (roles/firebase.sdkAdminServiceAgent): permite que as contas de serviços atuem como SDKs de administradores da Firebase. Essa função não é especificamente projetada para o FCM, mas pode incluir as permissões necessárias.
- Firebase SDK Provisioning Service Agent (roles/firebase.sdkProvisioningServiceAgent): criada para fornecer e gerenciar configurações de SDK. Não é necessariamente relacionada ao envio de mensagens do FCM.
- Clique em Continue e, depois, em Done.
- No menu suspenso ao lado da conta de serviço (3 pontos verticais), selecione Manage keys.
- Clique em + ADD KEY e, em seguida, selecione JSON.
- Uma chave de JSON é gerada e baixada. Forneça essa chave à Dynamic Yield na integração conforme descrito na seção de configuração da integração.
Documentação útil da Firebase
Os links a seguir são documentos importantes, com informações sobre os campos contidos nas notificações enviadas usando o SDK de administrador da Firebase (cor, imagem, link de clique, título, corpo):