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