Introdução aos Chatbots de IA com OpenAI + WOZTELL

Guia prático para entender o GPT Assistant v1.3.0, Responses API, prompts, Bases de Conhecimento, ferramentas e canais no WOZTELL

Este guia explica como funcionam os novos chatbots de inteligência artificial no WOZTELL usando a OpenAI e a extensão GPT Assistant v1.3.0.

Com esta extensão, você pode criar assistentes de IA conectados à OpenAI para responder automaticamente em canais como WhatsApp Business, WhatsApp Cloud API, Instagram, Facebook Messenger e Webchat. Você também pode usar IA para apoiar agentes humanos dentro do Inbox do WOZTELL por meio de sugestões de resposta.

Importante: migração da Assistants API

Anteriormente, o WOZTELL utilizava configurações baseadas na Assistants API da OpenAI.

A OpenAI anunciou a depreciação da Assistants API, e seu desligamento está previsto para 26 de agosto de 2026. Por esse motivo, as configurações antigas devem ser migradas para os novos chatbots baseados na Responses API antes dessa data.

A nova versão do GPT Assistant no WOZTELL utiliza a Responses API, que é o padrão recomendado pela OpenAI para novas implementações de assistentes, agentes conversacionais e ferramentas de IA.

1. O que é um chatbot de IA no WOZTELL?

Um chatbot de IA no WOZTELL é um assistente conectado à OpenAI que pode interpretar mensagens dos usuários, gerar respostas automáticas e usar ferramentas adicionais para responder melhor.

Dependendo da configuração, o assistente pode:

Responder automaticamente a clientes no WhatsApp, Instagram, Facebook Messenger ou Webchat.
Consultar documentos de uma Base de Conhecimento antes de responder.
Buscar informações atualizadas na web.
Executar funções externas por meio de Function Call.
Apoiar agentes humanos com sugestões de resposta dentro do Inbox do WOZTELL.

Isso permite automatizar conversas repetitivas, melhorar a velocidade de atendimento, apoiar a equipe comercial e oferecer respostas mais consistentes em todos os canais conversacionais.

2. O que é o GPT Assistant v1.3.0?

GPT Assistant v1.3.0 é a extensão do WOZTELL que permite conectar uma conta da OpenAI aos canais conversacionais do WOZTELL.

A configuração principal é dividida em três etapas principais:

API Key Setup: conecta a conta da OpenAI usando uma API Key.
Configuration: configura o modelo, o prompt, as ferramentas, a Base de Conhecimento e as sugestões.
Connect to Channel: conecta o assistente a um ou mais canais do WOZTELL.

Depois de configurado, o assistente pode ser ativado nos canais disponíveis dentro da conta do WOZTELL.

3. Qual API o WOZTELL usa agora?

Responses API

A nova versão do GPT Assistant utiliza a Responses API da OpenAI.

A Responses API é a API recomendada pela OpenAI para novas implementações de assistentes de IA. Ela permite trabalhar com modelos, instruções, contexto e ferramentas como File Search, Web Search e Function Call.

No WOZTELL, o contexto conversacional é gerenciado pelo WOZTELL. Isso significa que o WOZTELL decide quantas mensagens anteriores são enviadas ao modelo com base na configuração definida no assistente.

Por que esta migração é importante?

A migração é importante porque as configurações antigas baseadas na Assistants API deixarão de ser suportadas pela OpenAI a partir de 26 de agosto de 2026.

Por esse motivo, os clientes que ainda utilizam configurações anteriores devem migrar seus assistentes para a nova configuração baseada na Responses API.

4. Conceitos básicos da OpenAI

API Key

A API Key é a credencial que permite ao WOZTELL se conectar à conta da OpenAI do cliente.

Sem uma API Key válida, o WOZTELL não consegue enviar solicitações ao modelo nem ativar corretamente a configuração do assistente.

Model

O Model é o modelo da OpenAI que gera as respostas do assistente.

A lista de modelos disponíveis é obtida dinamicamente a partir da conta da OpenAI conectada. Isso significa que nem todos os clientes verão exatamente os mesmos modelos.

Token

Um token é a unidade de texto processada pelo modelo. Pode ser uma palavra, parte de uma palavra, um número, um espaço ou um sinal de pontuação.

Os custos da OpenAI geralmente são calculados com base nos tokens de entrada e saída.

Input Tokens

São os tokens enviados ao modelo. Eles podem incluir:

A mensagem do usuário.
As instruções do assistente.
O histórico da conversa.
Fragmentos recuperados por File Search.
Resultados de Web Search.
Dados retornados por Function Call.

Output Tokens

São os tokens gerados pelo modelo em sua resposta.

Context

Context é toda a informação enviada ao modelo para que ele possa responder corretamente.

Pode incluir instruções, mensagens anteriores, informações da Base de Conhecimento, resultados de ferramentas e dados externos.

Context Window

A context window é a quantidade máxima de informação que um modelo pode processar em uma única solicitação.

Quanto mais contexto for enviado, maior poderá ser o custo e, em alguns casos, mais lenta poderá ser a resposta.

5. Como escolher o modelo adequado

