Versões

O que é

A aba Versões mostra o histórico do agente. Cada vez que você clica em Publicar versão, a plataforma guarda uma cópia das configurações daquele momento. Por esta aba você vê o que está no ar, compara as versões e volta para uma anterior quando precisar.

Os exemplos deste guia usam a Duda, agente da loja fictícia Passo Certo Calçados, apresentada no guia Personalidade.

1. Quando usar

• Para saber qual versão os clientes estão vendo agora;
• Para descobrir o que mudou entre uma versão e outra;
• Quando uma alteração publicada não ficou boa e você quer voltar atrás;
• Para desfazer as alterações do rascunho que ainda não foram publicadas.

2. Onde encontrar

1. Entre no projeto e clique em Robôs Agentes de IA no menu lateral.
2. Na Listagem de Chatbots, clique no agente.
3. Clique na aba Versões.

A tela mostra o Histórico de Versões do Chatbot, com uma linha por versão e as colunas Nome, Descrição, Data, Status e Ações.

3. O que uma versão guarda

Uma versão guarda as configurações das abas Personalidade, Fluxos, Visual e Utilidades, além das ferramentas do agente.

Ficam de fora:

• Os Eventos, que valem assim que você salva. Veja Eventos;
• Os Canais, como o site e o WhatsApp. Veja Publicação;
• A chave de avaliações da aba Utilidades, que vale para o projeto inteiro.
• As etapas do Fluxo Conversacional, que ficam no editor de fluxos. A versão guarda só o modo de operação escolhido na aba Fluxos.

4. O rascunho

A primeira linha da lista é sempre a Edição Atual (Rascunho): o que você salvou nas abas e ainda não publicou. O status mostra:

• Com alterações: há mudanças salvas que ainda não foram publicadas;
• Sincronizada: o rascunho é igual à versão publicada.

Descartar o rascunho

Quando o rascunho tem alterações, aparece o botão Descartar. Ele apaga as mudanças não publicadas e devolve o agente para as configurações da última versão publicada. A plataforma pede confirmação antes.

Exemplo da Duda: alguém da equipe mudou o jeito de falar da Duda e salvou, mas a loja decidiu não usar a mudança. Em vez de desfazer campo por campo, clique em Descartar e o rascunho volta a ser igual ao que está no ar.

⚠️ Atenção: descartar não tem volta. O que foi salvo e não publicado se perde.

📌 Editando ao mesmo tempo que outra pessoa? Se o rascunho for alterado em outra sessão, a plataforma avisa e pergunta se você quer carregar a alteração ou continuar com a sua. Antes de publicar, ela pede para recarregar a versão mais recente.

5. As versões publicadas

Abaixo do rascunho fica uma linha para cada versão publicada, com o nome e a descrição que você deu ao publicar. O status mostra:

• Publicada (Ativa): a versão que os clientes veem agora. Só uma versão fica ativa por vez;
• Backup: uma versão anterior, guardada para consulta ou para voltar a ela.

Nome e descrição da versão

Ao clicar em Publicar versão, em qualquer aba, a plataforma abre a janela Publicar Nova Versão e pede um Nome da Versão e uma Descrição. São esses textos que aparecem no histórico.

Como escrever:

• No nome, diga em poucas palavras o que mudou;
• Na descrição, conte o motivo ou o detalhe que vai ajudar quem olhar o histórico depois.

Exemplo da Duda: o histórico da Duda fica fácil de ler com versões assim:

Evite nomes como “Versão nova” ou “Ajustes”. Daqui a um mês, ninguém vai lembrar o que eles mudaram.

6. Comparar versões

Clique em Ver Diff na linha de uma versão para ver o que mudou. A janela mostra lado a lado só os campos diferentes:

• Numa versão Publicada (Ativa), a comparação é entre a Versão Anterior e a versão publicada;
• Numa versão Backup, a comparação é entre o Chatbot Atual (Produção) e o backup.

Abaixo dos campos, o bloco Ferramentas (Tools) mostra as ferramentas que foram adicionadas, removidas ou mudadas.

Exemplo da Duda: depois de publicar “Troca grátis em 30 dias”, clique em Ver Diff nessa versão para confirmar que só a regra de troca de Tarefas Principais mudou. A janela mostra algo assim:

Os campos que não mudaram não aparecem na comparação.

7. Restaurar uma versão

Para voltar a uma versão anterior:

1. Na linha da versão Backup, clique em Restaurar Versão.
2. Leia o aviso e clique em Sim, restaurar versão.

A versão restaurada é publicada na hora e passa a ser a Publicada (Ativa). As configurações atuais do agente e as ferramentas são substituídas pelas da versão restaurada.

Exemplo da Duda: a Black Friday acabou. Para tirar a regra de frete grátis acima de R$ 199, restaure a versão “Troca grátis em 30 dias”. A Duda volta a responder com o frete grátis acima de R$ 299.

💡 Dica: antes de restaurar, use Ver Diff para conferir o que vai mudar.

8. Próximo passo

A próxima é a aba Eventos, a última da tela do agente, onde você liga o agente a outros sistemas quando uma conversa começa ou termina.

9. Perguntas frequentes