n8n-nodes-falefacilchat

Community node para n8n que integra a API da Fale Fácil Chat — conectando o WhatsApp Business ao seu workflow de automação.

Suporta conexões WAPI (WhatsApp Web) e Meta Cloud API (API oficial).

Instalação

Via n8n (recomendado)

1. Abra o n8n
2. Vá em Settings → Community Nodes
3. Clique em Install a community node
4. Digite: n8n-nodes-falefacilchat
5. Clique em Install

Via npm (self-hosted)

cd ~/.n8n
npm install n8n-nodes-falefacilchat

Reinicie o n8n após a instalação.

Nodes disponíveis

Fale Fácil Chat (ações)

| Recurso | Operação | Descrição | |-----------|-------------------|----------------------------------------------| | Mensagem | Enviar Texto | Envia texto para um número WhatsApp | | Mídia | Enviar Mídia | Envia imagem, vídeo, áudio ou documento | | Template | Listar Templates | Lista templates aprovados (Meta) | | Template | Enviar Template | Envia template com variáveis e mídia (Meta) | | Conexão | Status | Verifica se o WhatsApp está conectado | | Conexão | Listar Conexões | Retorna todas as conexões do cliente |

Fale Fácil Chat Trigger (webhook)

Recebe mensagens e eventos do WhatsApp em tempo real.

Recursos:

• Validação automática do token X-Webhook-Token
• Filtro por provedor (WAPI, Meta, ou ambos)
• Opção de ignorar mensagens próprias (evita loops)
• Output normalizado com campos unificados entre WAPI e Meta

Configuração

1. Credenciais

Crie uma credencial do tipo Fale Fácil Chat API com a API Key da sua conexão (disponível no painel Fale Fácil Chat).

2. Webhook

Para receber mensagens, adicione o node Fale Fácil Chat Trigger ao workflow:

1. Ative o workflow — o n8n gera uma URL de webhook
2. Copie a URL e cole no campo Endpoint de webhook na aba Desenvolvedor da conexão no painel
3. Opcionalmente, configure o Webhook Token no node para validar a origem das requisições

Output normalizado do Trigger

O node Trigger retorna um objeto padronizado independente do provedor:

{
  "provider": "wapi",
  "connection_id": 12,
  "from": "5511999990000",
  "fromName": "João Silva",
  "messageId": "3EB0A12345ABCDEF",
  "messageType": "text",
  "timestamp": "2026-04-16T14:30:00-03:00",
  "isGroup": false,
  "isFromMe": false,
  "text": "Olá! Gostaria de saber sobre os planos.",
  "raw": { ... }
}

O campo raw contém o payload completo original para casos que precisem de campos específicos do provedor.

Exemplos de uso

Resposta automática

[Fale Fácil Chat Trigger] → [IF: text contém "horário"] → [Fale Fácil Chat: Enviar Texto]

Envio de relatório em PDF

[Schedule] → [Gerar PDF] → [Fale Fácil Chat: Enviar Mídia (document)]

Disparos em massa via template

[Planilha de contatos] → [Loop] → [Fale Fácil Chat: Enviar Template]

Limites

• Rate limit: 120 requisições/minuto por API Key
• Mídia: máximo 20 MB por arquivo
• Templates: exclusivos para conexões Meta Cloud API
• sendtobitrix24: disponível apenas em WAPI (send_text e send_media)

Links

• Documentação completa da API
• Instalar no Bitrix24
• Site Fale Fácil

Licença

MIT