No tutorial de integração mostramos duas formas de configurar a IA no canal: o Prompt ChatGPT (instruções diretas no painel) ou um Assistant da OpenAI. Este tutorial foca na segunda opção — indicada para quem precisa de uma base de conhecimento maior (manuais, catálogos, políticas em PDF) ou de um comportamento mais consistente em conversas longas.
Prompt vs Assistant: Quando Usar Cada Um
- Prompt direto no CRM: rápido de configurar, ótimo para regras de negócio simples e textos curtos. Veja os modelos de prompt prontos.
- Assistant da OpenAI: permite anexar arquivos (PDF, planilhas, documentos) como base de conhecimento, mantém instruções mais complexas organizadas e é gerenciado fora do CRM, no Playground da OpenAI.
Lembre-se: ao preencher o campo AssistantId ChatGPT no canal, o campo "Prompt ChatGPT" é ignorado — escolha apenas um caminho.
Passo 1: Acesse o Playground de Assistants da OpenAI
Com sua conta OpenAI já criada e com créditos disponíveis (veja o tutorial de integração para os pré-requisitos), acesse a seção Assistants dentro da plataforma de desenvolvedores da OpenAI e clique em Create (Criar) para iniciar um novo Assistant.
Passo 2: Defina Nome, Modelo e Instruções
- Name: dê um nome identificável, ex: "Atendimento WhatsApp - [Nome da Empresa]". Isso ajuda a organizar quando você tiver múltiplos assistants para canais diferentes.
- Model: escolha o modelo (ex: gpt-4o para melhor qualidade, gpt-4o-mini para custo menor em alto volume).
- Instructions: este é o equivalente ao "Prompt ChatGPT", mas vivendo dentro do Assistant. Use a mesma estrutura recomendada no tutorial de prompts: persona, objetivo, regras e limites, fluxo esperado e quando transferir para humano.
Passo 3: Adicione uma Base de Conhecimento (File Search)
Esta é a principal vantagem de usar um Assistant. Na seção Tools, ative File search e faça upload dos documentos que a IA deve consultar para responder, por exemplo:
- Catálogo de produtos ou tabela de preços (PDF ou planilha)
- Manual de políticas: trocas, devoluções, garantia
- Perguntas frequentes detalhadas
- Scripts de atendimento e argumentos de vendas
Depois do upload, instrua o Assistant a priorizar essas informações. Exemplo de trecho para as instruções:
Sempre que o cliente perguntar sobre produtos, preços, prazos ou políticas, consulte os arquivos
anexados antes de responder. Se a informação não estiver nos arquivos, não invente — diga que vai
confirmar com a equipe e transfira o atendimento.
Passo 4: Outras Ferramentas (Opcional)
- Code Interpreter: útil se o assistant precisa fazer cálculos (ex: simulações de parcelamento, frete por região). Para a maioria dos atendimentos via WhatsApp, não é necessário.
- Function calling: recurso avançado para integrar o Assistant a sistemas externos (ex: consultar status de pedido em tempo real em um ERP). Recomendado apenas para operações com suporte técnico dedicado, normalmente via implementação personalizada.
Passo 5: Teste no Playground
Antes de conectar ao WhatsApp, use o chat de teste do próprio Playground para validar:
- O assistant responde corretamente com base nos arquivos enviados?
- Ele recusa educadamente perguntas fora do escopo?
- O tom de voz está alinhado com a marca?
- Ele sabe identificar quando transferir para um humano?
Ajuste as instruções e repita os testes até o comportamento ficar consistente — é mais fácil corrigir aqui do que depois de publicado para clientes reais.
Passo 6: Copie o Assistant ID e Conecte ao CRM
Na página do Assistant, copie o ID (formato asst_...). No painel do CRM:
- Acesse Canais de Comunicação → ícone de configurações do canal desejado.
- Na seção Configurações do ChatGPT, preencha a ChatGPT API Key e a ChatGPT Organization Key normalmente.
- No campo Opção #2: AssistantId ChatGPT, cole o ID copiado.
- Deixe o campo "Prompt ChatGPT" vazio (ele será ignorado de qualquer forma quando o Assistant ID está preenchido).
- Salve as configurações.
Mantendo o Assistant Atualizado
- Atualizou preços ou políticas? Substitua os arquivos anexados ao Assistant no Playground — não é necessário alterar nada no CRM.
- Mudou as regras de atendimento? Edite as Instructions do Assistant diretamente no Playground.
- Acompanhe o consumo: o uso de tokens do Assistant (incluindo a leitura dos arquivos da base de conhecimento) é cobrado pela OpenAI conforme o plano de billing da sua conta — vale revisar o consumo periodicamente, especialmente após adicionar arquivos grandes.
Quer ajuda para estruturar a base de conhecimento ou montar o Assistant ideal para o seu negócio? Fale com o time da Winove →
