Perguntas frequentes

❓ Perguntas Frequentes – Assistente de IA do Chat-Bot

Guia Técnico Profissional para Operação, Diagnóstico e Boas Práticas

O módulo de Assistente de IA do Chat-Bot foi desenvolvido para oferecer respostas inteligentes, automatizar suporte e ampliar sua capacidade operacional no WhatsApp. Esta seção reúne as dúvidas mais frequentes, organizadas em formato de guia técnico, para que Fornecedores e Administradores possam diagnosticar problemas, configurar recursos corretamente e garantir alta performance do assistente.

🤖 1. Por que meu Assistente de IA não está respondendo?

Se o assistente não estiver retornando respostas, siga esta lista de verificação técnica:

✅ Passo 1 — Verifique a configuração da API OpenAI

Acesse:
Configurações do Aplicativo → Integração de IA
Confirme:

• A chave da API OpenAI está colada corretamente

• Não há espaços extras

• O formato está correto (sk-xxxxxxxxx)

✅ Passo 2 — Certifique-se de que a chave está ativa

Verifique no painel da OpenAI:

• Créditos disponíveis

• Limites de uso

• Validade da chave

✅ Passo 3 — Confirme a sincronização da Base de Conhecimento

No painel do Assistente:

• O status deve exibir “Totalmente Sincronizado”

• Se estiver “Processando...”, aguarde a indexação dos arquivos

✅ Passo 4 — Confirme a integração no fluxo do Bot

O Assistente só atua quando conectado ao Message Bot.
Verifique:

• Bot configurado corretamente

• Assistente selecionado

• Palavras-chave de gatilho definidas

• Tipos de contato habilitados

⏱️ 2. Quanto tempo demora o processamento dos documentos?

O tempo varia de acordo com:

📌 Fatores que influenciam o processamento

⏳ Tempo médio de processamento

2 a 10 minutos por documento

⚠️ Importante:

Só teste seu assistente quando o painel mostrar:
✔️ Status de Sincronização: Totalmente Sincronizado

📄 3. Quais formatos de arquivos são suportados?

O Assistente de IA do Chat-Bot suporta os formatos:

💡 Dica de qualidade

Arquivos com conteúdo:

• Bem estruturado

• Com títulos claros

• Com linguagem objetiva

→ resultam em respostas muito mais eficientes.

🎯 4. Por que as respostas do meu assistente estão imprecisas ou irrelevantes?

Se o assistente não estiver respondendo com qualidade:

📌 Possíveis causas e como corrigir

1️⃣ Base de Conhecimento desatualizada

• Envie arquivos atualizados

• Remova informações antigas

• Mantenha a estrutura organizada

2️⃣ Instruções do sistema mal definidas

Ajuste o comportamento do assistente:
Exemplo:

Você é uma assistente profissional, objetiva, educada e especializada na empresa. Sempre responda usando o conteúdo da Base de Conhecimento.

3️⃣ Documentos desorganizados

• Falta de títulos

• Informação dispersa

• Tabelas desformatadas

Organize antes de enviar.

4️⃣ Temperatura configurada incorretamente

Use:

• 0.1 a 0.3 → respostas mais precisas

• 0.4+ → respostas mais criativas, porém menos exatas

5️⃣ Limitações do modelo

Confirme o modelo selecionado:

• GPT-4 → mais contexto

• GPT-3.5 Turbo → custo-benefício

• GPT-4o Mini → rápido e econômico

🔌 5. Como integrar o Assistente de IA ao fluxo do Message Bot?

Siga este passo a passo:

1. Acesse o Bot de Mensagens

Menu lateral → Message Bot

2. Criar ou editar um bot

Clique: + Adicionar Bot de Mensagens

3. Acesse a aba "Assistente Pessoal"

Dentro das opções do bot, selecione:

• Aba “Assistente Pessoal”

• Escolha seu assistente de IA na lista

4. Configure os gatilhos

Defina:

• Palavras-chave de ativação

• Tipos de contato (Lead, Cliente, etc.)

• Regras de fallback

5. Teste a integração

Use consultas reais no chat para validar.

⚠️ 6. O que fazer se a sincronização dos documentos ficar travada em 0%?

Se nada processa, verifique:

🔍 Diagnóstico rápido

• Arquivos suportados?

• Todos abaixo de 10 MB?

• Não estão corrompidos?

• Formato correto de texto (evitar scans de baixa qualidade)?

🔄 Tente estas ações

1. Reenvie os arquivos

2. Aguarde até 30 minutos

3. Tente enviar um arquivo de teste simples (.txt)

4. Verifique sua conexão de internet

5. Acesse novamente a página do Assistente

🆘 Se continuar parado após 30 minutos

Entre em contato com o suporte do Chat-Bot.

💰 7. Como posso reduzir e otimizar os custos com a OpenAI?

Recomendações oficiais:

💡 1. Utilize modelos mais econômicos

• GPT-4o Mini → Melhor custo-benefício

• GPT-3.5 Turbo → Uso geral

✂️ 2. Limite o tamanho das respostas

Use tokens entre 150 e 300.

🧹 3. Otimize seus documentos

Conteúdo limpo = menos tokens consumidos.

📊 4. Monitore o uso mensal

Acesse o painel OpenAI regularmente.

🔔 5. Configure limites de gastos

Evite cobranças inesperadas.

📚 Próximos passos

• Página anterior: Vídeo Online

• Próxima página: Melhores Práticas