Package Information
Documentation
@vixnegocios/n8n-nodes-vixzap
Nó comunitário do n8n para o VixZap (API de WhatsApp com hub de webhooks).
- VixZap Trigger — dispara quando chega um evento do WhatsApp (mensagem recebida, status, conexão…). Ao ativar o fluxo, o
nó cria o endpoint no hub do VixZap apontando para o webhook do n8n e verifica a assinatura HMAC de cada entrega;
ao desativar, apaga o endpoint. - VixZap — ações: enviar texto, mídia, localização, botões, lista e reação; consultar status de mensagem; listar/consultar
instâncias e fila; verificar números.
Instalação
n8n próprio (self-hosted): Configurações → Community Nodes → Install → informe @vixnegocios/n8n-nodes-vixzap. Precisa da
variável N8N_COMMUNITY_PACKAGES_ENABLED=true (padrão) na instância.
Ou pela linha de comando, na pasta do n8n:
npm install @vixnegocios/n8n-nodes-vixzap
e reinicie o n8n.
n8n Cloud: só aceita community nodes verificados pelo n8n. Enquanto este pacote não for verificado, use o nó HTTP Request
com uma credencial Header Auth (Authorization: Bearer vz_live_…) e o nó Webhook para receber os eventos.
Credencial
VixZap API: token vz_live_… criado em Portal → Tokens de API. Escopos: instances:read (listar instâncias),messages:send (enviar), webhooks:manage (gatilho).
Exemplo: responder automaticamente
- VixZap Trigger — instância do seu número, evento Mensagem recebida, filtro Só contatos.
- IF —
{{$json.text}}contém "horário". - VixZap → Enviar Texto — Para:
{{$json.phone}}, Texto: "Atendemos de 8h às 18h".
A saída do gatilho traz o envelope VixZap (id, type, instanceId, timestamp, data) e atalhos phone, text,pushName, isGroup, deliveryId.
Compatibilidade
n8n ≥ 1.0 · Node ≥ 20.15 · Documentação do VixZap · Licença MIT · VixZap é um produto da VixNegócios (J.C.A dos Anjos)