A escolha do modelo depende do caso de uso, do volume de conversas, da complexidade das respostas e do orçamento disponível.

Modelo	Uso recomendado no WOZTELL	Qualidade	Custo relativo	Recomendação
Modelos avançados da OpenAI	Casos complexos, suporte técnico avançado, raciocínio e assistentes de alta precisão	Muito alta	Alto	Usar quando a qualidade for mais importante do que o custo
Modelos mini ou leves	FAQs, suporte básico, vendas, onboarding e alto volume de conversas	Alta / média-alta	Baixo / médio-baixo	Recomendado para a maioria dos casos conversacionais
Modelos de transcrição	Conversão de mensagens de áudio em texto	Não aplicável	Com base no uso de áudio	Usar quando forem recebidas notas de voz ou mensagens de áudio

Antes de publicar preços ou criar uma proposta comercial, recomenda-se consultar a página oficial de preços da OpenAI, já que os modelos e custos podem mudar.

6. Como configurar o comportamento do assistente

Instructions / Prompt

As Instructions, também conhecidas como prompt base ou system prompt, definem como o assistente deve se comportar.

Um bom prompt deve incluir:

O papel do assistente.
O tom de comunicação.
Os temas que ele pode responder.
Os temas que ele deve evitar.
As informações que deve solicitar ao usuário.
Regras de escalonamento para humano.
O formato esperado da resposta.

Exemplo de prompt base

You are a presales assistant for WOZTELL.

Your goal is to help companies understand how WOZTELL can help them automate conversations across WhatsApp, Instagram, Facebook Messenger, and Webchat.

Be friendly, concise, and professional.

Only answer questions related to WOZTELL, WhatsApp Business Platform, AI chatbots, integrations, automation, and conversational channels.

If the user asks about something unrelated, politely explain that you can only help with WOZTELL-related topics.

Before qualifying the lead, ask for their name, company, website, and main use case.

Negative Constraints

Negative constraints são regras que indicam o que o assistente não deve fazer.

Do not invent prices.
Do not promise implementation timelines unless confirmed.
Do not answer questions outside the scope of WOZTELL.
Do not provide legal, financial or medical advice.
Do not say you are an AI unless the user asks directly.

Human Handover / Escalation

Human Handover, ou escalonamento para humano, acontece quando o assistente precisa transferir a conversa para um agente.

O escalonamento é recomendado quando:

O usuário pede para falar com uma pessoa.
Há uma pergunta sobre preços.
Há um problema técnico.
Há dúvidas sobre faturamento.
O assistente não tem informação suficiente.
A conversa exige validação humana.

7. Ferramentas disponíveis no GPT Assistant

File Search

File Search permite que o assistente busque informações dentro de uma Base de Conhecimento antes de responder.

É útil quando o assistente precisa responder com base em documentação oficial, FAQs, guias de produto, processos internos ou materiais comerciais.

Web Search

Web Search permite que o assistente busque informações atualizadas na internet.

É recomendado quando a resposta depende de informações que podem mudar, como documentação externa, preços, regulamentações, notícias ou informações públicas recentes.

Domain Filtering

Domain Filtering permite limitar as buscas web a domínios específicos.

Exemplo correto:

woztell.com
support.woztell.com
openai.com

Exemplo incorreto:

https://woztell.com/

Function Call

Function Call permite que o assistente chame uma função externa para recuperar dados ou executar uma ação.

Exemplos de uso:

Consultar o status de um pedido.
Verificar uma consulta ou agendamento.
Buscar dados de um cliente.
Criar um ticket.
Enviar informações para um CRM.
Validar disponibilidade.

8. Base de Conhecimento e Vector Stores

Knowledge Base

A Knowledge Base é o conjunto de documentos que o assistente pode consultar para responder perguntas.

Ela pode incluir:

FAQs.
Guias de instalação.
Documentação de produto.
Materiais comerciais.
Políticas internas.
Materiais de suporte.

Vector Store

O Vector Store é o contêiner técnico onde os documentos processados são armazenados para que o assistente possa buscar informações relevantes.

Uma forma simples de entender:

Knowledge Base: a biblioteca de documentos.
Vector Store: o contêiner técnico onde os documentos são indexados.
File Search: a ferramenta que busca dentro dessa biblioteca.

Retrieval

Retrieval é o processo pelo qual o assistente recupera fragmentos relevantes da Base de Conhecimento e os usa como contexto adicional para responder.

Boas práticas

Use documentos claros e atualizados.
Remova informações desatualizadas.
Evite documentos duplicados.
Não misture versões contraditórias.
Separe documentação técnica, comercial e de suporte quando necessário.
Revise a Base de Conhecimento periodicamente.

9. AI Chatbot vs AI Inbox Replies

Funcionalidade	O que faz	Quem usa	Responde automaticamente
AI Chatbot	Responde aos usuários finais em canais conectados	Usuário final	Sim
AI Inbox Replies	Gera sugestões de resposta dentro do Inbox	Agente humano	Não

AI Chatbot

O AI Chatbot responde automaticamente aos usuários finais em canais como WhatsApp, Instagram, Facebook Messenger e Webchat.

