Servidor, backup e atualizações

Instalação própria e ChatISP Cloud

O ChatISP existe em duas formas, com o mesmo sistema por dentro:

• Instalação própria: o provedor baixa a ISO no site e instala o ChatISP num servidor dele (máquina física ou virtual), com teste gratuito de 10 dias. O provedor é dono da máquina, e por isso o painel traz as telas de rede, domínio, IA local e atualização.
• ChatISP Cloud: a Ravi Systems hospeda o sistema. O provedor se registra, escolhe o plano e um subdomínio e entra direto. A máquina, o domínio, o certificado e as atualizações ficam por conta da Ravi Systems, e as telas de dono de máquina somem do painel.

As abas Rede, Domínio e certificado e IA local ficam em Configurações e exigem a permissão Servidor (rede e certificado). O backup e o registro ficam na aba Sistema e exigem a permissão Configurações.

Rede do servidor Instalação própria

Aba Rede, cartão Endereço IP do servidor: "Endereços, gateway, VLAN e DNS da placa de rede. Salvar guarda a nova configuração; ela só passa a valer em Aplicar, que reinicia a rede." O cartão tem duas sub-abas.

Configuração simplificada

Uma linha por endereço, com os campos Endereço IP, Máscara, Gateway, Placa e VLAN, e o botão Remover. Adicionar endereço cria uma linha nova (endereços extras na mesma placa, VLANs, IPv6). Placa configurada por DHCP aparece como uma linha informativa: para fixar o IP, remova essa linha e adicione o endereço.

A tela valida tudo antes de gravar e recusa com a mensagem do problema: IP ou máscara inválidos, gateway fora da rede do endereço, mais de um gateway por família de IP (um para IPv4 e um para IPv6), VLAN fora de 1 a 4094, placa inexistente, nenhum endereço ou nenhum DNS. Pelo menos um endereço precisa ficar.

Configuração avançada

Edição direta do arquivo de rede do servidor (/etc/network/interfaces), para configurações que o formulário não cobre (pontes, rotas extras, opções específicas). O texto precisa ter pelo menos uma interface configurada. Vale a mesma proteção da configuração simplificada.

Servidores DNS

Campos DNS primário e DNS secundário, comuns às duas sub-abas. É preciso informar ao menos um.

Salvar, aplicar e descartar

1. Salvar guarda a configuração nova sem mexer na rede ("Configuração salva. Ela só passa a valer ao aplicar."). Uma faixa avisa que há configuração salva e ainda não aplicada, com quem salvou e quando.
2. Aplicar e reiniciar a rede pede confirmação ("O painel pode ficar alguns segundos sem resposta.") e reinicia a placa de rede com a configuração salva.
3. O servidor guarda a configuração anterior, reinicia a rede e testa o gateway. Se a rede não subir ou o gateway não responder, ele volta sozinho à configuração anterior e a tela informa o motivo.
4. Se o endereço do painel mudou, a tela conta alguns segundos e abre o painel no endereço novo.
5. Descartar alterações salvas apaga a configuração pendente sem aplicar.

Endereços ativos agora

Cartão informativo com o que a placa está usando neste momento. Pode diferir do arquivo salvo até a rede reiniciar: use-o para conferir o efeito de um Aplicar.

VPN WireGuard Instalação própria

Cartão VPN WireGuard na aba Rede: "Túneis seguros entre este servidor e roteadores ou servidores da sua rede (alcançar equipamentos com IP privado, integrar o ERP, interligar filiais)." Usos típicos: o ChatISP instalado num data center precisa alcançar o ERP ou o Ravicor que estão na rede interna do provedor.

Criar uma VPN

Clique em Adicionar VPN. A janela Nova VPN WireGuard explica: a chave privada fica só neste servidor; a pública é o que se cadastra na outra ponta.

Pontas remotas (peers) e rotas

Conectar e acompanhar

Cada VPN aparece como um cartão com Interface, IP do túnel, Porta, Tráfego, situação (Conectada ou Desconectada) e as pontas remotas. Ações:

• Conectar: sobe o túnel. Exige ao menos um peer e o IP do túnel definido. A VPN conectada volta sozinha depois de um reinício do servidor.
• Desconectar: derruba o túnel, com confirmação ("O que estiver sendo alcançado por ela ficará indisponível.").
• Ver configuração: mostra a Chave pública deste servidor e um Exemplo de configuração da outra ponta, com botões de copiar.
• Configurar com IA: veja a próxima seção.
• Excluir a VPN derruba o túnel e apaga peers e rotas.

Configurar a VPN com IA Instalação própria

O botão Configurar com IA abre uma sessão em que a IA acessa o equipamento remoto por SSH e configura a VPN de ponta a ponta, ao vivo, com backup obrigatório antes de qualquer mudança. Você acompanha cada comando e aprova qualquer ação sensível.

