Blog UzzAIDúvidas Frequentes

FAQ Completo — UzzApp

Guia por pilares com 55+ respostas: conta, WhatsApp, conversas, CRM, RAG, fluxos, calendário, traces, Meta Ads, AI Gateway, faturamento e glossário.

04/05/2026•16 min•Por Equipe Uzz.Ai

Role para descobrir a jornada completa

SUMÁRIO

26 seções

Buscar no FAQ

Bem-vindo ao FAQ Completo do UzzApp! Aqui você encontra respostas para as dúvidas mais comuns sobre contas, onboarding, operação do painel, análise e muito mais. Se sua dúvida não estiver aqui, entre em contato com o suporte — respondemos em até 24 horas.

1️⃣ Conta e Acesso

Problemas de login, convites e eliminação de dados.

**Não consigo iniciar sessão.** Verifique email e senha, confirme o email em `/check-email`, limpe cache do browser (Ctrl+Shift+Del). Se persistir, contacte suporte@uzzai.com.br.
**Convite expirou ou link inválido.** Peça novo convite a um administrador da conta UzzAi em `/accept-invite`.
**Conta "Pendente de Aprovação".** Significa que a conta foi criada mas aguarda aprovação interna (até 24h). Será notificado por email.
**Como pedir eliminação dos meus dados?** Aceda a `/delete-account`, siga os passos legais indicados, confirme por email. Dados apagados em até 72 horas (LGPD compliant).

2️⃣ Primeiro Uso e WhatsApp

Onboarding, conexão Meta, e primeiras mensagens.

**Onde ligo o WhatsApp Business?** Após primeiro login, acesse a `/onboarding` OU vá a **Gestão > Integrações Meta** em `/dashboard/settings`. Siga o fluxo OAuth com Meta, confirme número. Pré-requisito: conta com permissão em Facebook Business / WhatsApp Business.
**O bot não responde a mensagens.** Checklist: número verificado na Meta? Token de acesso ativo (reconecte em Configurações se expirou)? Agente ativo em `/dashboard/agents`? Sem erros nos Traces (`/dashboard/traces`)?
**Mensagens duplicadas ou atrasadas.** Abra **Traces** (`/dashboard/traces`), filtre pela conversa, verifique timestamps. Se persistir, abra ticket suporte N2.
**Qual é o tempo de resposta do bot?** Com Groq: 1–2 segundos (muito rápido). Com OpenAI: 3–5 segundos. Pode ser mais lento se precisa consultar a base de conhecimento (RAG).

3️⃣ Dashboard Principal

Conversas, contactos, e operação diária.

**Onde vejo todas as conversas?** Em `/dashboard/conversations`. Uma conversa agrupa múltiplas mensagens entre cliente e bot, criada automaticamente.
**Diferença entre "Conversas" e "Chat"?** **Conversas** é a vista principal de todas interações por cliente. **Chat** é variante alternativa (se exposta). Use **Conversas** como entrada principal.
**Como transferir conversa para humano?** Abra a conversa, clique "Transferir para suporte". Bot invoca `transferir_atendimento` e notifica suporte por email. Configure email de notificação em **Gestão > Configurações**.
**Onde está a lista de contactos?** Em `/dashboard/contacts`. Contacto = pessoa que interagiu via WhatsApp (telefone, nome, metadata). Criado automaticamente ao primeiro inbound.

4️⃣ Gestão — CRM, Templates e Contatos

Pipeline Kanban, envios de mensagens, e organização de leads.

**Como funciona o pipeline Kanban (CRM)?** Em `/dashboard/crm`, mova cartões entre colunas (lead → oportunidade → cliente). Movimentos manuais ou por automação. Se cartão não move, verifique permissões e erros no F12 (DevTools).
**Como criar templates de mensagem?** Em `/dashboard/templates`, clique "Novo Template", escolha categoria Meta (ex.: Marketing), preencha conteúdo (max 1024 caracteres), envie para aprovação Meta (até 24h). Use em campanhas após aprovação.
**Qual é a diferença entre envios e campanhas?** Envios = mensagens simples/diretas. Campanhas = disparos em massa com agendamento e segmentação. Contacte suporte para funcionalidades avançadas.
**O bot está invadindo a privacidade dos clientes?** Não. Enviamos apenas para contactos que deram opt-in. Mantenha boas práticas: respeite frequência, use templates aprovados, siga regulamentações (LGPD, GDPR).

5️⃣ Agentes IA e Base de Conhecimento (RAG)

Configuração de IA, documentos, e respostas inteligentes.

