Como resolver o problema de instalação travada em 0% no BotCity Studio ?
Visão Geral
Se ao tentar instalar o BotCity Studio ou iniciar o BotCity Runner, a instalação permanece travada em 0%, ou ocorrem erros de autenticação e login, é muito provável que o ambiente corporativo esteja bloqueando as conexões necessárias para o funcionamento das ferramentas da BotCity.
Esse é um problema recorrente em redes corporativas com políticas restritivas de segurança e filtragem de internet.
Sintomas Comuns
Os principais comportamentos observados em ambientes com bloqueios são:
Instalador (Wizard) travado em 0%.
Falha ao realizar login no BotCity Studio.
Erro de autenticação ao iniciar o BotCity Runner.
Causa Provável
As ferramentas da BotCity precisam se comunicar com servidores na nuvem, realizar autenticações e instalar pacotes online. Quando essa comunicação é bloqueada por firewalls, proxys corporativos ou restrições de rede, esses erros ocorrem.
Solução Recomendável
Entre em contato com o time de TI da sua empresa e solicite as liberações descritas abaixo para que o ambiente funcione corretamente com as ferramentas da BotCity.
Requisitos de Liberação para Ambientes Corporativos
Conexão com o BotCity Maestro
O Maestro é o orquestrador em nuvem da BotCity. O Runner precisa se comunicar com ele via HTTPS (porta 443) — essa porta não precisa ser ocupada, mas precisa estar liberada para tráfego de saída.
URLs que precisam ser liberadas no firewall/proxy:
| Tipo de Serviço | URL |
|---|---|
| Comunicação com o Maestro | https://*.botcity.dev/ |
| SDK BotCity | https://sdk.botcity.dev/ |
| Autenticação | https://auth.botcity.dev/ |
Utilizando Python no Desenvolvimento
Caso o desenvolvimento das automações utilize Python, é importante garantir também o acesso às URLs responsáveis pela instalação de bibliotecas e pacotes.
Requisitos adicionais:
Python 3.8 ou superior instalado
Ferramentas:
pip,virtualenvesetuptools
URLs adicionais que devem ser liberadas:
| Serviço | URL |
|---|---|
| Repositório oficial de pacotes PyPI | https://pypi.org/* |
| Download de pacotes do PyPI | https://files.pythonhosted.org/ |
files.pythonhosted.org é utilizado pelo PyPI para hospedar as versões dos pacotes Python. Sem essa liberação, comandos como pip install podem falhar.Conclusão
Problemas de instalação travada ou autenticação no BotCity geralmente estão relacionados a restrições de rede no ambiente corporativo. Com as devidas liberações no firewall e proxy, tanto o processo de instalação quanto o funcionamento das ferramentas será normalizado.
Para mais informações técnicas, consulte a documentação oficial da BotCity.
Related Articles
Como resolver erros de SSL ao instalar dependências com o pip em ambientes corporativos ?
Visão Geral Ambientes corporativos costumam ter políticas de segurança rígidas que restringem o acesso a determinados recursos da internet. Por isso, é comum que ocorram falhas ao utilizar ferramentas como o pip (gerenciador de pacotes do Python) em ...Problemas de Conectividade com as Ferramentas BotCity: Como Diagnosticar e Resolver
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 ...Como resolver o erro “ModuleNotFoundError” ao executar a automação ?
Visão Geral Se ao rodar sua automação você encontrar o erro: ModuleNotFoundError: No module named 'botcity' isso indica que o ambiente de execução não está encontrando o pacote necessário. Esse problema geralmente está relacionado à instalação ...Como resolver o erro Python environment preparation failed
Um erro muito comum ao executar automações pelo Runner é o Python Environment preparation failed. . Como o próprio nome diz, o Runner falha ao tentar preparar o ambiente python para execução da robô. Este erro é lançado em situações diversas, e ...Solucionando problemas ao usar ‘Print Screen’ no BotCity Studio
Em alguns casos esporádicos, ao utilizar a tecla de 'Print Screen' para que uma captura de tela seja feita, a imagem capturada não é exibida no Studio. Esse comportamento pode estar relacionado com diversos fatores, como por exemplo outras aplicações ...