Conceitos Fundamentais

Compreender estes blocos de construção tornará todos os outros recursos do FRENZY.BOT mais fáceis de usar. Esta página explica como o sistema funciona em linguagem clara.

Como o FRENZY.BOT funciona

┌─────────────┐     ┌──────────────┐     ┌─────────────┐
│  Seus Dados │ ──→ │   Indexação  │ ──→ │   Qdrant    │
│ Arq, URLs   │     │ (Embeddings) │     │ (Vector DB) │
│    FAQs     │     └──────────────┘     └──────┬──────┘
└─────────────┘                                 │
                                                │ recuperar
┌─────────────┐     ┌──────────────┐     ┌──────┴──────┐
│  Pergunta   │ ──→ │  FRENZY.BOT  │ ──→ │  Modelo AI  │
│ do Usuário  │     │ (RAG Engine) │ ←── │(via OpenRouter)│
└─────────────┘     └──────┬───────┘     └─────────────┘
                           │
                    ┌──────┴──────┐
                    │   Resposta  │
                    │ + Dados Lead│
                    │ + Analytics │
                    └─────────────┘

Você faz o upload dos seus dados — arquivos, URLs de sites e pares de FAQ vão para a Base de Conhecimento.
O sistema os indexa — o conteúdo é convertido em embeddings numéricos e armazenado no Qdrant (banco de dados vetorial) para que possa ser pesquisado pelo significado, não apenas por palavras-chave.
Um usuário faz uma pergunta — através do widget, WhatsApp, Telegram ou qualquer canal conectado.
FRENZY.BOT recupera o conteúdo relevante — o sistema encontra os trechos mais pertinentes da sua base de conhecimento usando busca semântica.
O modelo de IA gera uma resposta — o conteúdo recuperado + a pergunta do usuário são enviados para o modelo de IA (Claude, GPT, Gemini, etc.) via OpenRouter.
Tudo é rastreado — a conversa, o tempo de resposta, o uso de tokens e quaisquer dados de leads capturados são armazenados para relatórios.

Bot

Seu bot é o assistente de IA que você está construindo. Cada bot possui seu próprio:

Base de conhecimento — Os documentos, URLs e FAQs com os quais ele aprende.
Configurações — Modelo de IA, prompt do sistema, temperatura, branding, configuração do widget.
Conversas — Histórico de chat com os usuários.
Leads — Contatos capturados durante as conversas.
Analytics — Métricas de uso e dados do funil.
Widget — Seu próprio código de incorporação com um data-bot-id exclusivo.

Em uma configuração multi-bot, você pode executar vários bots a partir de uma única instalação — cada um completamente isolado dos outros.

Onde gerenciar: Configurações, Base de Conhecimento, Incorporação (Embed) e o menu suspenso de workspace no cabeçalho.

Base de Conhecimento

A base de conhecimento é a biblioteca que seu bot lê antes de responder a qualquer pergunta. É o que torna seu bot específico para o seu negócio em vez de uma IA genérica.

Três fontes de dados:

Fonte	Melhor para	Velocidade de indexação
Arquivos (PDF, DOCX, TXT, CSV, etc.)	Documentos internos, políticas, especificações de produtos	Minutos
URLs (qualquer página pública)	Conteúdo do site, artigos de ajuda, posts de blog	Minutos
FAQs (pares manuais de P&R)	Respostas críticas que você deseja controlar exatamente	Instantâneo

Princípio fundamental: Se um tópico não estiver na base de conhecimento, o bot pode responder genericamente ou recusar-se a responder. Quanto mais conteúdo relevante você adicionar, melhor será o desempenho do bot.

Para o guia completo, consulte Base de Conhecimento.

Canais

Canais são os locais onde seus usuários interagem com o bot.

Canal	Tipo	Configuração
Widget do site	Primário	Script de incorporação no seu site
WhatsApp	Mensageiro	WAHA Docker + pareamento via QR code
Telegram	Mensageiro	Token do bot via @BotFather
Discord	Comunidade	Token do bot via Developer Portal
Instagram	Social	Token de Acesso à Página
Messenger	Social	Integração com Página do Facebook
Slack	Ambiente de Trabalho	Token do App
Webhook	Personalizado	Qualquer endpoint HTTP

Cada canal pode ter seu próprio estilo de resposta — a IA adapta seu tom e extensão de resposta para corresponder à plataforma (ex: mais curto no WhatsApp, mais detalhado no widget do site).

Para detalhes, consulte Canais.

Sessões e conversas

Uma sessão é uma conversa completa entre um usuário e seu bot. Cada sessão rastreia:

Mensagens — Cada pergunta e resposta na conversa.
Tokens — Quantos tokens de IA foram consumidos (afeta o custo).
Duração — Quanto tempo a conversa durou.
Fonte — De qual canal a conversa veio.
Dados do lead — Qualquer informação de contato capturada durante o chat.

As sessões são a base para análise, revisão de qualidade e captura de leads. Revise-as em Conversas.

Leads e integrações

Um lead é um contato capturado durante um chat — nome, e-mail, telefone, empresa e quaisquer campos personalizados que você configurou.

Os leads fluem através de um pipeline:

Novo → Contatado → Qualificado → Convertido (ou Perdido)

As integrações roteiam automaticamente os leads para suas ferramentas externas:

E-mail — Notificações SMTP para sua equipe.
Webhook — Payloads JSON para seus próprios endpoints.
Google Sheets — Adiciona linhas para um CRM leve.
MailChimp — Adiciona contatos a listas de e-mail marketing.

Para detalhes, consulte Gestão de Leads e Integrações.

Módulos

Módulos são capacidades opcionais que você pode ativar ou desativar sem afetar o sistema central:

Módulo	O que faz
Live Web Access (Tavily)	Permite que o bot pesquise na web ao vivo quando os dados internos não são suficientes
Transbordo Humano	Escala conversas para agentes humanos
Text-to-Speech	Converte respostas de IA em áudio
Agendamento de Consultas	Agendamento via chat através do Calendly
Formulário de Leads	Captura informações de contato no meio da conversa
WhatsApp	Mensagens automatizadas via WAHA

Navegue e gerencie módulos em Módulos.

Check-up rápido

Use este checklist para verificar se o seu bot está totalmente operacional:

[ ] Base de conhecimento populada — Pelo menos um arquivo, URL ou FAQ adicionado e exibindo o status Live.
[ ] OpenRouter conectado — O Engine de IA mostra um provedor conectado e um modelo selecionado.
[ ] Widget implantado — O script de incorporação está no seu site e a bolha de chat aparece.
[ ] Integrações ativadas — Os leads estão sendo roteados para seu CRM, e-mail ou webhook.

Se todos os quatro itens forem verdadeiros, seu sistema está totalmente funcional e pronto para tráfego de produção.