n8n-nodes-zappro-viis

Node comunitário para integrar o ZAP PRO by VIIS com o n8n, permitindo automatizar atendimentos, tickets, contatos, mensagens e muito mais.

---

📋 Índice

• Sobre
• Pré-requisitos
• Instalação
• Configurando as Credenciais
• Recursos e Operações
• Exemplos de Uso
• Troubleshooting
• Suporte
• Licença

---

📌 Sobre

Este node permite conectar o ZAP PRO by VIIS ao n8n, possibilitando criar automações completas de atendimento via WhatsApp sem escrever código.

Com ele você pode, por exemplo:

• Criar tickets automaticamente ao receber um lead
• Enviar mensagens personalizadas via WhatsApp
• Atualizar o status de tickets com base em eventos externos
• Sincronizar contatos entre sistemas
• Gerenciar filas, tags e kanban de forma automática

🔗 Site oficial: https://viis.digital

---

✅ Pré-requisitos

• n8n versão 0.187.0 ou superior
• Uma conta ativa no ZAP PRO by VIIS
• Acesso à API ID e Bearer Token da sua conta

---

📦 Instalação

Pelo painel do n8n (recomendado)

1. Acesse seu n8n
2. Vá em Settings → Community Nodes
3. Clique em Install
4. Digite o nome do pacote:

   n8n-nodes-zappro-viis
   

5. Clique em Install e aguarde
6. Reinicie o n8n se necessário

Via linha de comando

npm install n8n-nodes-zappro-viis

---

🔐 Configurando as Credenciais

Após instalar o node, você precisa configurar suas credenciais:

1. No n8n, vá em Credentials → Add Credential
2. Busque por ZAP PRO VIIS API
3. Preencha os campos:

Campo	Descrição	Onde encontrar
Base URL	URL base da sua instância	Ex: app.viis.digital (sem https://)
API ID	ID da sua API	Painel ZAP PRO → Configurações → API
Bearer Token	Token de autenticação	Painel ZAP PRO → Configurações → API

4. Clique em Save — o n8n vai testar a conexão automaticamente

---

🚀 Recursos e Operações

👤 Contato

Operação	Descrição
Criar	Cria um novo contato
Atualizar	Atualiza dados do contato
Buscar	Pesquisa contatos por nome, número, CPF, etc
Exibir por Número	Retorna dados de um contato pelo número do WhatsApp
Bloquear / Desbloquear	Bloqueia ou desbloqueia um contato
Info Extra	Obtém campos personalizados do contato
Atualizar Info Extra	Atualiza campos personalizados do contato
Atualizar Kanban	Move o contato para uma coluna do kanban
Atualizar Carteira	Atribui o contato a uma carteira

---

🏷️ Kanban / Tags / Motivos / Filas

Operação	Descrição
Criar / Listar / Atualizar / Deletar Kanban	Gerencia colunas do kanban
Criar / Listar / Atualizar / Deletar Tag	Gerencia tags de atendimento
Criar / Listar / Atualizar / Deletar Motivo	Gerencia motivos de encerramento
Criar / Listar / Atualizar / Deletar Fila	Gerencia filas de atendimento

---

📨 Mensagem

Operação	Descrição
Enviar Texto	Envia mensagem de texto via WhatsApp
Enviar Arquivo por URL	Envia imagem, documento ou outro arquivo via URL
Enviar Áudio	Envia mensagem de voz
Enviar Localização	Envia uma localização no mapa
Buscar por ID	Retorna uma mensagem pelo seu ID
Buscar Mensagens do Ticket	Lista mensagens de um ticket com filtro de busca

---

🎫 Ticket

Operação	Descrição
Criar Ticket	Abre um novo ticket de atendimento
Listar Tickets	Lista tickets com filtro de status e paginação
Exibir por Número	Retorna o ticket ativo de um número
Exibir por ID	Retorna um ticket específico pelo ID
Atualizar Info	Atualiza status, responsável e fila do ticket
Adicionar Tag	Adiciona uma tag ao ticket
Remover Tag	Remove uma tag do ticket
Definir Fila	Move o ticket para uma fila
Criar Nota	Adiciona uma nota interna ao ticket
Listar Notas	Lista as notas de um ticket
Listar Mensagens	Retorna todas as mensagens de um ticket

---

👥 Usuário

Operação	Descrição
Criar	Cria um novo usuário no sistema
Listar	Lista todos os usuários com paginação
Status	Retorna o status atual de um usuário
Atualizar	Atualiza nome e email de um usuário

---

💡 Exemplos de Uso

Criar um ticket ao receber um lead

1. Trigger: Webhook recebe dados do lead
2. Node ZAP PRO: Recurso Contato → Operação Criar
   • Nome: {{ $json.nome }}
   • Número: {{ $json.telefone }}
3. Node ZAP PRO: Recurso Ticket → Operação Criar Ticket
   • Número: {{ $json.telefone }}
   • Mensagem Inicial: Olá {{ $json.nome }}, recebemos seu contato!

---

Enviar mensagem após pagamento confirmado

1. Trigger: Webhook da plataforma de pagamento
2. Node ZAP PRO: Recurso Mensagem → Operação Enviar Texto
   • Número: {{ $json.telefone }}
   • Mensagem: Seu pagamento foi confirmado! Obrigado, {{ $json.nome }} 🎉
   • External Key: {{ $json.pedido_id }}

---

Fechar ticket e atribuir motivo

1. Trigger: Evento externo (ex: CRM marcou como resolvido)
2. Node ZAP PRO: Recurso Ticket → Operação Atualizar Info
   • Ticket ID: {{ $json.ticketId }}
   • Status: closed

---

🔧 Troubleshooting

❌ Erro 401 - Unauthorized

• Verifique se o Bearer Token está correto e não expirou
• Confirme que o token tem permissões de API externa

❌ Erro 404 - Not Found

• Confirme se a Base URL está correta (sem https:// e sem / no final)
• Verifique se o API ID está correto

❌ Node não aparece após instalar

• Reinicie o n8n após a instalação
• Verifique se a versão do n8n é 0.187.0 ou superior

❌ Mensagem não enviada

• Certifique-se que o número está no formato 5511999999999 (com DDI e DDD, sem espaços ou símbolos)
• Verifique se o External Key é único por envio

---

🆘 Suporte

Encontrou um problema ou tem uma sugestão?

• 🌐 Site: https://viis.digital
• 📦 npm: https://www.npmjs.com/package/n8n-nodes-zappro-viis
• 🐛 Issues: Abra uma issue no repositório do GitHub

---

📄 Licença

MIT © VIIS Digital