**Como envio PDFs para o bot "ler"?** Em `/dashboard/knowledge`, clique "Carregar Documento", selecione PDF/TXT. Bot indexa automaticamente (até 5 min). Depois ative RAG em `/dashboard/agents`. Verifique Traces (`buscar_conhecimento`) para confirmar retrieval.
**O bot inventa respostas ou ignora a base de conhecimento.** Causas: (1) Prompt muito aberto — edite para "responda apenas com base em documentos"; (2) RAG desativado — ative em Agentes; (3) Limiar alto demais — reduza `rag_threshold` para ≤ 0.5; (4) Documentos mal estruturados — revise índices. Debug: Traces → buscar_conhecimento.
**Quantos agentes posso ter?** Depende do plano: iniciais = 1, avançados = até 5–10. Configure em `/dashboard/agents`. Use para diferentes personalidades, horários ou testes A/B.
**Groq vs OpenAI — qual escolher?** Groq (Llama 3.3): 1–2 seg, muito barato, gratuito com limites. OpenAI (GPT-4o): 3–5 seg, qualidade premium, custo maior. Comece com Groq, mude para OpenAI se precisar qualidade máxima.
**O bot entende português com gírias e erros de ortografia?** Sim. Modelos modernos (Llama 3.3 e GPT-4o) compreendem muito bem português informal, incluindo gírias regionais e erros de digitação.

6️⃣ Fluxos Interativos (Automação)

Builder visual de fluxos, lógica condicional e integrações.

**Onde edito o fluxo visual (builder)?** Em `/dashboard/flows` (listar) → `/dashboard/flows/[id]/edit` (editar). Fluxo = grafo de nós que define ramificações, integrações e lógica condicional.
**Como testar um fluxo?** (1) Envie mensagem de teste no WhatsApp real; (2) Use tela de teste na UI (se disponível); (3) Verifique Traces (`/dashboard/traces`) para ver o caminho tomado no fluxo.
**O fluxo não está funcionando como esperado.** Verifique: (1) Nós ligados corretamente? (2) Condições de roteamento definidas? (3) Tools habilitadas (calendário, transferência)? Debug via Traces.

7️⃣ Calendário e Agendamentos

Google Calendar, Outlook, e automação de agendas.

**Como ligo Google Calendar ou Outlook?** Em `/dashboard/calendar`, clique "Conectar Google" ou "Conectar Microsoft", autorize com credenciais, selecione calendário. Depois configure agente em `/dashboard/agents` → Tools → "Calendário".
**Evento não foi criado após confirmação do cliente.** Checklist: (1) Calendário conectado? (2) Agente com tool ativada? (3) Metadata obrigatória (nome, email, data)? (4) Trace mostra `criar_evento_agenda`? Debug: Traces → busque a tool call, verifique argumentos.
**Quais formatos de data o bot entende?** Formatos comuns (DD/MM/YYYY, "próxima terça", "em 3 dias"). Se ambíguo, o agente pede confirmação. Use prompt claro: "confirme data no formato DD/MM/YYYY".

8️⃣ Análise e Qualidade

Traces, debugging, e avaliação de respostas.

**O que é um "Trace"?** Registro detalhado do processamento: modelo usado, retrieval (RAG), tool calls, erros, timestamps. Rota: `/dashboard/traces`. Use para diagnóstico de respostas erradas ou ferramentas falhadas.
**Fila de suporte automático (bugs).** Em `/dashboard/support-bugs`, casos detectados automaticamente como problemas (bot silencioso, resposta vazia, erro de tool call). Reveja, marque como "Resolvido" ou "Precisa ação".
**O que significam PASS / REVIEW / FAIL na qualidade?** PASS = resposta correta. REVIEW = aceitável mas merece revisão humana. FAIL = incorreta. Rota: `/dashboard/quality`. Configure gabarito em `/dashboard/quality/ground-truth`.
**Como ligo desempenho a anúncios Meta?** Em `/dashboard/meta-ads`, quando disponível na sua conta, siga a configuração de atribuição e eventos conforme a Meta.
**Onde comparo custos ou analytics de modelos?** Em `/dashboard/analytics-comparison`, quando habilitado — útil para comparar uso interno vs. referências oficiais dos provedores.
**Como melhorar a qualidade das respostas?** (1) Edite prompt do agente (`/dashboard/agents`); (2) Adicione mais documentos relevantes (`/dashboard/knowledge`); (3) Teste com Traces; (4) Itere com A/B testing se disponível.

9️⃣ AI Gateway (Avançado)

Operação avançada: budget, cache, validação.

