Perguntas Frequentes (FAQ)
Respostas rápidas sobre conta, WhatsApp, conversas, IA, RAG, CRM, custos, segurança, traces e problemas comuns do UzzApp. Link para o FAQ completo no final da página.

Reunimos abaixo as perguntas que mais recebemos, alinhadas à nossa central de suporte interna. Para o guia completo com glossário, rotas do painel e dezenas de tópicos extras, abra no Help Center: /help/duvidas-frequentes/faq-completo. Se sua dúvida não estiver aqui, fale com o suporte — respondemos em até 24 horas (suporte@uzzai.com.br).
Conta e acesso
- Não consigo fazer login. O que verificar? Confirme e-mail e senha, confirme o cadastro no e-mail de verificação e limpe o cache do navegador. Se o convite expirou, peça um novo convite a um administrador da sua organização.
- Minha conta aparece como “pendente de aprovação”. Significa que a equipe Uzz.Ai ainda precisa liberar o acesso; você será avisado por e-mail quando estiver ativa.
- Como solicitar exclusão dos meus dados? Use o fluxo de exclusão de conta indicado na plataforma (LGPD). Após a confirmação, processamos em até 72 horas, conforme nossa política.
WhatsApp e conexão
- Posso usar meu número pessoal do WhatsApp? Não. O UzzApp usa a API oficial do WhatsApp Business, que exige um número dedicado — não pode ser um número em uso no WhatsApp pessoal ou no aplicativo WhatsApp Business comum no mesmo número.
- Preciso ter o aplicativo WhatsApp Business instalado? Não. Com a API oficial, o número é gerenciado pela plataforma. O app WhatsApp Business não é compatível com a API ao mesmo tempo nesse número.
- Onde conecto o WhatsApp pela primeira vez? No fluxo de integração após o login (onboarding) ou nas configurações de integração Meta / WhatsApp no painel. Siga o passo a passo do Meta com a conta da sua empresa.
- Quantos números posso conectar? Depende do plano. Planos iniciais costumam incluir um número; planos avançados permitem múltiplos números para filiais ou equipes.
- O que é o webhook? É o endereço (URL) que o WhatsApp usa para enviar as mensagens recebidas ao UzzApp. Você configura esse endereço no Meta for Developers apontando para o UzzApp.
- O número pode ser bloqueado pela Meta? Sim, se houver spam, muitos bloqueios ou reclamações. Envie só para quem deu opt-in, use templates aprovados e respeite boas práticas de frequência.
- O bot não responde. Por onde começar? Confira número verificado na Meta, token de acesso válido, agente ativo no painel e erros recentes em Traces (Análise). Mensagens duplicadas ou atrasadas também aparecem ali para diagnóstico.
Conversas e contatos
- Onde vejo todas as conversas? No painel, em Conversas — visão principal das interações com cada cliente.
- Qual a diferença entre “Conversas” e outra entrada de chat? Se ambas existirem no menu, use Conversas como entrada principal; a outra pode ser atalho legado conforme o layout da sua conta.
- Onde fica a lista de contatos? Em Contatos no painel — perfis criados a partir das interações e cadastros da sua operação.
- Como transferir para um humano? Use a transferência de atendimento na conversa (quando habilitado) e configure notificações da equipe nas configurações gerais.
Inteligência artificial e respostas
- Quanto tempo leva para o bot responder? Com Groq (Llama 3.3 70B): em média 1–2 segundos. Com OpenAI (GPT-4o): cerca de 3–5 segundos. Pode demorar mais se a base de conhecimento for consultada (RAG).
- O bot pode responder qualquer assunto? Ele segue o prompt de sistema e os documentos da base. Ajuste o prompt para limitar o escopo ao seu negócio e evitar respostas fora do tom desejado.
- O que acontece se o cliente mandar várias mensagens seguidas? O sistema pode agrupar mensagens em uma janela curta antes de chamar a IA, reduzindo respostas fragmentadas e custo de API.
- O bot entende português informal e erros de digitação? Sim. Modelos atuais lidam bem com gírias regionais e erros comuns.
- Posso ter mais de um agente de IA? Sim — personalidades e prompts diferentes, alternância por regra ou teste, conforme seu plano.
Base de conhecimento (documentos e RAG)
- Como envio PDFs ou textos para o bot usar? Pelo módulo de documentos / base de conhecimento no painel. Depois de indexar, ative o uso de RAG no agente e valide em Traces se a busca (ferramenta de conhecimento) foi chamada.
- O bot inventa ou ignora a base. O que fazer? Enriqueça o prompt (“responda com base nos documentos”), revise limiar e quantidade de trechos recuperados nas configurações do agente e confira nos Traces se a busca na base está sendo executada.
- Quantos agentes e documentos posso ter? Limites variam por plano; consulte seu contrato ou a tela de planos no painel.
CRM, templates, calendário e fluxos
- Onde está o pipeline tipo Kanban? No módulo CRM do painel — arraste cartões entre etapas. Se um cartão não mover, verifique permissões, rede no navegador (F12) e tente atualizar a página.
- Como criar templates de mensagem para a Meta? No módulo de templates: crie o modelo, envie para aprovação da Meta e só use após aprovação, respeitando categoria e opt-in.
- Como conectar Google Calendar ou Microsoft? No módulo de calendário do painel, autorize a conta e vincule o calendário desejado; depois habilite as ferramentas de agenda no agente, se aplicável.
- Se o evento não foi criado após o cliente confirmar, o que checar? Calendário conectado, ferramenta de agenda ativa no agente, dados obrigatórios coletados (nome, e-mail, horário) e Traces da chamada que cria o evento.
- Onde edito fluxos visuais? Na área de fluxos do painel — lista de fluxos e editor por fluxo. Teste com mensagens reais e acompanhe o caminho nos Traces.
Custos e cobrança
- Quanto custa o uso da IA? Em geral o consumo de tokens é cobrado pelos provedores (OpenAI ou Groq) com suas chaves; o Groq costuma ser mais econômico em alto volume. Confirme o modelo do seu contrato Uzz.Ai.
- Como acompanhar custo de IA? Use Analytics e, se disponível, comparativos e orçamentos (budget) no painel para tokens e custo estimado.
- A Meta cobra por mensagem? A cobrança da Meta segue regras de conversa e janela de 24 horas; conversas iniciadas pelo cliente costumam ter tratamento diferente de envios proativos com template. Consulte o painel de faturamento da Meta para o seu país.
- Posso usar o nível gratuito do Groq? Existe camada gratuita com limites; para produção com volume, avalie planos pagos e limites atuais no console do provedor.
Segurança e dados
- Os dados da minha empresa são misturados com outras? Não. O UzzApp é multi-tenant com isolamento: cada organização tem seus dados separados.
- Onde ficam as conversas? Em banco de dados seguro, com controle de acesso por organização e perfil de usuário.
- Minhas chaves de API ficam seguras? Armazenadas de forma criptografada; a equipe não acessa o valor em texto das suas chaves.
- O UzzApp atende à LGPD? Sim — políticas e acordos de tratamento de dados estão disponíveis no site e na plataforma; solicitações de titulares são tratadas no prazo legal.
Análise, Meta Ads, loja e administração
- O que é um trace? É o registro do processamento de uma mensagem (modelo, RAG, chamadas a ferramentas, erros). Use Traces para depurar respostas erradas ou ferramentas que falharam.
- O que são filas de qualidade ou bugs automáticos? Módulos no painel que ajudam a priorizar conversas com falhas ou métricas de qualidade, conforme o que estiver habilitado na sua conta.
- Como ligo desempenho a anúncios Meta? Pelo módulo Meta Ads no painel, quando disponível, seguindo as orientações de atribuição e eventos da Meta.
- Onde vejo assinatura e faturas? Em Faturamento / Billing no painel. Loja pública com a sua marca pode usar rotas de loja/checkout conforme contratação.
- Não vejo menus de “Pagamentos” ou gestão de clientes da Uzz.Ai. Esses itens são restritos a perfis administrativos internos — clientes finais usam apenas o que o plano expõe.
Problemas comuns
- O bot parou de responder de repente. O que fazer? Verifique: token de acesso da Meta válido, orçamento de IA não estourado, webhook ativo e agente ativo. Use Traces e logs de diagnóstico quando existirem.
- O bot responde fora do esperado. Como ajustar? Edite o prompt do agente com instruções mais específicas e teste após cada mudança com mensagens reais.
- A transcrição de áudio está errada. Ruído, sotaque forte ou volume baixo afetam a qualidade. O modelo de transcrição é robusto, mas não infalível.
- O webhook falhou na verificação da Meta. Confira URL exata (incluindo identificadores), token de verificação idêntico ao configurado no Meta for Developers e se o endpoint está público e online.
Quer ir além? O artigo FAQ completo — UzzApp no Help Center (/help/duvidas-frequentes/faq-completo) organiza o mesmo tipo de informação por pilares: conta, WhatsApp, CRM, fluxos, calendário, AI Gateway, glossário de termos e mais — no estilo de uma central de ajuda profissional.
Não encontrou sua resposta?
Nossa equipe de suporte está disponível para ajudar você a resolver qualquer dúvida.
Falar com Suporte →