Acessando a Tela de Parâmetros do WebApp, agora será exibida a tela para download dos instaladores:
Importante 🚨O Popup para instalação do WebAgent deixará de ser exibido assim que a primeira conexão entre ele e o Navegador for bem sucedida, para que não induza o usuário a instalar mais de uma vez a ferramenta. 🚨O checkbox "Não mostrar novamente" deve ser usado caso o usuário não precise instalar o WebAgent e também não queira que esta opção continue sendo exibida. 
O instalador vai sugerir o Sistema Operacional, caso utilize o Windows 64 bits, mas possua o Microsoft Office 32 bits, poderá instalar o WebAgent 32 bits para garantir essa integração, mais detalhes aqui. 
| Deck of Cards |
|---|
| | Card |
|---|
| Para instalação no WindowsApós o download do instalador, basta iniciar sua instalação, que irá seguir sem intervenção do usuário.  Image Modified
O programa ficará disponível no menu, como neste exemplo utilizando o Windows 11.  Image Modified
O WebApp irá iniciar o WebAgent sempre que necessário a partir deste momento, mais detalhes consulte a seção Habilitar WebAgent na Tela de Parâmetros. Apenas para testes, você pode iniciar a aplicação, será exibido o ícone na bandeja, como no exemplo abaixo.  Image Modified
|
| Card |
|---|
| Para instalação no LinuxApós baixar o arquivo para o seu respectivo Linux, sendo o arquivo .deb para Ubuntu e .rpm para o Red Hat. Para Ubuntu  Image Modified
No diretório onde o arquivo .deb foi copiado
sudo apt install ./web-agent<versao>.deb
|
Caso tenha problema durante a instalação, o comando abaixo define o arquivo como um instalador, execute e na sequencia repita o comando acima
sudo chmod +x ./web-agent<versao>.deb
|
Para Red hat 8.x  Image Modified
Pré requisito: Necessário instalar a biblioteca libappindicator
sudo dnf install libappindicator-gtk3
|
No diretório onde o arquivo .rpm foi copiado
sudo dnf install ./web-agent<versao>.rpm
|
Caso tenha problema durante a instalação, o comando abaixo define o arquivo como um instalador, execute e na sequencia repita o comando acima
sudo chmod +x ./web-agent<versao>.rpm
|
Registro do Certificado (SSL) para uso do WebAgent (topo)
Para utilizar o Websocket Secure (wss) é necessário registrar o TOTVS Certificate em seu sistema operacional.  Image Modified Para usuários Windows
O registro é automático para Windows 10/11, 32 ou 64 bits, e será efetivado na primeira execução do WebAgent. 🚨 Importante:
Na primeira execução do WebAgent, caso seja apresentada a tela de confirmação para o registro do certificado, selecione a opção Sim.  Image ModifiedPara usuários Linux
Image Modified Ubuntu - Após a instalação do WebAgent
- Localize o arquivo totvs_certificate_CA.crt na pasta /opt/web-agent
- Acesse seu navegador e efetue o registro:
- Para o Google Chrome
- Na barra de navegação digite: chrome://settings/certificates
- Acesse: Authorities (autoridades)
- Na sequência: Import (importar)
- Selecione o totvs_certificate_CA.crt na pasta /opt/web-agent
- Selecione todos os Trusts, e por fim, o botão OK
 Image Modified
Para o Microsoft Edge Na barra de navegação digite: edge://settings/privacy/manageCertificates Acesse: Authorities (autoridades) Na sequência: Import (importar) - Selecione o totvs_certificate_CA.crt na pasta /opt/web-agent
Selecione todos os Trusts e Okay
 Image Modified
Para o Firefox Na barra de navegação digite: about:preferences#privacy Acesse: View Certificates… (verificar certificados) Acesse: Authorities (autoridades) Na sequência: Import (importar) - Selecione o totvs_certificate_CA.crt na pasta /opt/web-agent
Selecione todos os Trusts e OK
 Image Modified
Image Modified Red Hat 8.x |
|
Habilitar WebAgent na Tela de Parâmetros (topo)
Para habilitar o uso do WebAgent pelo WebApp, na Tela de Parâmetros, selecione o botão de configuração. 
Escolha a porta de inicialização do WebAgent (por padrão é a 21021). 
Na sequencia feche essa janela clicando no X na parte superior da janela de configuração. 
Assim que confirmar os dados na Tela de Parâmetros, será exibida a mensagem abaixo, solicitando autorização para abertura do WebAgent, basta clicar no botão Abrir. 
Após dez tentativas de conexão malsucedidas ou caso a solicitação de autorização seja ignorada, será exibida a seguinte mensagem: Falha ao conectar com o WebAgent! 
Para maiores informações, acesse: 2. WebApp - WebAgent | 
