Integração n8n

O Fiwano é um node comunitário verificado do n8n — listado em n8n.io/integrations/fiwano/. Use-o para construir automações de WhatsApp, Instagram e Facebook Messenger, fluxos com agentes de IA e chatbots.

Instalação

Pelo editor do n8n (recomendado)

Abra o painel de nodes com + ou N
Pesquise por Fiwano
Selecione Fiwano em More from the community
Clique em Install

No n8n Cloud, a instalação pode precisar ser habilitada antes pelo dono da instância no Cloud Admin Panel.

Alternativa manual (npm)

Use apenas quando a instalação pelo app não estiver disponível no seu ambiente (por exemplo, um setup self-hosted restrito).

mkdir -p ~/.n8n/nodes && cd ~/.n8n/nodes
npm install n8n-nodes-fiwano
# Reinicie o n8n

Para Docker self-hosted: inclua este pacote em uma imagem n8n customizada — veja o repositório no GitHub para detalhes.

Nodes

Node	Tipo	Descrição
Fiwano	Action	Enviar mensagens, gerenciar canais, modelos do WhatsApp, enriquecimento de perfil de contato, redirect URIs
Fiwano Trigger	Webhook Trigger	Receber mensagens recebidas e webhooks de status de entrega com verificação de assinatura HMAC opcional

Node Action — operações

Recurso	Operações
Message	Send Text, Send Template (WhatsApp), Send Media (image/audio/video/document)
Channel	Get Many, Get, Generate OAuth URL, Exchange OAuth Code, Update Webhook, Delete
Contact	Get Profile (Instagram, Facebook — retorna nome, foto de perfil, número de seguidores)
Template	Get Many, Get, Create, Delete (somente WhatsApp)
Redirect URI	Get Many, Add, Delete

Node Trigger — eventos

Inicia seu workflow para qualquer um destes eventos (filtre por tipo de evento nas configurações do node):

Evento	Canais
`message.received`	WhatsApp, Instagram, Facebook
`message.delivered`	WhatsApp, Instagram, Facebook
`message.read`	WhatsApp, Instagram, Facebook
`message.sent`	WhatsApp
`message.failed`	WhatsApp

A verificação de assinatura HMAC-SHA256 é integrada ao node de trigger. Para ativá-la, defina o webhook_secret do canal no campo Webhook Secret do trigger — o node passa a verificar cada webhook contra esse segredo e rejeita divergências com HTTP 401. O segredo é o mesmo que você configurou por canal (via Exchange OAuth Code ou Update Webhook); o n8n armazena sua cópia no node, ele não é obtido automaticamente. Deixe o campo vazio para pular a verificação (não recomendado em produção).

Workflow de exemplo

Um workflow demo pronto para importar está incluído no repositório no GitHub, cobrindo todas as operações: bot de eco com enriquecimento de perfil, gerenciamento de canais, CRUD de modelos e envio de texto e modelos.