Conectar a Wevichat ao n8n
Nível: Intermediário Tempo de leitura: 6 min Plano necessário: Todos os planos
Por que existe
O n8n é uma ferramenta de automação onde você monta fluxos arrastando blocos, sem escrever código. A Wevichat tem um bloco oficial lá dentro.
Com ele você liga o WhatsApp ao resto da sua operação. O cliente manda mensagem, o n8n consulta o seu sistema, devolve a resposta e ainda registra tudo na planilha. Nada disso exige programação.
É o caminho mais curto para quem não tem desenvolvedor à mão e precisa de mais do que as automações prontas do painel.
O que vem no pacote
São dois blocos.
Wevichat faz coisas na sua conta. Ele cobre a API inteira, com as operações organizadas por recurso:
| Recurso | O que dá para fazer |
|---|---|
| Contato | Criar, atualizar, buscar, listar, etiquetar, mover de etapa, fundir, exportar |
| Conversa | Listar, ler, responder, assumir, devolver para a IA, pausar, encerrar, etiquetar |
| Mensagem | Enviar qualquer tipo, consultar o status de entrega |
| Agente | Conversar com um agente de IA, listar, gerenciar a base de conhecimento |
| Campanha | Criar, agendar, disparar, cancelar, ver os destinatários |
| Automação | Colocar e tirar contato de um fluxo, ver as execuções |
| Webhook | Cadastrar, alterar, testar, ver as entregas |
| Configuração | Números, templates, etiquetas, funis, campos, equipe |
| Organização | Plano, limites, consumo e métricas |
Wevichat Trigger é o que faz o fluxo começar. Você escolhe o que dispara e o n8n roda sozinho quando aquilo acontece. São 30 opções, entre elas:
- Cliente mandou mensagem
- Pediram atendente
- Conversa encerrada
- Cliente avaliou o atendimento
- Contato mudou de etapa no funil
- Contato ganhou ou perdeu dono
- Campanha terminou
- Template mudou de status
O gatilho cuida da parte chata sozinho. Quando você ativa o fluxo, ele cria o webhook na sua conta. Quando desativa, apaga. E confere a assinatura de cada evento que chega, para ninguém conseguir forjar um aviso falso.
Passo a passo
Instale o bloco. No n8n, vá em Settings → Community Nodes → Install e informe
@wevichat/n8n-nodes-wevichat. Se você usa o n8n na nuvem, o menu fica no mesmo lugar.Crie a chave na Wevichat. No app, clique no seu nome no rodapé do menu lateral, vá na aba Desenvolvedores e crie uma chave nova. Marque Chave de teste enquanto estiver montando o fluxo.
Cadastre a credencial no n8n. Ao arrastar o bloco da Wevichat para o canvas, ele pede a credencial. Cole a chave e salve. O n8n testa na hora e avisa se ela não vale.
Monte o fluxo. Comece pelo Wevichat Trigger, escolha o evento e ligue os blocos seguintes.
Ative. Enquanto o fluxo está desativado, o webhook não existe. Ative para valer.
Troque a chave. Quando o fluxo estiver do jeito que você quer, apague a chave de teste, crie uma normal e atualize a credencial.
Fluxos prontos para importar
Três fluxos vêm junto com o pacote, na pasta fluxos/. Baixe, importe no n8n em Workflows → Import from File e ajuste:
- Lead do CRM vira conversa: recebe um lead do seu sistema, cria o contato e manda o template de boas-vindas.
- Transbordo avisa no Slack: quando alguém pede atendente, a equipe recebe com o link da conversa.
- Conversa encerrada alimenta a planilha: cada atendimento encerrado vira uma linha no Google Sheets, com a nota que o cliente deu.
Servem tanto para usar direto quanto para copiar a estrutura no seu próprio fluxo.
Dicas para um bom resultado
Use a chave de teste até o fim. Com ela os eventos disparam de verdade e você vê o fluxo rodando inteiro, mas nada chega no WhatsApp do cliente. É a diferença entre errar em silêncio e errar na frente de alguém.
O n8n precisa estar acessível pela internet. A Wevichat entrega o evento no endereço do seu fluxo, então ele precisa ser um endereço público e em
https. Se você roda o n8n no seu computador, use o modo de teste do n8n com um túnel, senão o gatilho recusa a ativação e explica o motivo.Um fluxo por assunto. Em vez de um fluxo gigante escutando dez eventos, faça um para cada coisa. Fica mais fácil descobrir qual quebrou.
Cuidado com laço infinito. Se o fluxo responde no WhatsApp e também escuta "Mensagem enviada", ele chama a si mesmo para sempre. Escute "Cliente mandou mensagem", que só dispara com mensagem de entrada.
Confira o log quando algo não rodar. A aba Desenvolvedores mostra as requisições dos últimos 7 dias, com o resultado de cada uma. Ali você vê se o evento saiu daqui e o que aconteceu.
Se preferir não instalar nada
O bloco de HTTP Request comum do n8n continua funcionando. Aponte para https://api.wevi.chat/functions/v1/<endpoint> com o cabeçalho Authorization: Bearer <sua-chave>. Dá mais trabalho de configurar, mas alcança qualquer endpoint da API.
E depois?
- Conectar a Wevichat a outros sistemas, para entender o quadro geral.
- Receber avisos de eventos, se você quiser receber os eventos no seu próprio servidor em vez do n8n.
- Automações no WhatsApp, caso o que você precisa já exista pronto no painel, sem ferramenta externa.
- Documentação técnica da API.