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:

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:

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 Bot e pressione enter;
• Em nome do projeto digite Hello Bot e pressione enter;
• Para descrição curta do projeto digite meu primeiro projeto com Botcity e 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.

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:

node bot.js

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 🤖