Atualização do sistema#

Uma versão nova traz correções e recursos. Ela também é o momento de maior risco da operação, porque muda tudo de uma vez. Esta página é o procedimento que reduz esse risco.

Antes de atualizar#

1. Faça um backup e confirme que ele terminou — veja Backup e restauração.
2. Exporte os fluxos ativos — veja Importar e exportar fluxo.
3. Anote a versão atual, para saber de onde você veio.
4. Escolha o horário. Fora do pico, e com gente disponível para acompanhar depois.
5. Avise a equipe.

O item 4 merece ênfase: atualizar às 17h de uma sexta-feira significa descobrir os problemas no sábado, sem ninguém para resolvê-los.

Como fazer#

O instalador é reexecutável. Depois de trazer o código novo:

sudo bash instalar.sh --somente-atualizar

Ele atualiza o código, as dependências e o painel compilado.

O que ele não toca#

Rodar o instalador de novo não mexe no que já está gravado: os segredos, o arquivo de ambiente, a pasta de armazenamento e o banco ficam como estão.

Isso não é detalhe de conveniência. Cada um desses tem uma consequência concreta se for reescrito:

• Reescrever o segredo de autenticação desloga todos os operadores de uma vez.
• Reescrever o token do bot separa o bot do painel.
• Reescrever o segredo de sessão derruba as sessões abertas.

Depois de atualizar#

Confira, nesta ordem:

1. O painel abre e você consegue entrar.
2. Os canais estão conectados — veja em Canais.
3. Chega mensagem. Mande uma de outro número.
4. Sai mensagem. Responda.
5. A integração com o ERP responde. Teste a conexão.
6. A Sala de máquinas está verde — veja Diagnóstico.

Os passos 3 e 4 são os que importam: painel abrindo não prova que o atendimento funciona.

Se a atualização der problema#

Não restaure o backup por reflexo. Restaurar perde tudo que aconteceu desde o backup, e a maior parte dos problemas de atualização tem conserto local: um serviço que não subiu, uma dependência faltando, uma configuração nova sem valor.

Comece pelo diagnóstico: qual peça está fora, e o que ela derruba. Só considere restaurar se os dados estiverem inconsistentes.

Se algo der errado#

O painel não abre. Confira se o servidor web subiu e se o processo do sistema está rodando.

O painel abre mas não chega mensagem. Confira os canais. Um canal de WhatsApp por QR Code pode precisar de reconexão.

Todo mundo foi deslogado. O segredo de autenticação mudou. Não deveria acontecer numa atualização normal.

Uma tela some do menu. Pode ser permissão nova que ninguém tem ainda — veja Permissões e grupos.

A versão continua a mesma depois de atualizar. O código novo não chegou. Confira se a atualização do repositório foi feita antes de rodar o instalador.