JavaScript "Olá Bot Web"¶
Este tutorial o guiará através do processo de criação de uma automação Web JavaScript simples.
Pré-requisitos¶
- Conta da botcity
- Botcity Studio SDK
- Node 16
Baixando o Webdriver¶
Para poder trabalhar com automações Web, precisamos usar o WebDriver correspondente para se comunicar com os navegadores para automação. Feito isso, é necessario que o webdriver do navegador escolhido seja instalado e disponível preferencialmente em seu PATH. Se você não puder adicionar o WebDriver necessário ao seu PATH, poderá informar o driver path via código em seu bot.
Aqui está uma lista de navegadores suportados juntamente com os links para você baixar o WebDriver adequado:
| Navegador | Download do WebDriver | 
|---|---|
| Chrome | ChromeDriver | 
| Firefox | GeckoDriver | 
| Borda | MSDriverEdge | 
| IE | IEDriverServer | 
Siga as instruções no site da Webdriver para instalação e configuração.
Uma vez instalado o WebDriver desejado para o navegador Web a ser usado, podemos prosseguir para as próximas etapas.
Orquestração de pacotes usando navegadores¶
É possível orquestrar qualquer estrutura que use navegadores, exemplos:
| Nome | Link | 
|---|---|
| Selenium | Selenium | 
| Playwright | Playwright | 
| Puppeteer | Puppeteer | 
Existem mais do que esses, a maioria pode de fato ser orquestrada pela Botcity.
Criando seu primeiro projeto¶
A BotCity oferece um projeto modelo que pode ser personalizado por meio de uma ferramenta chamada js-template-cli.
Instalando js-template-cli¶
Para usá-lo, precisamos primeiro instalar o pacote JavaScript js-template-cli, executando o seguinte comando no seu terminal da linha de comando:
npm install @botcity/js-template-cli
Depois de fazer isso, você está pronto para criar sua primeira automação JavaScript usando o Framework da Botcity.
Do modelo ao projeto¶
O sistema solicitará algumas respostas para criar corretamente seu projeto.
- Uma vez solicitado é uma automação visual, responda com n e pressione enter;
- Por favor, escolha qual modelo de projeto usar, selecione JavaScript.
- Uma vez solicitado instalar o pacote, responda com sim e pressione enter;
- Em bot id digite Hello Bote pressione enter;
- Em nome do projeto digite Hello Bote pressione enter;
- Para descrição curta do projeto digite meu primeiro projeto com Botcitye pressione enter.
explorando o projeto¶
Sob a pasta do seu projeto HelloWebBot, você terá a seguinte estrutura:
HelloWebBot
├── README.md <- arquivo README simples para o seu projeto de bot.
├── bot.js <- Aqui é onde você desenvolverá seu código de bot.
└── package.json <- Arquivo descrevendo as dependências JavaScript para o seu bot.
Observação
Pode parecer muitos arquivos e pastas, mas aqui estão os mais importantes:
- bot.js: Altere este arquivo e adicione aqui o código para o seu bot.
ótimo!
Todas essas informações são ótimas, mas é hora de ver alguma ação.
Vamos testar este novo e brilhante Bot localmente.🦾🤖
Testando seu projeto localmente¶
Para testar nosso projeto localmente, vamos primeiro instalá-lo para que possamos ter todas as dependências JavaScript prontas.
Usando a ferramenta de linha de comando, acesse a pasta hellowebbot que descrevemos acima.
Instalando¶
Instale o pacote JavaScript executando o seguinte comando no seu terminal de linha de comando:
npm install
Executando o bot¶
Nosso projeto de modelo executa uma automação muito simples. Ele abre seu navegador Web padrão e carrega o site da Botcity.
Você pode executar seu HelloWebBot com o seguinte comando:
🌟 Excelente 🌟
Agora você está pronto para começar a criar automações usando o Framework JavaScript da Botcity.
Conclusão¶
Neste tutorial que você aprendeu:
- 
As dependências necessárias para desenvolver automações usando o Framework JavaScript da Botcity e como instalá-las. 
- 
Como criar novos projetos de Bot usando js-template-cli e modelo de projeto Botcity. 
- 
Como instalar e executar seu novo projeto de Bot localmente. 
Divirta-se automatizando 🤖