firebase-cloud-message

n8n node to send push notifications via Firebase Cloud Messaging

Package Information

Released: 7/8/2025
Downloads: 31 weekly / 114 monthly
Latest Version: 1.1.0
Author: Jaime Neto

Available Nodes

Firebase Cloud Message icon
Firebase Cloud Message
No description available

Documentation

@jaimeflneto/n8n-nodes-firebase-cloud-message

Este é um nó comunitário n8n que permite enviar notificações push via Firebase Cloud Messaging (FCM).

n8n é uma plataforma de automação de fluxo de trabalho com licença fair-code.

Instalação | Installation
Operações | Operations
Credenciais | Credentials
Recursos | Resources

Instalação

Siga o guia de instalação na documentação de nós comunitários n8n.

Instalação Rápida

Instale a partir da aba Community Nodes do n8n:

  1. No painel do n8n, navegue até Configurações > Nós Comunitários
  2. Selecione Instalar
  3. Digite @jaimeflneto/n8n-nodes-firebase-cloud-message em Digite o nome do pacote npm
  4. Clique em Instalar

Ou via npm:

npm install @jaimeflneto/n8n-nodes-firebase-cloud-message

Para instalação global:

npm install -g @jaimeflneto/n8n-nodes-firebase-cloud-message

Operações

Enviar para Token

Envie notificações para um dispositivo específico ou para múltiplos dispositivos usando tokens FCM.

Opções:

  • Token único ou múltiplos tokens (até 500)
  • Modo JSON para configuração manual completa
  • Campos estruturados para configuração simples

Enviar para Tópico

Envie notificações para todos os dispositivos inscritos em um tópico específico.

Opções:

  • Nome do tópico (com ou sem prefixo /topics/)
  • Modo JSON para configuração manual completa
  • Campos estruturados para configuração simples

Enviar para Condição

Envie notificações para dispositivos que atendam a uma condição específica (combinação de tópicos).

Opções:

  • Condição (ex: 'TopicA' in topics && ('TopicB' in topics || 'TopicC' in topics))
  • Modo JSON para configuração manual completa
  • Campos estruturados para configuração simples

Inscrever em Tópico

Inscreva tokens de dispositivo em um tópico específico.

Opções:

  • Nome do tópico
  • Lista de tokens de dispositivo (até 1000)

Cancelar Inscrição em Tópico

Cancele a inscrição de tokens de dispositivo de um tópico específico.

Opções:

  • Nome do tópico
  • Lista de tokens de dispositivo (até 1000)

Tipos de Mensagem

Notificação com Dados Opcionais

Envie uma notificação que aparece no dispositivo com um payload de dados opcional.

Campos de Notificação:

  • Título
  • Corpo
  • URL da Imagem
  • Prioridade (Normal/Alta)
  • Som Personalizado
  • Ação de Clique (URL ou Intent)
  • Dados (payload JSON personalizado)

Somente Dados

Envie apenas uma mensagem de dados que é tratada pelo aplicativo e não aparece como uma notificação.

Campos:

  • Dados (payload JSON personalizado)
  • Prioridade (Normal/Alta)

Credenciais

Conta de Serviço do Firebase

Para usar este nó, você precisa de uma conta de serviço do Firebase:

  1. Acesse o Console do Firebase
  2. Selecione seu projeto
  3. Vá para Configurações do Projeto > Contas de serviço
  4. Clique em "Gerar nova chave privada"
  5. Baixe o arquivo JSON da conta de serviço

Campos de Credencial:

  • Conteúdo JSON da Conta de Serviço
  • URL do Banco de Dados (opcional)
  • Bucket de Armazenamento (opcional)
  • Região (opcional)

Recursos

Exemplos de Uso

Enviar Notificação para um Dispositivo

{
  "notification": {
    "title": "Título da Notificação",
    "body": "Corpo da mensagem de notificação"
  },
  "token": "DEVICE_TOKEN_HERE"
}

Enviar Notificação para um Tópico

{
  "notification": {
    "title": "Título da Notificação",
    "body": "Corpo da mensagem de notificação"
  },
  "topic": "noticias"
}