1. Escolha o Tipo do equipamento: MikroTik RouterOS ou Servidor Linux (Debian/Ubuntu).
2. Informe Endereço (IP ou host), Usuário SSH, Porta e Senha SSH. A credencial é usada só nesta sessão, cifrada em repouso, e nunca aparece na tela.
3. Clique em Iniciar configuração. A tela mostra dois terminais lado a lado (Este servidor (ChatISP) e Equipamento remoto) e o raciocínio da IA.
4. No MikroTik, o primeiro passo é sempre um backup completo baixado para este servidor ("Backup do equipamento salvo neste servidor.").
5. Quando a IA quer executar um comando sensível, a tela para e pede Aprovar ou Recusar.
6. Ao final, a IA valida o túnel e a sessão termina com "Configuração concluída e validada." ou com o motivo da falha.

Domínio e certificado HTTPS Instalação própria

Aba Domínio e certificado, cartão Domínio e certificado HTTPS: "Domínios que respondem com HTTPS neste servidor, cada um com certificado Let's Encrypt renovado sozinho. O acesso pelo IP continua funcionando com a CA interna."

Tipos de domínio

Ativação

1. Clique em Adicionar domínio, escolha o Tipo e preencha. "Domínio adicionado. A ativação leva alguns minutos."
2. A linha fica em Ativando…. O servidor confere se o domínio já aponta para ele; enquanto não aponta, a situação mostra "Aguardando o DNS propagar para emitir o certificado…". A espera dura até cerca de 4 horas.
3. Com o DNS certo, o certificado Let's Encrypt é emitido e a linha passa a Ativo, com a validade ("Válido até ...").
4. O primeiro domínio ativo vira o Principal: o endereço padrão do servidor, usado nos links gerados pelo sistema (convites, recuperação de senha, integrações). Troque com Definir como principal.

Situações e ações

Ver detalhes mostra a resposta técnica da última tentativa. Renovar agora num certificado ainda válido não gasta o limite de emissões. Excluir um domínio pede confirmação ("O acesso a ele por HTTPS deixa de funcionar."); no subdomínio chatisp.com.br, o registro DNS é removido da central antes.

Acesso pelo IP

Sem domínio, o painel responde pelo IP do servidor com o certificado da CA interna da instalação, e o navegador mostra um aviso de segurança. Para o acesso pelo IP sem aviso, baixe o arquivo da CA pelo link no rodapé do cartão (ravi-ca.crt) e instale-o nos computadores dos atendentes. O recomendado é ter um domínio: com ele, qualquer navegador abre o painel sem aviso e sem instalar nada.

IA local Instalação própria

Aba IA local, cartão IA local do servidor (selo Gratuito): "Recursos de IA que rodam neste próprio servidor, sem custo por uso: a transcrição dos áudios recebidos e a voz que responde os clientes em áudio. Aqui você vê se estão funcionando, o motivo quando não estão e instala o que faltar."

As três linhas do cartão

Situações

Instalar agora

O botão só aparece quando há algo que ele resolve. Ele baixa o que falta e liga os serviços sem derrubar o atendimento, com uma barra de progresso pelas etapas: preparando, verificando o processador, instalando os componentes da transcrição, baixando o modelo de transcrição, configurando e ligando o serviço, instalando as vozes da IA e concluído. A instalação precisa de internet no servidor; se uma etapa falhar, a tela diz qual e basta clicar de novo.

VPN de suporte da Ravi Systems Instalação própria

Para atender um chamado técnico sem pedir acesso ao seu firewall, o suporte da Ravi Systems pode abrir um túnel temporário até o seu servidor. Não há nada a configurar no painel: o servidor já vem preparado.

• O túnel só sobe quando a equipe de suporte ativa uma sessão para a sua instalação, durante um atendimento. O pedido chega pela sincronização normal com a central.
• Cada sessão dura no máximo 1 hora. O próprio servidor derruba o túnel no prazo, mesmo que perca o contato com a central, e gera chaves novas para a próxima vez.
• O túnel é isolado: não aparece entre as suas VPNs WireGuard, não mexe nas suas rotas nem no gateway e só alcança os endereços do suporte.
• Como a ativação viaja na sincronização da licença, o servidor precisa ter saída para a internet até a central da Ravi Systems.

Backup

Cartão Backup automático, na aba Sistema de Configurações. Existem duas cópias diferentes, que rodam juntas todas as madrugadas:

• O backup automático roda por volta das 2h da manhã (horário do servidor).
• Executar agora dispara as duas cópias na hora, mesmo com o backup diário desligado. Enquanto roda, o cartão mostra "Backup em andamento…" e se atualiza sozinho.
• Só um backup ou restauração roda por vez: um pedido no meio de outro é recusado com aviso.
• A lista Backups guardados neste servidor mostra os mais recentes (até 30), com data e tamanho. Baixar transfere o arquivo para o seu computador, para guardar fora do servidor; o download fica registrado na auditoria.