AI Inbox Replies

AI Inbox Replies ajuda agentes humanos gerando sugestões de resposta dentro do Inbox do WOZTELL. O agente pode revisar, editar e enviar a resposta manualmente.

10. Conexão a canais

Channel

O Channel é o canal de comunicação onde o assistente responderá aos usuários.

Canais suportados:

WhatsApp Business
WhatsApp Cloud API
Instagram
Facebook Messenger
Webchat

Environment

O Environment é um espaço dentro de um canal que permite separar testes, desenvolvimento e produção.

Se nenhum ambiente adicional tiver sido criado, o ambiente padrão será utilizado.

Prefix Name

O Prefix Name é o nome identificador da configuração do assistente conectada a um canal ou ambiente específico.

Exemplos:

AI-CHATBOT-WHATSAPP-PRESALES
AI-CHATBOT-INSTAGRAM-SUPPORT
AI-CHATBOT-WEBCHAT-FAQ
AI-CHATBOT-FACEBOOK-LEADS

Connect

Connect vincula o assistente ao canal selecionado e o ativa.

Disconnect

Disconnect desvincula o assistente do canal selecionado.

Go Live

Go Live é o momento em que o assistente fica ativo em um canal real e começa a responder aos usuários finais.

11. Custos e controle de uso

O custo de uso da OpenAI depende principalmente do modelo, dos tokens processados e das ferramentas utilizadas.

Fatores que podem aumentar o custo

Prompts muito longos.
Histórico de conversa muito amplo.
Respostas muito extensas.
Uso frequente de File Search.
Uso frequente de Web Search.
Modelos mais avançados.
Mensagens de áudio longas que exigem transcrição.
Bases de Conhecimento grandes ou mal estruturadas.

Boas práticas de controle de custos

Use modelos eficientes para casos de alto volume.
Limite o número de mensagens anteriores enviadas como contexto.
Mantenha as respostas concisas.
Ative Web Search apenas quando necessário.
Mantenha a Base de Conhecimento limpa e atualizada.
Escalone para um humano quando a conversa for complexa.
Revise logs e consumo periodicamente.

12. Qualidade, precisão e prevenção de respostas inventadas

Hallucination

Uma hallucination é uma resposta gerada pelo modelo que pode parecer correta, mas que não se baseia em informações reais ou confirmadas.

Como reduzir hallucinations

Use instruções claras.
Limite o escopo do assistente.
Ative File Search quando existir documentação oficial.
Mantenha a Base de Conhecimento atualizada.
Instrua o assistente a não inventar informações.
Defina regras claras de escalonamento para humano.

If the answer is not available in the Knowledge Base or confirmed documentation, do not invent it. Ask the user to contact the WOZTELL team or escalate to a human agent.

Grounding

Grounding significa basear as respostas do assistente em fontes específicas, como documentos da Base de Conhecimento, resultados de Web Search ou dados retornados por uma Function Call.

13. Logs e troubleshooting

Logs

Logs são registros técnicos que mostram eventos, solicitações e erros gerados durante a operação do assistente.

Eles são usados para diagnosticar problemas relacionados a:

API Key.
Modelos.
Parâmetros incompatíveis.
Canais.
File Search.
Web Search.
Function Call.
Erros da OpenAI.

Erro	Causa provável	Solução recomendada
API Key não aceita	Chave copiada incorretamente, revogada ou inválida	Gerar uma nova API Key e salvá-la no WOZTELL
Modelo não disponível	A conta da OpenAI não tem acesso ao modelo	Revisar permissões, projeto e billing na OpenAI
File Search não funciona	Não há arquivos, o Vector Store está incorreto ou a ferramenta não está ativa	Fazer upload de arquivos, selecionar o Vector Store correto e ativar File Search
O bot não responde	Canal não conectado, API Key inválida ou erro de configuração	Revisar o canal, a API Key, os logs e a configuração do assistente

14. Checklist antes de ativar o assistente

API Key válida e salva.
Modelo selecionado corretamente.
Prompt claro e testado.
Regras de escalonamento definidas.
Temperature adequada.
Histórico de chat limitado.
Formato configurado como Text para chatbots comuns.
Base de Conhecimento atualizada se File Search for usado.
Web Search limitado a domínios aprovados, se aplicável.
Function Call testado se uma integração externa for usada.
Canal correto conectado.
Environment correto selecionado.
Prefix Name claro.
Testes concluídos antes do Go Live.
Logs revisados após as primeiras conversas.

Resumo

Os novos chatbots de IA do WOZTELL, impulsionados pela OpenAI e pela Responses API, permitem criar assistentes mais flexíveis, capazes de operar em vários canais e usar ferramentas como File Search, Web Search e Function Call.

Essa nova arquitetura substitui progressivamente as configurações anteriores baseadas na Assistants API. Por esse motivo, os clientes que ainda usam assistentes legados devem migrar antes de 26 de agosto de 2026.

Configurar corretamente o modelo, o prompt, a Base de Conhecimento, as ferramentas, o canal e as regras de escalonamento é essencial para criar um assistente confiável, útil e com custo controlado.