Como ativar o Fluxo de Chatbot e Gemini AI para Chatbot

Tempo de leitura estimado: 5 minutos 50 visualizações

O WaSap utiliza a tecnologia do Google Gemini para potencializar o seu atendimento através da extensão Fluxo Chatbot, permitindo a criação de automações inteligentes e respostas naturais para seus clientes.

1. Ativação do Módulo

Para começar, você deve habilitar a extensão no sistema:

Acesse o menu lateral Ajustes.
Clique na aba Extensões.
Localize o card Fluxo Chatbot.
Clique em Ativar (caso ainda não esteja ativo).

2. Configurando as Credenciais (API Key)

Após ativar, você precisará inserir sua chave de comunicação com o Google.

No card da extensão, clique no botão ⚙️ Configurações.
No campo API Key, cole a sua chave gerada no painel do Google.
- 🔗 Onde encontrar sua chave? Você pode gerar e gerenciar suas chaves de API através do Google AI Studio.
No campo Modelo, insira o identificador técnico da IA que deseja utilizar (consulte a tabela abaixo).
Opção Especial: Ative ou desative “Impedir Interrupção do Fluxo por Agentes”. Se ativada, o chatbot continuará operando mesmo que um humano envie mensagens, até que o fluxo seja formalmente encerrado.
Clique em Salvar.
Impedir Interrupção do Fluxo por Agentes: Impede que os atendentes possam interagir com o cliente antes que ele finalize o fluxo de chatbot.

3. Tabela de Modelos Suportados

O WaSap aceita todos os modelos da família Gemini. Abaixo estão os identificadores técnicos que você deve copiar e colar no campo “Modelo” dentro das configurações da extensão:

Linha	Modelo	Identificador para API	Melhor Função / Uso Recomendado
Geração 3	Gemini 3 Flash	`gemini-3-flash`	O padrão ouro. Melhor para Chatbots complexos e respostas rápidas.
	Gemini 3.1 Pro	`gemini-3.1-pro`	Análise Profunda. Ideal para o Reply AI em negociações difíceis.
	Gemini 3.1 Flash Lite	`gemini-3.1-flash-lite`	Economia. Triagem inicial de contatos com custo quase zero.
Geração 2.5	Gemini 2.5 Flash	`gemini-2.5-flash`	Estabilidade. Uso geral em fluxos de atendimento padrão.
	Gemini 2.5 Flash TTS	`gemini-2.5-flash-tts`	Voz. Especializado em converter texto para áudio (Text-to-Speech).
	Gemini 2.5 Flash Lite	`gemini-2.5-flash-lite`	Velocidade. Respostas instantâneas para perguntas simples (FAQ).
Gemma 3	Gemma 3 1B / 2B	`gemma-3-1b-it`	Tarefas Simples. Extração de dados (ex: pegar CPF ou E-mail).
	Gemma 3 4B / 12B	`gemma-3-4b-it`	Criatividade. Ótimo para variar o tom de voz do atendimento.
	Gemma 3 27B	`gemma-3-27b-it`	Lógica. Processamento de regras de negócio complexas no fluxo.
Outros	Gemini Embedding 1	`text-embedding-004`	Busca. Para o bot ler PDFs e Manuais de Instruções da empresa.

💡 Qual modelo escolher?

Para ajudar na sua decisão, considere os seguintes perfis de uso:

Para o Fluxo Chatbot (Automação): Recomendamos o gemini-1.5-flash. Ele possui a melhor latência (tempo de resposta), garantindo que o cliente não fique esperando muito tempo por uma resposta do bot, além de ser o mais econômico para altos volumes de mensagens.
Para o Reply AI (Assistente de Escrita): Se você precisa que a IA analise históricos de conversas muito longos para sugerir uma resposta perfeita, o gemini-1.5-pro é a escolha ideal devido à sua janela de contexto expandida.
Para Testes Rápidos: O gemini-1.5-flash-8b é extremamente rápido e eficiente para tarefas simples de classificação de texto ou respostas curtas.

⚠️ Notas Importantes de Configuração

Chave de API: Certifique-se de que sua chave de API tenha as permissões necessárias para o modelo escolhido no console do Google.
Sensibilidade a Maiúsculas: Digite o identificador do modelo exatamente como listado na coluna “Identificador para API” (letras minúsculas e hifens).
Botão Salvar: Sempre clique em Salvar e, se possível, atualize a página (F5) para garantir que a nova configuração foi propagada para o módulo de atendimento.

Dica de Suporte: Se o chatbot parar de responder subitamente, verifique no painel do Google AI Studio se você atingiu o limite de cota (Quota Limit) do modelo selecionado.

4. Notas Importantes de Configuração

Sensibilidade a Maiúsculas: Digite o identificador do modelo exatamente como listado na tabela (letras minúsculas e hifens).
Persistência: Após clicar em Salvar, atualize a página (F5) para garantir que a nova configuração foi propagada para o módulo de atendimento.
Limites de Cota: Se o chatbot parar de responder subitamente, verifique no painel do Google AI Studio se você atingiu o limite de cota (Quota Limit) do seu plano (o Google oferece um Free Tier para testes).
Permissões: Certifique-se de que sua chave de API tenha as permissões necessárias para o modelo escolhido no console do Google Cloud/AI Studio.

Dica: O Google oferece um nível gratuito para testes (Free Tier) através do AI Studio. Verifique os limites de uso diretamente no link da documentação oficial fornecido acima.