Enviar Mensagem de Dados para Múltiplos Dispositivos

{
  "data": {
    "tipo": "atualização",
    "valor": "123",
    "ação": "abrir_tela"
  },
  "tokens": ["TOKEN1", "TOKEN2", "TOKEN3"]
}

Tratamento de Erros

O nó inclui tratamento abrangente de erros para problemas comuns do Firebase Cloud Messaging:

  • Tokens de registro inválidos ou expirados
  • Erros de autenticação
  • Limitações de tamanho da carga
  • Problemas de conectividade
  • Validação de entrada

Quando o modo "Continue em caso de falha" está ativado, o nó retornará informações detalhadas sobre o erro em vez de interromper o fluxo de trabalho.

English Documentation

Installation

Follow the installation guide in the n8n community nodes documentation.

Quick Installation

Install from the n8n Community Nodes tab:

  1. In the n8n panel, navigate to Settings > Community Nodes
  2. Select Install
  3. Enter @jaimeflneto/n8n-nodes-firebase-cloud-message in Enter npm package name
  4. Click Install

Or via npm:

npm install @jaimeflneto/n8n-nodes-firebase-cloud-message

For global installation:

npm install -g @jaimeflneto/n8n-nodes-firebase-cloud-message

Operations

Send to Token

Send notifications to a specific device or multiple devices using FCM tokens.

Options:

  • Single token or multiple tokens (up to 500)
  • JSON mode for complete manual configuration
  • Structured fields for simple configuration

Send to Topic

Send notifications to all devices subscribed to a specific topic.

Options:

  • Topic name (with or without /topics/ prefix)
  • JSON mode for complete manual configuration
  • Structured fields for simple configuration

Send to Condition

Send notifications to devices that meet a specific condition (combination of topics).

Options:

  • Condition (e.g., 'TopicA' in topics && ('TopicB' in topics || 'TopicC' in topics))
  • JSON mode for complete manual configuration
  • Structured fields for simple configuration

Subscribe to Topic

Subscribe device tokens to a specific topic.

Options:

  • Topic name
  • List of device tokens (up to 1000)

Unsubscribe from Topic

Unsubscribe device tokens from a specific topic.

Options:

  • Topic name
  • List of device tokens (up to 1000)

Message Types

Notification with Optional Data

Send a notification that appears on the device with an optional data payload.

Notification Fields:

  • Title
  • Body
  • Image URL
  • Priority (Normal/High)
  • Custom Sound
  • Click Action (URL or Intent)
  • Data (custom JSON payload)

Data Only

Send only a data message that is handled by the app and does not appear as a notification.

Fields:

  • Data (custom JSON payload)
  • Priority (Normal/High)

Credentials

Firebase Service Account

To use this node, you need a Firebase service account:

  1. Go to the Firebase Console
  2. Select your project
  3. Go to Project Settings > Service accounts
  4. Click "Generate new private key"
  5. Download the service account JSON file

Credential Fields:

  • Service Account JSON Content
  • Database URL (optional)
  • Storage Bucket (optional)
  • Region (optional)

Resources

Usage Examples

Send Notification to a Device

{
  "notification": {
    "title": "Notification Title",
    "body": "Notification message body"
  },
  "token": "DEVICE_TOKEN_HERE"
}

Send Notification to a Topic

{
  "notification": {
    "title": "Notification Title",
    "body": "Notification message body"
  },
  "topic": "news"
}

Send Data Message to Multiple Devices

{
  "data": {
    "type": "update",
    "value": "123",
    "action": "open_screen"
  },
  "tokens": ["TOKEN1", "TOKEN2", "TOKEN3"]
}

Error Handling

The node includes comprehensive error handling for common Firebase Cloud Messaging issues:

  • Invalid or expired registration tokens
  • Authentication errors
  • Payload size limitations
  • Connectivity issues
  • Input validation

When "Continue on Fail" mode is enabled, the node will return detailed error information instead of stopping the workflow.

License

MIT

Discussion