Perguntas frequentes
Como resolver o problema com a instalação das dependências ao executar a automação (ModuleNotFoundError)?
Esse tipo de problema costuma ocorrer quando a etapa de instalação das dependências não é feita da forma correta.
Ao rodar o código, é lançada uma mensagem referente a instalação dos pacotes: ModuleNotFoundError: No module named 'botcity’.
A primeira etapa é garantir que o mesmo interpretador Python está sendo utilizado para instalar as dependências e executar o código.
Um erro comum de acontecer é com a criação de ambientes virtuais, pode ser que o ambiente onde as dependêcias foram instaladas seja diferente do ambiente que está sendo utilizado para executar o código.
- Verifique no terminal se o ambiente virtual está ativo.
- Se estiver utilizando o botão
runda IDE, verifique se está executando no ambiente virtual correto. - Utilize o comando para instalar as dependências no ambiente correto:
pip install --upgrade -r requirements.txt. - Use o comando
pip listpara verificar se o pacotebotcitye outros estão instalados no ambiente virtual ativo.
Aviso
Se você estiver tendo um problema parecido com outras dependências ao executar sua automação usando o BotCity Runner,
verifique se a dependência foi corretamente definida no arquivo requirements.txt do robô.
Erro ao abrir Studio no VSCode
Pode acontecer de o BotCity Studio não abrir corretamente no Visual Studio Code. Isso pode ocorrer por razões, como problemas de configuração ou conflitos ou falta de um projeto.
Para isso, verifique os pontos:
- A versão do Java instalada para utilizar o BotCity Studio requer o Java 11 ou superior.
- A etapa de login deve ser realizada corretamente.
- Existe um projeto carregado no VSCode? É necessário para que o Studio reconheça a linguagem para gerar código.

- Existe mais de um projeto aberto? O ideal é que tenha apenas um projeto por vez, para que as imagens sejam direcionadas ao local certo.
- Altere o
Log Levelnas configurações da extenção paradebuge verifique o log de erros noOUTPUTdo VSCode.
Erro ao recortar Studio no VSCode
É comum a confusão do uso dos botões de screenshot, de documentation do Studio e o recorte de elementos na tela carregada.
Se for esse o caso, verifique a função de cada botão. Para fazer o recorte de elementos após carregada a imagem, clique diretamente da tela, próximo ao elemento que deseja recortar, sem necessidade de utilizar os botões.
| Screenshot | Documentation |
|---|---|
![]() |
![]() |
O elemento selecionado no Web Inspector retorna erro
Um erro comum que podem acontecer é selecionar a camada incorreta do elemento.
No terminal pode aparecer um retorno semelhante a este:
File "C:\Users\...\Projeto\bot-rh\bot.py", line 63, in main
element.click()
^^^^^^^^^^^^^
AttributeError: 'NoneType' object has no attribute 'click'
Note esse exemplo da imagem com o botão New Job Posting, podemos selecionar tanto a Tag button quando a Tag span.
| Button | Span |
|---|---|
![]() |
![]() |
Esse erro também pode acontecer quando um elemento é dinâmico, ou seja, em um momento o seletor é encontrado e em outro não. Como no exemplo dos elementos rádio do formulário da automação web.