Restauração e migração

A restauração recoloca os dados de um backup do ChatISP neste servidor. É também o caminho para migrar: de um servidor antigo para um novo, ou da instalação própria para o ChatISP Cloud.

De onde restaurar

• Da lista: botão Restaurar ao lado de um backup guardado neste servidor.
• De um arquivo: botão Enviar backup e restaurar…. Aceita um backup do ChatISP no formato .tar.gz (backup local, com ou sem mídia) ou .sql.gz (cópia só do banco, como a fornecida pelo suporte a partir da cópia diária). O arquivo é enviado em partes, com o andamento na tela, e pode ter centenas de megabytes; se uma parte falhar, o envio recomeça.

Antes de confirmar

A janela Restaurar backup resume o que vai acontecer:

• Todos os dados atuais (conversas, contatos, usuários e configurações) serão substituídos pelos do backup.
• Antes de qualquer mudança, uma cópia de segurança dos dados atuais entra na lista de backups deste servidor (marcada como "cópia de segurança (antes de uma restauração)").
• O token e a licença desta instalação são preservados.
• Ao final, pode ser necessário entrar novamente no painel.

O que acontece depois de Restaurar agora

1. Validação do arquivo.
2. Cópia de segurança dos dados atuais.
3. Pausa dos serviços de atendimento (WhatsApp, chamadas, IA), para nada ser gravado num banco pela metade.
4. Importação do banco de dados. Se a importação falhar, os dados anteriores voltam sozinhos ("A importação falhou; devolvendo os dados anteriores…").
5. Regravação das chaves desta instalação (endereço do painel e chaves dos serviços locais), para o backup de outro servidor não apontar para a máquina antiga.
6. Atualização da estrutura do banco: um backup de versão anterior sobe para a estrutura atual.
7. Restauração dos arquivos de mídia, quando o arquivo tem mídia (os arquivos existentes não são apagados).
8. Religação dos serviços e "Restauração concluída."

Pode fechar a janela: a restauração continua no servidor e o andamento fica no cartão de backup. Se a sessão cair no meio (os usuários também são restaurados), use Recarregar o painel e entre de novo. Uma restauração só do banco (.sql.gz) traz as conversas sem os arquivos: as imagens que faltarem aparecem como uma imagem genérica de "indisponível".

Atualizações de software

Instalação própria O ChatISP instalado se atualiza sozinho, sem intervenção:

1. A cada sincronização com a central, o servidor fica sabendo se há versão nova publicada para ele.
2. A cada 30 minutos, o atualizador confere se há algo a aplicar. Havendo, baixa o pacote do site oficial do ChatISP, confere a assinatura digital da Ravi Systems e só então troca os arquivos.
3. Depois da troca, aplica as mudanças de estrutura do banco e reinicia os serviços necessários. O atendimento segue normalmente.

O andamento aparece no cartão de registro, aba Sistema: linha Atualização de software (Em dia, "Versão X (build N) disponível" ou a falha do último ciclo) e a lista Últimas atualizações. A versão instalada aparece em Versão do ChatISP.

Licença e sincronização com a central

Cada instalação tem um token único e imutável, criado na instalação. O plano, os limites e a situação da licença são decididos pela central da Ravi Systems e chegam ao servidor pela sincronização, que acontece sozinha a cada 10 minutos (e 2 minutos depois de cada reinício). O botão Atualizar do cartão de registro força uma sincronização na hora.

Situações da licença

Prazos sem sinal

• Até 24 horas sem sincronizar: nada muda.
• A partir de 24 horas: quem administra vê no topo do painel "Sem comunicação com a central da Ravi Systems há N h.", com o botão Atualizar.
• Acima de 72 horas (3 dias): a situação vira Sem comunicação com a central e o painel é bloqueado. Basta o servidor voltar a falar com a central para a licença voltar.

Tela de bloqueio

Com a licença bloqueada, o painel abre uma tela própria com o motivo, o token (com Copiar), o botão Sincronizar agora, a ação do caso (registrar, reativar ou pedir segunda via), o link "Dúvidas sobre planos? Fale com a Ravi Systems" e Sair do sistema. Nada é apagado durante o bloqueio, e a equipe de suporte da Ravi Systems continua conseguindo entrar para ajudar.

Limites por plano

Atingido um limite, a tela que cria o item avisa ("Limite de ... atingido") e propõe o upgrade; recurso fora do plano mostra a partir de qual plano ele está disponível. Planos e preços: página de registro no site do ChatISP.

Rotinas automáticas e manutenção

O servidor executa sozinho uma série de rotinas. Conhecer os horários ajuda a entender o que acontece "sem ninguém mexer":