@wevichat/n8n-nodes-wevichat

Nó da Wevichat para o n8n. Manda mensagem no WhatsApp, cuida de contatos e conversas, e conversa com os seus agentes de IA sem escrever uma linha de código.

n8n é uma ferramenta de automação com licença fair-code.

Instalar

No n8n, vá em Settings → Community Nodes → Install e informe:

@wevichat/n8n-nodes-wevichat

Em instalação própria, dá para instalar direto:

cd ~/.n8n/nodes
npm install @wevichat/n8n-nodes-wevichat

Credencial

Crie uma chave em app.wevi.chat, em Conta → Desenvolvedores → API Keys, e cole no campo da credencial.

Comece por uma chave de teste. Marque "Chave de teste" ao criar e ela sai com o prefixo wevi_test_: tudo funciona igual, a resposta vem completa, os gatilhos disparam, e nada chega no WhatsApp de verdade. Troque pela chave normal quando o fluxo estiver pronto.

O botão de testar a credencial busca a sua organização e mostra se a chave vale.

Nó Wevichat

Contato

• Criar ou atualizar: identifica por email ou telefone, com nome, campos personalizados e etiquetas
• Buscar por email, telefone ou id
• Listar com filtros de busca, etiqueta, etapa e data de alteração
• Aplicar etiqueta
• Mover de etapa no funil

Mensagem

• Enviar: texto, template, imagem, documento, áudio, vídeo, botões, lista e link com botão
• Buscar por wamid, para saber se aquela mensagem foi entregue e lida

O campo de template lista só os aprovados pela Meta e já mostra quantas variáveis cada um pede. O número de envio é escolhido numa lista; com um número só na conta, pode deixar vazio.

Texto livre só chega dentro da janela de 24 horas depois da última mensagem do cliente. Fora dela, use template.

Conversa

• Listar, com filtro por situação, canal e quem está esperando atendente
• Buscar, responder, encerrar
• Pedir atendente humano
• Pausar a IA por N minutos
• Aplicar etiqueta

Agente

• Conversar: o agente responde com base de conhecimento, ações e transbordo, dentro do seu fluxo
• Listar

Mandando o mesmo "ID do usuário no seu sistema" nas próximas execuções, a conversa continua de onde parou.

Nó Wevichat Trigger

Dispara o fluxo quando algo acontece: mensagem nova, pedido de atendente, contato mudando de etapa, campanha terminando, template aprovado pela Meta. São 30 eventos.

O nó cria o webhook na Wevichat sozinho ao ativar o fluxo, e remove ao desativar. Cada evento que chega tem a assinatura conferida antes de entrar no fluxo, então ninguém consegue forjar um evento apontando para a sua URL.

Precisa de URL https e pública: em desenvolvimento, use o modo de teste do n8n com túnel.

Exemplos

Avisar no Slack quando alguém pedir atendente
Wevichat Trigger (conversation.handoff_requested) → Slack

Criar o contato quando fecha venda no seu sistema
Webhook → Wevichat (Contato, criar ou atualizar) → Wevichat (Mensagem, enviar template)

Responder no WhatsApp com a resposta do agente
Wevichat Trigger (message.received) → Wevichat (Agente, conversar) → Wevichat (Conversa, responder)

Recusa da Meta para o fluxo

Quando a Meta recusa um envio, a API responde 200 com status: "failed" e o motivo. O nó trata isso como erro, para o problema não passar despercebido no meio do fluxo. Se você prefere seguir mesmo assim, ligue "Continue on Fail" no nó.

Desenvolvimento

# O n8n-workflow puxa um módulo nativo (isolated-vm) que não compila em todo
# ambiente. Aqui ele serve só para os tipos, então pule os scripts de build.
npm install --ignore-scripts
npm run build

Para testar no n8n local:

npm run build
npm link
cd ~/.n8n/nodes && npm link @wevichat/n8n-nodes-wevichat
n8n start

Documentação

• Guias e referência: https://wevi.chat/docs/api
• Especificação OpenAPI: https://api.wevi.chat/functions/v1/openapi

Licença

MIT

Fluxos prontos

A pasta fluxos/ traz três fluxos para importar e adaptar:

• Lead do CRM vira conversa: recebe um lead, cria o contato e manda o template de boas-vindas.
• Transbordo avisa no Slack: cliente pediu atendente, a equipe recebe com o link da conversa.
• Conversa encerrada alimenta a planilha: cada atendimento encerrado vira uma linha no Sheets.