Descrição

Esse tipo de problema é comum em ambientes corporativos com restrições de rede e pode afetar diretamente o uso das ferramentas BotCity.
Entre os sintomas mais frequentes, estão:

• A instalação via Wizard travada em 0%

• Erro ao iniciar o runner

•  Falha de autenticação ao tentar fazer login no BotCity Studio

Diagnóstico

Para auxiliar na identificação dessas falhas, a partir da versão 1.2.5, o Wizard passou a incluir a ferramenta Diagnostic, que tem como objetivo verificar:

• Conectividade com os serviços da BotCity

• Possíveis bloqueios de rede

• Versões de Python e Java instaladas no ambiente

Como usar o Diagnostic:

1. Execute o Wizard normalmente.

2. Forneça suas credenciais do Maestro.

3. Clique em "Run" na seção Diagnostic.

4. O sistema irá gerar um relatório detalhado sobre o ambiente de execução.

Solução

A BotCity opera com serviços em nuvem, e o Runner se comunica com o Maestro via HTTPS (porta 443).
É fundamental garantir que essa porta esteja liberada para comunicação, mesmo que não esteja sendo diretamente ocupada.

Requisitos de rede e ambiente para ambientes restritos:

Liberação de URLs no firewall:

• https://*.botcity.dev/ (porta 443 - Maestro, Studio, APIs)

• https://sdk.botcity.dev/ (porta 443 - SDKs, templates)

Se estiver usando Python para desenvolvimento:

• Liberação para https://pypi.org/* (acesso ao PyPI)

• Instalação do Python 3.8 ou superior (recomendado: 3.10)

• Instalação dos pacotes: pip, virtualenv, setuptools

Se estiver usando Java para desenvolvimento:

• Liberação para https://repo1.maven.org/maven2/ (Maven Central)

• Liberação para https://devtools.botcity.dev:8081/ (Nexus BotCity)

Conclusão

Se você está enfrentando falhas de instalação, autenticação ou execução ao usar ferramentas da BotCity, é altamente recomendável executar o Diagnostic e garantir que os domínios e portas listados acima estejam devidamente liberados no firewall da empresa.