Pré-requisitos¶

Conta da BotCity¶

O principal pré-requisito para usar o BotCity Studio SDK é ter uma conta BotCity.

Se você ainda não tiver uma, pode criar uma nova conta clicando aqui.

Java¶

Todas as ferramentas do BotCity Studio SDK estão implementadas em Java.

Para usar as ferramentas, você precisa ter o Java 11 ou superior instalado. Se você ainda não o tiver, pode baixá-lo na página de downloads do Java.

Ambiente de desenvolvimento¶

Java¶

Para poder desenvolver automações usando Java, você precisa ter a versão 11 do Java SDK ou superior instalado.

Se você ainda não o tiver, pode baixá-lo na página Java Downloads.

Você também precisará do Maven 3.5 ou superior. Se você ainda não o possui, pode baixá -lo na página de download do Maven 3.

Python¶

Para o desenvolvimento utilizando Python, você precisa ter o Python 3.7 ou superior instalado. Se você ainda não o tiver, pode baixá-lo na página de download do Python 3.

Dependências adicionais variam de acordo com suas necessidades, então preste atenção à documentação de cada ferramenta.

Node¶

Para o desenvolvimento utilizando Node, você precisará do Node 16 ou superior instalado em sua máquina. Se você ainda não o tiver, você pode baixá-lo na página de download do Node

Ambiente de execução¶

O ambiente de tempo de execução é composto pelo BotCity Runner e outras dependências adicionais necessárias para executar suas automações.

Como o BotCity Runner é um aplicativo Java, você precisa ter o Java 11 ou superior instalado, conforme mencionado acima.

Se você também pretende executar as automações desenvolvidas em Python no seu ambiente, precisará instalar o Python 3.7 ou superior, bem como as seguintes dependências:

Importante

Se você estiver executando o BotCity Runner em uma máquina Linux e usando o Python do sistema, precisará instalar as seguintes dependências:

python3.8-pip
python3.8-virtualenv

Observação

Os nomes dos pacotes acima são para distribuições Linux baseadas em Debian/Ubuntu.

Para outras distribuições, consulte a documentação da sua distribuição.

Problemas com bloqueios do ambiente¶

Se você está tentando utilizar as ferramentas da BotCity em um ambiente corporativo, pode se deparar com alguns problemas relacionados aos bloqueios do ambiente.

Entre os problemas mais comuns ao utilizar o BotCity Studio SDK em ambientes que possuem bloqueio, estão:

Instalação através do Wizard travada em 0%.
Falha ao realizar o login no BotCity Studio.
Erro de autenticação ao iniciar o BotCity Runner.

Caso você tenha observado um dos problemas acima, recomendamos entrar em contato com o time de TI da sua empresa e solicitar as seguintes liberações:

Conexão com o BotCity Maestro¶

O orquestrador Maestro funciona em nuvem e o Runner se comunica com o Maestro via HTTPS (443), mas não ocupa essa porta, apenas precisa que ela fique aberta para comunicação.

Requisitos para usar as ferramentas da BotCity em ambientes de bloqueio:

Liberação no firewall para acesso a https://*.botcity.dev/ (porta 443 HTTPS)
Liberação no firewall para acesso a https://sdk.botcity.dev/ (porta 443 HTTPS)

Utilizando Python no desenvolvimento¶

Caso seja utilizado Python para desenvolver as automações, será necessário:

Liberação no firewall para acesso a https://pypi.org/* (Python Package Index - PyPI)
Instalação do Python 3.8 ou superior
Instalação dos pacotes pip, virtualenv e setuptools

Utilizando Java no desenvolvimento¶

Caso seja utilizado Java para desenvolver as automações, será necessário:

Liberação no firewall para acesso a https://repo1.maven.org/maven2/ (Maven Central)
Liberação no firewall para acesso a https://devtools.botcity.dev:8081/ (Nexus BotCity)