Como funciona a migração de arquivos com o novo Gerenciador de Recursos no Smartons?
O que muda com o novo Gerenciador de Recursos em Smartons genéricos?
Antes, cada arquivo que você carregava em um Smarton genérico ficava associado unicamente a esse Smarton. Isso gerava:
Duplicação de documentos
Dificuldade para manter informação atualizada
Risco de inconsistências entre fluxos
Com o Gerenciador de Recursos centralizado:
Os arquivos são carregados uma só vez
Podem ser reutilizados em múltiplos Smartons e fluxos
As atualizações impactam automaticamente em todos os Smartons que os referenciam
Onde aparecerá esta atualização?
Aplica-se a:
Quem utiliza Flowbuilder com Smartons genéricos
Casos onde se carregam documentos como: catálogos FAQs políticas bases de conhecimento
catálogos
FAQs
políticas
bases de conhecimento
Não se aplica a:
Smartons que consomem informação exclusivamente via API
Bases conectadas por integrações externas (por exemplo, Google Sheets via API)
Componentes de mensagens ou catálogos gerenciados desde integrações
A migração de arquivos é automática?
Não. A migração não é automática. É um processo manual que é optativo por enquanto.
Os Smartons e fluxos existentes seguem funcionando exatamente igual até que se decida editar um fluxo.
👉A migração só é solicitada quando você decide tentar editar um fluxo que contém Smartons genéricos com arquivos depreciados.
Quando se solicita a migração?
A solicitação de migração aparece unicamente neste cenário:
Você clica em Editar fluxo (já seja um fluxo publicado ou em rascunho)
O sistema detecta Smartons genéricos com arquivos desatualizados.
Nesse momento, Atom mostra um modal informativo convidando a realizar a migração.
Como se faz a migração passo a passo?
1) Edite seu fluxo
Acesse um fluxo existente.
Clique em Editar fluxo.
Se o fluxo contém arquivos depreciados ou desatualizados, será mostrado um aviso de migração.
2) Revise o modal de migração
O modal indica:
quantos arquivos precisam ser migrados
em que Smartons estão sendo utilizados
Neste ponto, aqui você decide como continuar.
3) Escolha uma opção
Opção A — Clique no botão Migrar todos
Inicia-se o processo de migração após clicar no botão Migrar Todos.
Os arquivos são transferidos para o Gerenciador de Recursos.
O fluxo entra em estado “Migrando”.
Durante este estado as ações de gestão do fluxo (editar, duplica, desativar, etc.) ficam desabilitadas temporariamente até que finalize o processo de migração.
Opção B — Clique no botão Omitir por agora
Não se executa nenhuma migração.
O fluxo se abre corretamente para sua edição, permitindo realizar mudanças, guardá-las e publicá-las. É importante ter em conta que, nos Smartons genéricos, se conserva a UI de carga anterior, dado que este tipo de Smarton não utiliza o Gerenciador de Recursos.
A migração fica pendente para outro momento.
4) Espere a finalização da migração
O processo pode demorar alguns minutos (segundo peso e quantidade de arquivos).
Você pode navegar por outros módulos de Atom sem problema.
Ao finalizar, você receberá um e-mail de confirmação.
5) Edite o fluxo já migrado
As ações de gestão do fluxo se habilitam novamente e você já pode proceder a editá-lo.
A migração não se volta a solicitar para esse fluxo.
Os arquivos ficam armazenados no Gerenciador de Recursos.
O que acontece se algo falha durante a migração?
Não há risco de perda de informação:
O fluxo original se conserva sem mudanças
A migração se executa em paralelo
Se ocorre um erro: o processo se reverte o fluxo fica exatamente como estava antes os arquivos não se perdem
o processo se reverte
o fluxo fica exatamente como estava antes
os arquivos não se perdem
O que ocorre se o mesmo arquivo estava carregado várias vezes?
Se o sistema detecta arquivos idênticos:
Realiza uma análise automática
Unifica os documentos duplicados
O arquivo fica armazenado uma só vez no Gerenciador de Recursos
Se mantém a referência em todos os Smartons correspondentes
Como se gerenciam os arquivos desde um Smarton depois de migrar?
Uma vez migrado o fluxo, desde a configuração do Smarton você pode:
Selecionar arquivos existentes desde o Gerenciador de Recursos (para acessar você deverá ir ao Smarton > Personalização do Smarton > Bases de Conhecimento). Habilitando o Toogle, você poderá selecionar os arquivos que considere a serem utilizados.
Carregar novos arquivos diretamente desde o Smarton
Atualizar um arquivo subindo uma nova versão
Retirar um arquivo do Smarton sem eliminá-lo do Gerenciador de Recursos
Se um arquivo está referenciado em outros Smartons ou fluxos, qualquer atualização se refletirá automaticamente em todos eles.
O que facilita esta mudança?
Este novo modelo está desenhado para simplificar a manutenção e reduzir erros:
Atualizações em um só lugar Um documento se atualiza uma vez e se reflete em todos os Smartons que o usam.
Atualizações em um só lugar
Um documento se atualiza uma vez e se reflete em todos os Smartons que o usam.
Menos inconsistências Se evita que alguns fluxos fiquem com informação desatualizada.
Menos inconsistências
Se evita que alguns fluxos fiquem com informação desatualizada.
Reutilização sem duplicar arquivos Já não é necessário subir o mesmo arquivo múltiplas vezes.
Reutilização sem duplicar arquivos
Já não é necessário subir o mesmo arquivo múltiplas vezes.
Menor esforço de manutenção Especialmente útil para catálogos, FAQs e documentos que mudam com frequência.
Menor esforço de manutenção
Especialmente útil para catálogos, FAQs e documentos que mudam com frequência.
A migração será obrigatória em um futuro?
Sim, mas de forma progressiva.
Inicialmente, a migração é manual e opcional ao editar
Durante as primeiras semanas, Atom monitorará o comportamento e possíveis incidências
Uma vez validada a estabilidade, a migração passará a ser obrigatória para editar fluxos com arquivos depreciados ou desatualizados.
Importante:
🔒 Por enquanto, nada se migra sem seu consentimento.
A migração só é solicitada quando você decide editar seu fluxo e se executa unicamente se você o confirma.