GWhats
    Integração Nativa

    GWhats + n8n

    Automatize atendimentos, cobranças, sincronização com CRM e muito mais — sem escrever uma linha de código — usando o Community Node oficial do GWhats para n8n.

    @clubmega/n8n-nodes-mega
    Instalação em 1 cliqueCommunity Node
    8 recursosRecursos disponíveis
    13 eventosEventos de trigger
    Sem códigoWorkflows prontos

    O que é

    O que é o n8n?

    O n8n é uma plataforma open-source de automação de fluxos de trabalho. Com ele, você conecta centenas de sistemas — ERPs, CRMs, bancos de dados, APIs — de forma visual, criando automações poderosas sem precisar programar.

    O Community Node GWhats

    O pacote @clubmega/n8n-nodes-mega adiciona ao n8n suporte nativo ao GWhats. Com ele, você gerencia contatos, conversas, mensagens, agentes e equipes, e reage a eventos em tempo real via triggers.

    Por que usar em vez da API direta?

    Sem código

    Monte automações completas arrastando nós — não precisa escrever scripts.

    Triggers nativos

    Reaja a eventos do GWhats em tempo real sem configurar webhooks manualmente.

    Centenas de integrações

    Conecte o GWhats a HubSpot, Slack, Google Sheets, ERPs e muito mais em minutos.

    Instalação

    O Community Node pode ser instalado de duas formas: pela interface do n8n (recomendado) ou via CLI para instalações self-hosted. Requer n8n v1.0.0+ e Node.js v18.10+.

    1

    Instalar pela interface do n8n (recomendado)

    1. 1Abra o n8n e clique no menu lateral → Settings → Community Nodes
    2. 2Clique em "Install a community node"
    3. 3No campo de busca, digite: @clubmega/n8n-nodes-mega
    4. 4Marque a caixa de confirmação de risco e clique em "Install"
    5. 5Aguarde a instalação. O n8n reiniciará automaticamente o ambiente de execução.
    2

    Instalar via CLI (self-hosted)

    1. 1Acesse o terminal do servidor onde o n8n está rodando
    2. 2Execute o comando abaixo na pasta de dados do n8n (geralmente ~/.n8n):
    bash
    npm install @clubmega/n8n-nodes-mega
    1. 3Reinicie o n8n: pm2 restart n8n (ou docker restart n8n)
    2. 4O nó GWhats aparecerá na lista de nós disponíveis

    Verificar instalação

    Abra um workflow, clique em + para adicionar um nó e procure por GWhats. Você verá dois nós: GWhats (ações) e GWhats Trigger (eventos).

    Configurar credenciais

    Antes de usar qualquer nó GWhats, configure as credenciais de acesso à API. Você só precisa fazer isso uma vez — as credenciais ficam salvas e podem ser reutilizadas em todos os workflows.

    1

    Obter o Token de Acesso do GWhats

    1. 1Acesse o painel GWhats em app3.gwhats.app
    2. 2Clique no seu avatar (canto inferior esquerdo) → Configurações do Perfil
    3. 3Role até Tokens de Acesso e clique em Gerar Token
    4. 4Copie o token gerado — ele só é exibido uma vez
    2

    Obter o Account ID

    O Account ID é o número que aparece na URL do painel após o login: app3.gwhats.app/app/accounts/123/.... O número é o seu Account ID.

    3

    Adicionar as credenciais no n8n

    1. 1No n8n, vá em Credentials (menu lateral) → New Credential
    2. 2Busque por GWhats API e selecione
    3. 3Preencha: Host URL (https://app3.gwhats.app), Account ID e API Token
    4. 4Clique em Save — as credenciais estão prontas para usar em qualquer nó GWhats

    Campos da credencial GWhats API

    Host URL
    https://app3.gwhats.app

    URL base da plataforma GWhats — não altere

    Account ID
    ex: 123

    Número visível na URL após o login

    API Token
    seu_token_aqui

    Token gerado em Configurações do Perfil → Tokens de Acesso

    Nó GWhats — Ações

    O nó GWhats é o nó de ação principal. Use-o em qualquer ponto do workflow para criar, buscar, atualizar ou excluir recursos no GWhats. Selecione o Resource e a Operation desejada.

    Contatos

    CriarBuscarAtualizarListarExcluirBuscar conversas

    Conversas

    CriarBuscarAtualizar statusListarAtribuir agenteAtribuir equipe

    Mensagens

    EnviarListarCriar nota privada

    Agentes

    CriarListarAtualizarExcluir

    Equipes

    CriarListarAtualizarExcluirListar membros

    Campanhas

    CriarListarExcluir

    Automações

    CriarListarAtualizarExcluirCopiar

    Relatórios

    Resumo da contaMétricas por agenteMétricas por equipeMétricas por canal

    Exemplo: criar uma conversa com mensagem

    No nó GWhats, selecione Conversas → Criar e preencha os campos. Use expressões do n8n (entre {{ }}) para referenciar dados de nós anteriores:

    Campos do nó Conversas → Criar

    Contact ID
    {{ $json.contact_id }}

    ID do contato (vem de um nó Contatos → Buscar anterior)

    Inbox ID
    42

    ID da caixa de entrada WhatsApp (Configurações → Caixas de Entrada)

    Message
    {{ $json.mensagem }}

    Texto da mensagem — pode ser dinâmico

    Assigned To
    {{ $json.agent_id }}

    Opcional: ID do agente responsável

    GWhats Trigger — Eventos

    O nó GWhats Trigger é o ponto de partida de um workflow. Ele registra automaticamente um webhook no GWhats e dispara o fluxo em tempo real toda vez que o evento selecionado ocorrer.

    Ao ativar o workflow no n8n, o nó registra o webhook automaticamente no GWhats. Ao desativar, o webhook é removido. Não é necessário configurar webhooks manualmente.

    Eventos disponíveis (13)

    conversation_created

    Nova conversa iniciada por qualquer canal

    conversation_updated

    Dados de uma conversa foram alterados

    conversation_status_changed

    Status mudou: aberta, resolvida, pendente

    message_created

    Nova mensagem recebida ou enviada

    message_updated

    Mensagem foi editada ou seu status mudou

    contact_created

    Novo contato criado na plataforma

    contact_updated

    Dados de contato foram alterados

    conversation_resolved

    Conversa marcada como resolvida

    agent_typing_on

    Agente começou a digitar na conversa

    agent_typing_off

    Agente parou de digitar

    webwidget_triggered

    Widget de chat acionado no site

    label_created

    Nova label criada na conta

    team_member_added

    Membro adicionado a uma equipe

    Como usar o GWhats Trigger

    1No editor de workflow, clique em + → busque GWhats Trigger e selecione
    2Escolha as credenciais GWhats configuradas anteriormente
    3Selecione o evento desejado no campo Events (ex: message_created)
    4Conecte o trigger aos próximos nós do workflow
    5Clique em Activate Workflow — o webhook é registrado automaticamente no GWhats
    6Para testar: envie uma mensagem no WhatsApp e veja o workflow disparar em tempo real

    Exemplos de workflow

    Receitas prontas de automação que você pode replicar no n8n em minutos, combinando os nós GWhats com outros serviços.

    Dicas e boas práticas

    Use o nó Error Trigger

    Adicione um nó Error Trigger para capturar falhas e notificar sua equipe via Slack ou e-mail antes que o cliente perceba.

    Filtre eventos com nó IF

    O GWhats Trigger dispara para todos os eventos do tipo selecionado. Use um nó IF logo após para filtrar por inbox, canal ou status.

    Busque o contato antes de criar

    Antes de criar uma conversa, use GWhats → Contatos → Buscar pelo telefone. Se já existir, reuse o ID em vez de duplicar.

    Use variáveis de ambiente

    Salve Account ID e Inbox IDs como variáveis no n8n (Settings → Variables) para facilitar a manutenção e troca de ambiente.

    Rate limiting

    A API GWhats tem limite de requisições. Use o nó Wait entre iterações de grandes lotes para evitar erros 429.

    Notas privadas para a equipe

    Use GWhats → Mensagens → Criar Nota Privada para registrar contexto interno sem o cliente ver — ideal para triagem automatizada.

    Pronto para começar?

    Instale o Community Node no n8n e crie sua primeira automação com o GWhats em minutos.

    bash
    npm install @clubmega/n8n-nodes-mega