Documentação

Tudo sobre o UniverZAP

Plataforma de atendimento, automação e vendas via WhatsApp, Instagram, e-mail e web, com fluxos inteligentes, Agente de IA, funis Kanban e metas. Esta é a referência completa do produto.

Introdução

O UniverZAP centraliza todas as conversas dos seus canais em uma única caixa de entrada, automatiza atendimento com fluxos e IA, organiza oportunidades em funis e mede resultados com metas e relatórios. É multi-tenant, dark-first e construído para escala.

Omnichannel

WhatsApp, Instagram, e-mail e formulários web em um só lugar.

Automação

Chatflow visual + agentes de IA com base de conhecimento.

Vendas

Funis Kanban, tarefas, metas e campanhas de disparo.

Inteligência

Relatórios, copiloto e onboarding guiado.

Primeiros passos

Do zero ao primeiro atendimento em minutos.

Acesse a plataforma em app.univerzap.cloud/app e entre com seu e-mail (magic link) ou senha.
Conecte sua primeira caixa de entrada em Configurações → Caixas de entrada → Adicionar. Para WhatsApp, veja a seção WhatsApp.
Convide seu time em Configurações → Agentes e organize em times.
Siga o onboarding guiado — o botão circular (foguete) no canto inferior direito abre o tutorial passo a passo com destaque na tela.

💡

Dica: o widget de onboarding aparece só para contas novas e some quando o essencial está configurado. Se algo for desfeito, ele reaparece.

Conceitos-chave

Termo	O que é
Conta	Workspace isolado (multi-tenant). Cada cliente tem a sua.
Caixa de entrada	Um canal conectado (um número de WhatsApp, um e-mail, etc.).
Conversa	Thread de mensagens com um contato em um canal.
Agente	Usuário do time que atende conversas.
Chatflow	Fluxo automatizado de mensagens, menus e ações.
Funil	Pipeline Kanban com estágios para oportunidades.
Agente de IA	Agente automático com base de conhecimento (RAG) que atende sozinho.

Caixa de entrada

O coração do atendimento. Toda mensagem recebida vira uma conversa atribuível, etiquetável e resolvível.

Status de conversa

Aberta — aguardando ação do time.
Pendente — aguardando o cliente.
Resolvida — encerrada (reabre se o cliente responder).

Recursos

Atribuição a agentes e times.
Etiquetas (labels) para categorizar e filtrar.
Respostas rápidas (canned responses) e notas privadas.
Mover para Kanban direto da conversa.

O UniverZAP conecta WhatsApp de duas formas:

	WAHA (não-oficial)	Cloud API (oficial Meta)
Conexão	QR Code no celular	App Meta + número verificado
Menus interativos	Texto numerado	Botões/listas nativas
Risco de ban	Maior	Menor (oficial)
Indicado para	Início / volume baixo	Operação séria / escala

⚠️

Em canais WAHA, menus saem como texto numerado — botões e listas interativas só existem na Cloud API oficial.

Coexistência

Desde 2025 o mesmo número pode rodar o app do WhatsApp Business e a Cloud API simultaneamente (coexistência Meta). Útil para migrar de WAHA para oficial sem perder o número.

Conectar WhatsApp não oficial (WAHA)

Vá em Configurações → Caixas de entrada → Adicionar e escolha WhatsApp.
Em provedor, escolha WhatsApp - API Não Oficial.
Escolha Criar nova sessão (número novo) ou Conectar sessão existente (a sessão já existe no seu servidor WAHA).
Preencha o Nome da sessão — este é obrigatório. Use algo curto e sem espaço, como time-vendas.
O Nome da caixa de entrada é opcional: deixando em branco, ela recebe o nome da sessão. É só o nome que aparece na sua lista, como WhatsApp Vendas.
Clique em Gerar QR code.
No celular, abra o WhatsApp e vá em Configurações → Dispositivos conectados → Conectar dispositivo. Escaneie o código da tela.
Espere aparecer Sessão conectada e clique em Concluir configuração.

💡

O QR code expira. Se ele vencer antes de você escanear, volte e gere outro — não adianta insistir no antigo.

Contatos

Cada pessoa que fala com você vira um contato com histórico unificado entre canais. Suporta atributos personalizados, notas, e importação. Contatos alimentam campanhas e funis.

Chatflow

Construtor visual de fluxos automatizados. Arraste nós, conecte e publique. Dispara na primeira mensagem (com cooldown configurável) e tem modo teste que gateia o fluxo para um único número antes de ir ao ar.

Tipos de nó

Enviar mensagem / áudio / mídia
Menu — opções numeradas que ramificam o fluxo
Etiqueta — aplica/remove labels
Atribuir agente
Adicionar ao Kanban
Webhook — integra sistemas externos
Encerrar fluxo

💡

Sempre teste antes: ative o modo teste e aponte para o seu número. O fluxo dispara só para ele, mesmo em rascunho — zero risco de spammar clientes.

Agente de IA

Agentes de IA que respondem com base no seu conhecimento.

