vixzap

Nó do n8n para o VixZap (API de WhatsApp): gatilho com webhook assinado e ações de envio, instâncias e verificação de número.

Package Information

Released: this month
Downloads: 0 weekly / 0 monthly
Latest Version: 0.1.0
Author: VixNegócios

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

  1. VixZap Trigger — instância do seu número, evento Mensagem recebida, filtro Só contatos.
  2. IF — {{$json.text}} contém "horário".
  3. 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)

Discussion