**Para que serve o AI Gateway?** Módulo para: gestão centralizada de modelos, budget/limites de tokens, cache de prompts (reduz custo), validação de chamadas, testes de API. Público: clientes avançados, N2. Rota: `/dashboard/ai-gateway`.
**Como configurar budget de tokens?** Em `/dashboard/ai-gateway/budget`, defina limite mensal (ex.: $500). Bot para ao atingir limite. Alertas por email ao aproximar-se.
**Qual é o benefício do cache?** Reduz custo (embeddings reutilizados = sem pagamento repetido) e latência (resposta mais rápida). Exemplo: 100 clientes perguntam "Como usar templates?" → embedding calculado 1× e reutilizado 100×. Configure em `/dashboard/ai-gateway/cache`.

🔟 Configurações e Faturação

Planos, faturas, e cobrança de IA.

**Onde vejo minha assinatura e faturas?** Em `/dashboard/billing`. Contém: plano atual, histórico de faturas, método de pagamento, próxima renovação.
**Como alterar meu plano?** Em `/dashboard/billing`, clique "Upgrade" ou "Downgrade", escolha novo plano, confirme. Mudança entra em vigor no próximo período de cobrança.
**Como funciona a cobrança de IA?** Assinatura UzzApp = mensal (inclui UI, infraestrutura). IA = separado por uso (tokens). Groq: barato. OpenAI: mais caro. Acompanhe em `/dashboard/analytics` ou `/dashboard/ai-gateway/budget`.
**A Meta cobra por mensagem?** Sim. Conversa de entrada (inbound) = 24h grátis. Conversa de saída com template = cobrada por categoria/país. Ver custos em Meta Business Platform → WhatsApp → Billing.
**Como posso limitar gastos com IA?** (1) Configure budget em AI Gateway; (2) Escolha Groq em vez de OpenAI (até 10× mais barato); (3) Use cache; (4) Monitore Traces para tool calls desnecessários.

1️⃣1️⃣ Diagnóstico e Suporte

Saúde do sistema, troubleshooting e contato com suporte.

**Página de diagnóstico do ambiente.** Em `/diagnostico`. Verifica: saúde Meta, status BD, erros recentes. Público: clientes com acesso, suporte N2.
**Como abro um ticket de suporte?** Email: suporte@uzzai.com.br. SLA: resposta em até 24 horas. Inclua: screenshot do erro, URL da rota, Trace ID, passos para reproduzir.
**O bot parou de responder de repente. O que fazer?** Verifique: (1) Token de Meta expirou? (2) Budget de IA atingido? (3) Webhook desativado? (4) Agente desativado? Rota: Dashboard → Debug logs.
**O bot está respondendo fora do esperado.** Edite prompt em `/dashboard/agents`, seja mais específico, teste após cada ajuste no WhatsApp real.
**Transcrição de áudio está errada.** Ruído, sotaque ou áudio baixo afetam precisão. Whisper (OpenAI) é muito bom mas não perfeito — qualidade de áudio impacta diretamente.

📚 Glossário

Termos técnicos do UzzApp.

**Agente** — Configuração de personalidade, modelo, RAG, tools e prompts. `/dashboard/agents`.
**AI Gateway** — Módulo avançado: budget, cache, validação, testes. `/dashboard/ai-gateway`.
**CAPI** — Conversions API da Meta para atribuição de eventos a campanhas.
**Cliente / Tenant** — Organização que usa UzzApp; `client_id`, dados isolados.
**Contato** — Registro de pessoa que interagiu via WhatsApp (telefone, metadata).
**CRM** — Pipeline Kanban de cartões (leads/oportunidades).
**Documentos (RAG)** — Arquivos indexados para busca semântica (PDF, TXT).
**Embedding** — Representação vetorial de texto usada na pesquisa semântica.
**Flow / Fluxo** — Grafo de nós que define ramificações, lógica, integrações.
**Ground Truth** — Gabarito de respostas esperadas para avaliação automática.
**Handoff** — Transferência de conversa para humano (tool `transferir_atendimento`).
**RAG** — Retrieval-Augmented Generation: modelo consulta base de conhecimento antes de responder.
**Template** — Modelo de mensagem aprovado pela Meta para envios proativos.
**Tool Call** — Chamada a função pelo modelo (ex.: `buscar_conhecimento`, `criar_evento_agenda`). Visível em Traces.
**Trace** — Registo detalhado do processamento: modelo, RAG, tools, erros.
**TTS** — Text-to-Speech; resposta em áudio se ativado.
**Webhook** — Endpoint que recebe eventos da Meta (mensagens, status).

Não encontrou sua resposta?

Nossa equipe de suporte está disponível para ajudar você a resolver qualquer dúvida sobre o UzzApp.

Falar com Suporte →