Instalação do WebAgent Protheus3 minutos de leitura

Framework
Precisa de ajuda sobre este assunto em seu ERP?
A instalação correta do WebAgent no TOTVS Protheus é essencial para garantir o funcionamento das rotinas que utilizam integração com o SmartClient WebApp, como assinaturas digitais, anexos e outros recursos que exigem comunicação com o agente local. Neste guia técnico, você encontrará um passo a passo detalhado para configurar o WebAgent tanto pelo administrador do sistema quanto pelo usuário final do ERP, incluindo exemplos de arquivos de configuração, recomendações de segurança e instruções específicas para diferentes sistemas operacionais.

Guia de Instalação do WebAgent – TOTVS Protheus

Versão aplicável: WebApp 9.0.3 ou superior

1. Para o Administrador do Sistema

Essa configuração define como o SmartClient WebApp irá fornecer o instalador do WebAgent para os usuários, utilizando o AppServer.

1.1 Configuração via AppServer.INI

A prioridade de leitura de configurações do WebAgent é:

Conteúdo Exclusivo!👇
  • 1º: AppServer.INI
  • 2º: webagent.json (caso o INI não esteja configurado)

Exemplo de configuração no arquivo AppServer.INI:

Importante: Após salvar o arquivo, reinicie os AppServers para aplicar as configurações.

1.2 Configuração via webagent.json

Alternativamente, você pode configurar um arquivo webagent.json contendo os links para os instaladores. Exemplo:

No AppServer.INI, configure o parâmetro abaixo:

Depois, crie o arquivo webagent.json com o seguinte conteúdo:

Observações:

  • Em Windows, use barras duplas (\\) nos caminhos.
  • Mantenha o campo version atualizado a cada alteração nos instaladores.

1.3 Bloqueio de Porta

Para impedir que o usuário altere a porta manualmente, configure:

Essa configuração remove a opção “Habilitar/Desabilitar Agente Local” do menu do usuário.

2. Para o Usuário do ERP

2.1 Pré-requisito no Linux (Red Hat 8+)

Instale a biblioteca necessária para o WebAgent funcionar corretamente:

Depois de instalada, ao acessar o WebApp pela primeira vez, o sistema permitirá o download automático do instalador.

2.2 Processo de Instalação

  • O pop-up de instalação é exibido na primeira conexão bem-sucedida entre navegador e WebAgent.
  • O usuário pode marcar “Não mostrar novamente” após a instalação.
  • O sistema operacional é detectado automaticamente para oferecer o instalador correto.
  • No Windows, o tipo de Office (32 ou 64 bits) também é considerado para selecionar o instalador adequado.

Após baixar, o usuário deve executar o instalador. O WebAgent será adicionado ao menu do sistema operacional.

O WebApp iniciará o WebAgent automaticamente sempre que necessário, sem a necessidade de ações manuais.

O usuário pode iniciar manualmente o WebAgent — ele será exibido na área de notificação (systray).

Resumo Técnico

Perfil Ações Recomendadas
Administrador Configurar AppServer.INI ou JSON; definir VERSION e Port; reiniciar AppServer.
Usuário ERP Instalar biblioteca (Linux), baixar e executar instalador via WebApp.

Fernando Bueno
Siga na rede

Fernando Bueno

Consultor em FBSOLUTIONS
Sou consultor na área de implantação de sistemas ERP, com experiência na análise e implantação de projetos de sistemas, configurando a estrutura do software, capacitando usuários-chaves, ministrando treinamentos e workshops.

Atuando desde 2005 no mercado de tecnologia, desenvolvendo e implantando e sistemas gerenciais, sistemas e sites web e ecommerce.

Siga-me no Linked In
Fernando Bueno
Siga na rede

Últimos posts por Fernando Bueno (exibir todos)