Etapas de configuração

Pré-requisitos e etapas de configuração para o SDK JavaScript do Robô: instalação do complemento JavaScript e configuração de acesso ao aplicativo.

Esta página abrange os pré-requisitos e a configuração para usar o SDK JavaScript do Robô em aplicativos da web personalizados, incluindo a configuração do navegador e do acesso ao consentimento do Robô, instalando o SDK e configurando o complemento JavaScript.

Pré-requisitos

Os seguintes pré-requisitos devem ser atendidos para projetos de automação para usar o SDK JavaScript do Robô:

• UiPath Robot 2026.10 installed
• O Add-on UiPath JavaScript instalado na máquina do Robô

Permitindo o acesso

Quando o complemento JavaScript do UiPath Robô é executado, o acesso deve ser concedido para que seu aplicativo personalizado ou página da web se conecte ao Robô. O acesso é tratado por uma caixa de diálogo em duas etapas — ambas as etapas devem ser confirmadas para executar o RobotJS. Ambas as caixas de diálogo são compatíveis com a automação conforme descrito nas seções a seguir.

Caixa de diálogo Acesso do navegador

Essa etapa se refere ao navegador que solicita permissões para abrir o UiPath Assistant.

Caixa de diálogo aceitando automaticamente o acesso do navegador

The uipath-web protocol is the UiPath Robot web protocol handler. Browsers ask for permission before they open it. You can automate this dialog through your browser's enterprise policies.

Observação:

Based on the browser used, different settings need to be configured. For the exact policy and value format, see the enterprise policy documentation of your browser.

Caixa de diálogo Consentimento do robô

A caixa de diálogo Consentimento do Robot é usada para permitir a conexão entre o Robot JavaScript SDK e o Executor do Robô.

Caixa de diálogo Aceitando automaticamente o consentimento do Robot

A Variável de ambiente do sistema UIPATH_ROBOTJS_ALLOWLIST aceita automaticamente o diálogo de consentimento do robô.

The value is a list of origins separated by semicolons. Each origin includes the scheme, for example https://myapp.contoso.com. Add the port only if it is not the default (80 or 443).

Exemplo:

UIPATH_ROBOTJS_ALLOWLIST=https://cloud.uipath.com;https://mydomain.com

The Robot already accepts the UiPath cloud origins by default, so you only add your own origins. For the default list, see the AllowUrlList key in Configuration files.

O SDK de JavaScript do Robô

This SDK provides all the necessary methods and properties you can include in your custom application or web page. It is available as an npm package with TypeScript bindings. To include it in your project:

1. Execute o seguinte comando na raiz do diretório do seu projeto:

   npm install --save @uipath/robot
   

To load the SDK with a <script> tag instead, use dist/js/UiPathRobot.js from the package.

Observação:

Version 1.3.3, the last one published to download.uipath.com, remains available at https://download.uipath.com/js/1.3.3/UiPathRobot.js. Newer versions are published only on npm.

Configurações de Add-on

Para definir configurações de complemento:

1. Open the UiPath.config file: %ProgramFiles%\UiPathPlatform\Robot\<version>\UiPath.config for a per-machine installation, or %LocalAppData%\Programs\UiPathPlatform\Robot\<version>\UiPath.config for a per-user installation. For details, see Configuration files.
2. Adicione os parâmetros ListenerPort e TokenExpiryInDays à seção <robotJsSettings>. Por padrão, a seção não contém nenhuma chave:

<robotJsSettings>
    <add key="ListenerPort" value="2323" />
    <add key="TokenExpiryInDays" value="30" />
</robotJsSettings>

Atributo	Description
ListenerPort	The UiPath.RobotJS.ServiceHost.exe starts a HttpListener on the configured port and contains the information about other local listeners from the active user session on that system. The port value must match the one configured in the SDK Settings. The default value is 2323.
TokenExpiryInDays	Any request coming from a new domain needs to have consent from the user to allow access of UiPath Robots from a web application. These consents are valid for the said number of days mentioned in this setting. The default value is 30.

After you edit the file, restart the UiPath RobotJS Service service for the changes to take effect. For the steps, see Restarting robot components.