Configurar com IA e automação
Como usar o Configurar com IA para montar o Bot de atendimento por conversa, revisar o plano item a item, aplicar no rascunho e configurar o bot por agentes externos via MCP
Há duas formas de acelerar a configuração do Bot de atendimento sem preencher cada seção na mão: o assistente Configurar com IA, dentro do OpsScript, e a seção Automação e API, que permite a agentes externos (como Claude ou ChatGPT) configurarem o bot por MCP.
Nos dois casos vale a mesma regra de segurança: a IA monta e aplica no rascunho, mas nunca publica sozinha. Publicar continua sendo uma decisão sua.
Configurar com IA
O botão Configurar com IA fica no cabeçalho do construtor e na Visão geral. Ele abre uma tela com três etapas: Conversar, Revisar plano e Aplicar.
É preciso ter a permissão de editar o bot e a feature de IA Generativa. Cada conversa, plano e ajuste consome a cota de IA da assinatura.
Conversar
Conte à IA de configuração como funciona o seu atendimento: quem vocês atendem, horários, o que o bot pode resolver sozinho e quando passar para uma pessoa. Você pode:
- Anexar documento (até 5 por conversa) — como o POP, um manual ou um e-mail com as regras — ou usar Colar texto;
- responder às perguntas da IA, que oferece opções (e marca a recomendada) quando precisa de uma decisão sua;
- pedir ajustes ("não quero CSAT", por exemplo).
O painel O que a IA entendeu resume, conforme a conversa avança, o que ela captou do seu negócio. Quando tudo estiver respondido, clique em Gerar plano.
Conversar não muda nada. As mudanças só acontecem na etapa Aplicar e vão para o Rascunho.
Revisar plano
A IA monta um Plano de configuração: uma lista de mudanças, agrupadas por área (diretrizes, skills, conhecimento, ferramentas, fluxo, horário, canal, testes…). É uma simulação — nada foi alterado ainda.
Cada item mostra o que muda (antes e depois) e pode trazer selos:
| Selo | Significa |
|---|---|
| Requer sua ação | O item depende de você, como conectar um servidor MCP (exige a sua autenticação) |
| Altera configuração ativa | O item muda ou remove algo que já existe na configuração |
| Exige Enterprise | O item usa a base de conhecimento ou a memória, que dependem do plano Enterprise |
| Ajustado na conversa | Item alterado a partir de um pedido de ajuste seu |
Você decide:
- Aceite ou recuse cada item (ou use Selecionar tudo). Se um item depende de outro, aceite o pré-requisito primeiro; recusar um item recusa também os que dependem dele.
- Use Pedir ajuste neste item (ou Pedir ajuste à IA) para pedir uma mudança em linguagem natural, como "no máximo 3 perguntas". O plano é atualizado.
No topo, o resumo mostra Itens aceitos, Mudanças, Requer sua ação e Alteram o que está ativo.
Nada é publicado automaticamente. Os itens aceitos vão para o Rascunho. Publicar e voltar versão nunca fazem parte de um plano.
Aplicar
Clique em Aplicar N itens. A aplicação roda em segundo plano, item a item, na ordem certa das dependências, e você acompanha o progresso: Executando, Concluído ou Aguardando você.
- Itens que dependem de uma ação sua — conectar um servidor MCP ou criar um template no WhatsApp — ficam em Aguardando você, sem travar os itens independentes. Use Autenticar e, depois, Já conectei, continuar.
- Fontes de conhecimento adicionadas são indexadas em segundo plano.
- Ao final, o resultado é Aplicado ou Aplicado em parte no Rascunho, com Ver diff em Versões e Ver fluxo. Se algum item falhar, use Tentar de novo.
Desfazer
Desfazer tudo restaura o rascunho ao estado de antes da aplicação — somente se ele não foi alterado depois. Se houve mudanças depois da aplicação, o OpsScript não desfaz (para não perder o seu trabalho); nesse caso desfaça pelas seções ou pelo histórico de Versões.
O que não volta com o "Desfazer tudo", por não ser parte do rascunho: fontes de conhecimento já indexadas, simulações executadas e templates criados na Meta. O OpsScript avisa quando isso se aplica.
Boas práticas
Quanto mais concreto você for na conversa, melhor o plano. Anexe o POP do atendente, diga os horários, cite o que o bot pode resolver sozinho e os casos em que deve chamar uma pessoa. Depois de aplicar, teste no painel Testar antes de publicar.
Automação e API
Tudo o que você faz nas telas do construtor tem uma ferramenta MCP equivalente. A IA de configuração usa essas ferramentas, e um agente externo conectado ao MCP Server do OpsScript também pode usá-las para configurar o bot.
A seção Automação e API mostra como conectar o agente (a URL do servidor MCP da sua instalação), as regras que valem para toda chamada, um exemplo de uso e a lista completa de ferramentas, com filtros Todas, Leitura, Escrita e Exigem confirmação.
Regras que valem para toda chamada
- Autenticação por OAuth com o seu usuário: o agente herda as suas permissões na organização, nada além disso.
- Escrita só no rascunho. Nenhuma ferramenta muda o que está no ar; a versão publicada segue atendendo até alguém publicar.
- Publicar e ações destrutivas pedem confirmação humana no OpsScript: publicar, voltar versão, remover itens e aplicar modelo de fluxo. O agente não executa; aparece um pedido de confirmação na seção Versões, que quem tem permissão de publicar confirma ou recusa (o pedido expira em 24 horas).
- Respeita as permissões (RBAC) e o plano da organização. Por exemplo, a base de conhecimento exige Enterprise e conectar um servidor MCP exige que você autentique.
- Tudo auditado em Versões: quem chamou (pessoa ou agente), a ferramenta e os parâmetros.
- O agente nunca fala com o cliente nem aprova ferramentas: essas decisões são sempre de uma pessoa.
Exemplo de uso
No agente conectado ao MCP do OpsScript:
Configure o bot do WhatsApp da minha empresa conforme o POP anexado. Use as skills de Suporte da biblioteca, conecte a central de ajuda help.example.com e me mostre o plano antes de aplicar.
O agente monta o plano (sem alterar nada), mostra para você e, depois do seu aceite, aplica no rascunho. Publicar continua com você.
Ferramentas por área
| Área | Ferramentas | O que fazem |
|---|---|---|
| Bot | get_bot, manage_bot, manage_bot_settings, list_bot_versions, get_bot_version_diff | Lê e altera persona e modo; publica, volta versão e descarta o rascunho (publicar e voltar exigem confirmação); ajusta dados da triagem, avaliação, retomada após 24h e assistente do atendente; lista e compara versões |
| Diretrizes | manage_bot_guidelines | Adiciona, edita, liga/desliga, reordena e remove diretrizes (remover exige confirmação) |
| Skills | list_skill_library, get_skill, manage_bot_skill, generate_skill_from_procedure | Navega na biblioteca, aplica e edita skills e gera uma skill a partir de um POP (sempre chega desligada) |
| Conhecimento | list_knowledge_sources, manage_knowledge_source, search_knowledge, manage_bot_memory | Gerencia as fontes (remover exige confirmação), busca trechos e configura as memórias |
| Ferramentas e MCP | list_mcp_servers, manage_mcp_server, manage_bot_tools | Lista, conecta e desconecta servidores MCP e define o que o bot e cada skill podem chamar e o que exige aprovação |
| Fluxo de atendimento | get_flow, manage_flow | Lê e edita o fluxo (aplicar modelo e remover nó exigem confirmação) |
| Horário e transbordo | manage_business_hours, manage_handoff_rules, manage_priority_rules | Horário, gatilhos de transbordo e regras de prioridade |
get_whatsapp_integration, manage_whatsapp_templates | Lê número e status e gerencia o template de retomada | |
| Testes e qualidade | run_bot_simulation, list_unanswered_questions | Roda cenários ou a suíte (não altera nada) e lista as perguntas sem resposta |
| Plano | plan_bot_configuration, apply_bot_plan | Gera um plano a partir de uma descrição (simulação) e aplica só os itens aceitos (sempre exige confirmação) |
O campo antigo de instruções livres da integração também tem uma ferramenta, marcada como Legado. Prefira as ferramentas estruturadas acima.
Testar e publicar
Como testar o Bot de atendimento com simulação segura, entender por que o bot respondeu assim, rodar a suíte de cenários, publicar versões e voltar a uma versão anterior
Alertas
Como configurar webhooks de entrada no OpsScript para receber eventos de sistemas externos e abrir chamados automaticamente