Agentes: defina nome, prompt e comportamento.
RAG (base de conhecimento): suba documentos e a IA responde com contexto real.
Copiloto: sugere respostas ao atendente dentro da conversa.
Créditos: uso de IA é medido em créditos; acompanhe o saldo no painel do Agente de IA.

Campanhas

Disparo de mensagens em massa para listas de contatos.

Cloud API oficial — templates aprovados pela Meta com mapeamento completo de variáveis (nome do contato, pedido, etc.).
Segmentação por etiquetas e atributos.
Agendamento e acompanhamento de entrega.

📋

Campanhas via template exigem variáveis mapeadas corretamente — o nome do contato e demais tokens são resolvidos por destinatário no envio.

Funis Kanban

Organize oportunidades em pipelines visuais. Cada funil tem estágios (colunas) e cards arrastáveis.

Crie múltiplos funis (ex.: Vendas, Suporte, Pós-venda).
Mova cards entre estágios por arrastar-e-soltar.
Vincule conversas e contatos a um card.
Cards têm prioridade, responsáveis, etiquetas, datas e anexos.

Tarefas

Gestão de trabalho do time, separada dos funis. Aba Tarefas na barra lateral.

Criar tarefa com título, descrição, responsáveis, urgência e prazo.
Anexos — fotos, imagens, arquivos (zip/tar), vídeos. Adicione ao criar ou dentro da tarefa aberta.
Recorrência — tarefas que se repetem automaticamente.
Converter para card Kanban quando virar oportunidade.
Comentários, feed de atividade e relatórios de carga do time.

📎

Anexos: abra a tarefa (ou o modal de criação) → seção Anexos → Adicionar anexo. Suporta múltiplos arquivos de uma vez.

Metas

Defina objetivos e acompanhe o progresso em tempo real.

Metas de venda — valor em R$, com registro de venda (número do pedido + data de pagamento).
Metas personalizadas (contadores) — qualquer unidade contável (ex.: "Depoimentos", "Reuniões"), medida por número em vez de R$.
Cada card de meta mostra o realizado vs. o alvo.

Relatórios

Visão de desempenho: volume de conversas, tempo de resposta, resolução, produtividade por agente e por time, evolução de metas. Use para decisões e acompanhamento de SLA.

Guia: montar seu 1º bot

Conecte uma caixa de entrada de WhatsApp.
Vá em Chatflow → Novo fluxo.
Adicione um nó de saudação (Enviar mensagem).
Adicione um nó de Menu com as opções (ex.: 1 Vendas, 2 Suporte).
Para cada opção, conecte um nó de Atribuir agente ou Etiqueta.
Ative o modo teste, aponte para o seu número e valide.
Publique. Pronto — atendimento automático no ar.

Guia: criar um funil de vendas

Vá em Kanban → Novo funil e nomeie (ex.: "Vendas 2026").
Defina os estágios (ex.: Novo lead → Qualificado → Proposta → Fechado).
Dentro de uma conversa, use Mover para Kanban para criar o card.
Arraste os cards conforme a oportunidade avança.
Acompanhe conversão por estágio nos Relatórios.

API & Webhooks

O UniverZAP expõe uma API REST por conta. Endpoints são account-scoped:

GET /api/v1/accounts/:account_id/conversations
POST /api/v1/accounts/:account_id/conversations/:id/messages

Autentique com o token de acesso do agente (header api_access_token). Webhooks notificam eventos (mensagem recebida, conversa criada/resolvida) para a URL configurada. Referência viva da API em /api.

🔑

Mantenha tokens em sigilo. Nunca exponha api_access_token em código cliente ou repositórios públicos.

Segurança & LGPD

Isolamento multi-tenant por conta.
Dados tratados conforme a LGPD; canal do DPO disponível.
Exclusão de conta e dados pelo titular (Art. 18 VI da LGPD).

Consulte os Termos de Uso e a Política de Privacidade.

Versões

Documentação versionada. Versão atual: v2026.06.

Versão	Data	Novidades
`2026.06`	21/06/2026	Anexos em Tarefas, documentação pública /docs, metas personalizadas.
`2026.05`	28/05/2026	Onboarding guiado estilo ClickUp, Chatflow humanizado, paleta UniverZAP #13CB8D.
`2026.04`	30/04/2026	Construtor de Chatflow, funis Kanban, agentes de IA.
`2026.03`	31/03/2026	Campanhas com variáveis de template, relatórios e metas.

FAQ

Meu número de WhatsApp pode ser banido?

O risco existe em canais não-oficiais (WAHA). A Cloud API oficial reduz drasticamente esse risco. Respeite as políticas do WhatsApp Business.

Posso migrar de WAHA para a API oficial sem trocar de número?

Sim. A coexistência da Meta permite rodar ambos no mesmo número durante a transição.

O onboarding sumiu, é normal?

Sim. Ele aparece só para contas novas e some quando o essencial está configurado. Reaparece se algo for desfeito.

Como adiciono anexos a uma tarefa?

Abra a tarefa (ou o modal de criação) → seção Anexos → Adicionar anexo.

Suporte

Precisa de ajuda? Fale com a gente:

Suporte: suporte@univerbeauty.com.br
Privacidade / DPO: privacidade@univerbeauty.com.br