Perguntas frequentes sobre os novos chatbots de IA com OpenAI + WOZTELL

14 FAQs sobre GPT Assistant v1.3.0, Responses API, migração da Assistants API e configuração de chatbots de IA no WOZTELL

Este artigo responde às perguntas mais frequentes sobre o lançamento dos novos chatbots de IA no WOZTELL usando GPT Assistant v1.3.0 e a Responses API da OpenAI.

Ele é destinado a clientes, parceiros e equipes que já utilizam o WOZTELL ou que querem começar a automatizar conversas em canais como WhatsApp, Instagram, Facebook Messenger e Webchat.

Aviso

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

A OpenAI anunciou que a Assistants API está depreciada e que seu desligamento está previsto para 26 de agosto de 2026. Por esse motivo, os assistentes antigos deverão ser migrados para os novos chatbots baseados na Responses API antes dessa data.

1. O que são os novos chatbots de IA do WOZTELL?

São assistentes de inteligência artificial conectados à OpenAI que podem responder automaticamente aos usuários finais a partir dos canais conectados ao WOZTELL.

Eles podem ser usados em:

WhatsApp Business.
WhatsApp Cloud API.
Instagram.
Facebook Messenger.
Webchat.

Também podem ser conectados a Bases de Conhecimento, ferramentas de busca e funções externas para responder de forma mais completa.

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

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

A partir desta extensão, você pode configurar:

A API Key da OpenAI.
O modelo que irá gerar as respostas.
As instruções ou o prompt do assistente.
Ferramentas como File Search, Web Search e Function Call.
Knowledge Bases ou Vector Stores.
Conexão aos canais do WOZTELL.

3. Por que o WOZTELL está migrando da Assistants API para a Responses API?

O WOZTELL está migrando porque a OpenAI depreciou a Assistants API e definiu a Responses API como a API recomendada para novas implementações de assistentes e agentes de IA.

A Responses API permite uma configuração mais flexível do contexto, das ferramentas e das chamadas ao modelo. Além disso, é a base sobre a qual a OpenAI está desenvolvendo suas novas capacidades para assistentes.

4. Até quando os assistentes antigos baseados na Assistants API funcionarão?

A OpenAI anunciou que a Assistants API deixará de estar disponível em 26 de agosto de 2026.

Por esse motivo, qualquer configuração antiga baseada na Assistants API deverá ser migrada antes dessa data para evitar interrupções no serviço.

5. O que acontece se eu não migrar meu assistente antes de agosto de 2026?

Se um assistente continuar dependendo da Assistants API depois da data de desligamento definida pela OpenAI, ele poderá deixar de funcionar corretamente.

Para evitar interrupções, recomenda-se migrar com antecedência para a nova configuração baseada na Responses API.

6. A migração muda a forma como meus clientes escrevem pelo WhatsApp ou Instagram?

Não necessariamente.

A migração afeta principalmente a configuração técnica do assistente. O usuário final continuará escrevendo a partir do mesmo canal, como WhatsApp, Instagram, Facebook Messenger ou Webchat.

O que muda é a arquitetura interna com a qual o WOZTELL conecta o chatbot à OpenAI.

7. Quais canais são compatíveis com os novos chatbots de IA?

Os novos chatbots de IA podem ser conectados aos canais conversacionais disponíveis no WOZTELL, incluindo:

WhatsApp Business.
WhatsApp Cloud API.
Instagram.
Facebook Messenger.
Webchat.

O assistente só pode ser ativado em canais que já estejam conectados previamente na conta do WOZTELL.

8. O que preciso para configurar um chatbot de IA no WOZTELL?

Para configurar um chatbot de IA, você precisa de:

Uma conta do WOZTELL.
Pelo menos um canal conectado no WOZTELL.
Uma API Key válida da OpenAI.
Acesso aos modelos da OpenAI que você deseja usar.
Um prompt ou instruções para definir o comportamento do assistente.
Opcionalmente, documentos para criar uma Knowledge Base.

9. O que é uma API Key da OpenAI?

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 mensagens ao modelo nem gerar respostas automáticas.

A API Key deve ser mantida privada. Se for exposta, deve ser revogada na OpenAI e substituída por uma nova.

10. Qual modelo da OpenAI devo usar?

Depende do caso de uso.

Tipo de caso	Recomendação
FAQs, suporte básico e alto volume	Usar um modelo eficiente ou mini para controlar custos
Vendas, onboarding e atendimento geral	Usar um modelo equilibrado entre qualidade e custo
Suporte técnico avançado ou raciocínio complexo	Usar um modelo mais avançado
Mensagens de áudio	Usar um modelo de transcrição para converter áudio em texto

A lista exata de modelos disponíveis depende da conta da OpenAI conectada.

11. O que é o prompt ou Instructions?

O prompt ou Instructions define como o assistente deve se comportar.

Ele deve indicar:

Qual é o papel do assistente.
Qual tom deve usar.
Quais temas pode responder.
Quais temas deve evitar.
Quando deve escalar para um agente humano.
Quais informações deve pedir ao usuário.

Um prompt claro ajuda a reduzir erros, respostas inventadas e conversas fora de escopo.

12. O que é uma Knowledge Base?

Uma Knowledge Base é uma base de documentos que o assistente pode consultar antes de responder.

Ela pode incluir:

FAQs.
Guias de produto.
Documentação técnica.
Processos internos.
Material comercial.
Políticas de suporte.

Quanto mais clara e atualizada estiver a documentação, melhores serão as respostas do assistente.

13. Qual é a diferença entre Knowledge Base, Vector Store e File Search?

São conceitos relacionados, mas não significam exatamente a mesma coisa.

Knowledge Base: conjunto de documentos que o assistente pode consultar.
Vector Store: contêiner técnico onde esses documentos são processados e indexados.
File Search: ferramenta que permite ao assistente buscar dentro do Vector Store.

Em resumo: a Knowledge Base é a biblioteca, o Vector Store é o contêiner técnico e o File Search é a ferramenta que busca dentro dessa biblioteca.

14. Como posso controlar o custo do chatbot?

O custo depende principalmente do modelo, dos tokens processados e das ferramentas utilizadas.

Para controlar o custo, recomenda-se:

Usar modelos eficientes para casos de alto volume.
Limitar o histórico de conversa enviado ao modelo.
Evitar respostas muito longas.
Usar Web Search apenas quando necessário.
Manter a Knowledge Base limpa e bem organizada.
Evitar subir documentos duplicados ou contraditórios.
Escalar para um humano em casos complexos.
Revisar logs e consumo periodicamente.

Resumo

Os novos chatbots de IA do WOZTELL baseados em OpenAI e Responses API permitem criar assistentes mais flexíveis, conectados a múltiplos canais e preparados para usar ferramentas como File Search, Web Search e Function Call.

Essa nova arquitetura substitui progressivamente as configurações anteriores baseadas na Assistants API. Como a OpenAI anunciou o desligamento da Assistants API para 26 de agosto de 2026, é recomendável migrar qualquer configuração antiga antes dessa data.

Para uma configuração correta, é importante revisar o modelo, o prompt, a Knowledge Base, o canal, as ferramentas ativas, o controle de custos e as regras de escalonamento para humano.