Data de publicação: 13/04/2026

🎯 Objetivo

Orientar como habilitar o agente local no Protheus, tanto pela interface do WebApp quanto por configuração automática via AppServer.ini, para permitir o uso do recurso de forma prática e padronizada. (Central de Atendimento TOTVS)

🧩 Ambiente

Cross Segmento – TOTVS Backoffice (Linha Protheus) – ADVPL
Aplicável a partir da versão: 12.1.2310. (Central de Atendimento TOTVS)

🔎 Visão geral

Segundo a orientação oficial da TOTVS, o agente local pode ser habilitado diretamente na abertura do WebApp, por meio do botão de engrenagem, ou de forma automática através de parametrização no AppServer.ini com suporte ao WebAgent. (Central de Atendimento TOTVS)

Na prática, isso permite simplificar a ativação do recurso conforme o cenário da empresa: manualmente pelo usuário, em acessos pontuais, ou automaticamente pela configuração do ambiente, quando se busca maior padronização operacional. Essa leitura é compatível com o procedimento descrito pela TOTVS para o WebApp e WebAgent. (Central de Atendimento TOTVS)

⚙️ Como habilitar o agente local pelo WebApp

1. Acessar a abertura do WebApp

Na tela inicial do WebApp, localize o botão de engrenagem. A TOTVS informa que é a partir desse menu que a habilitação pode ser feita manualmente. (Central de Atendimento TOTVS)

2. Selecionar a opção de habilitação

Após abrir o menu, selecione a opção:

“Habilita/Desabilita o Agente Local”. (Central de Atendimento TOTVS)

Com isso, o recurso será ativado ou desativado conforme a necessidade do ambiente ou do usuário.

🛠️ Habilitação automática via configuração

Além da habilitação manual pelo WebApp, a TOTVS também informa que é possível habilitar o agente local de forma automática por meio do arquivo AppServer.ini, utilizando a configuração relacionada ao WebApp + WebAgent. (Central de Atendimento TOTVS)

Esse modelo costuma ser mais indicado quando a empresa deseja deixar o comportamento previamente definido no ambiente, reduzindo intervenção manual dos usuários no acesso diário.

✅ Resultado esperado

Após a habilitação, o ambiente passa a operar com o agente local ativo, seja por ação manual no WebApp ou por definição automática no AppServer.ini, conforme a estratégia adotada na instalação do Protheus. (Central de Atendimento TOTVS)

💡 Boas práticas

• Validar se o ambiente está realmente na versão compatível com o recurso. (Central de Atendimento TOTVS)

• Padronizar a habilitação via AppServer.ini quando houver muitos usuários ou necessidade de configuração centralizada. (Central de Atendimento TOTVS)

• Em acessos de teste ou homologação, utilizar primeiro a ativação manual para validar o comportamento antes de automatizar.

• Revisar também a documentação complementar de WebAgent e WebApp + WebAgent indicada pela própria TOTVS. (Central de Atendimento TOTVS)

❓ FAQ

1. Como habilitar o agente local manualmente no Protheus?

Pela abertura do WebApp, acessando o botão de engrenagem e selecionando a opção “Habilita/Desabilita o Agente Local”. (Central de Atendimento TOTVS)

2. Existe forma automática de habilitação?

Sim. A TOTVS informa que a habilitação também pode ser feita automaticamente via AppServer.ini, utilizando a configuração relacionada ao WebApp + WebAgent. (Central de Atendimento TOTVS)

3. Em qual versão o recurso está disponível?

A orientação se aplica ao Protheus a partir da versão 12.1.2310. (Central de Atendimento TOTVS)

4. Onde o usuário encontra a opção para habilitar?

No menu de engrenagem exibido na abertura do WebApp. (Central de Atendimento TOTVS)

5. Quando vale a pena usar habilitação automática?

Quando a empresa deseja uma configuração centralizada e padronizada do ambiente, evitando ativação manual por cada usuário.

👤 Autor

Fabrizio Augusto Ventavolo
Consultor Especialista TOTVS — Mastersiga Consultoria

“Conectamos tecnologia, processos e pessoas para acelerar resultados com excelência em sistemas TOTVS.”