Introdução
Para desenvolver e hospedar um aplicativo no Square Cloud, é essencial seguir uma sequência estruturada de configurações e pré-requisitos. Este guia técnico abordará todo o processo, desde a configuração inicial até a implantação em produção.Pré-requisitos
- Conta Square Cloud: Cadastre-se através da página de cadastro usando seu e-mail.
- Plano Pago Ativo: Garante recursos dedicados e desempenho otimizado para seu aplicativo. Confira nossos planos disponíveis e escolha o mais adequado às suas necessidades.
Criando o projeto
Ter o WhatsApp instalado e configurado é um requisito para a autenticação e vinculação do bot. Se você não tem o aplicativo, visite o site oficial do WhatsApp para download e configuração.Configuração de Caminho Remoto para WhatsApp Web
Configuração de Caminho Remoto para WhatsApp Web
Se sua implementação precisar acessar o caminho remoto para a versão do WhatsApp Web, siga este procedimento técnico:
- Acesse o repositório wa-version
- Selecione a versão desejada (sempre é recomendado usar a mais recente)
- Clique em “Raw” para visualizar o arquivo
- Copie a URL gerada para uso posterior
Desenvolvendo o projeto
- Verificação do Node.js: Confirme se o Node.js está instalado em seu sistema. Caso contrário, baixe-o no site oficial do Node.js.
- Inicialização do projeto: Configure um novo projeto Node.js executando o comando de inicialização:
Terminal
- Instalação de dependências: Instale as bibliotecas essenciais para a funcionalidade do bot:
Terminal
- Criação do arquivo principal: Desenvolva o arquivo
index.jscom a estrutura base do bot:
index.js
Realizando o Deploy
Após preparar os arquivos do seu projeto, você pode enviá-los para a Square Cloud e hospedar seu projeto. Para fazer isso, crie um arquivo ZIP contendo todos os arquivos do seu projeto.Via dashboard
1
Acesse a página de upload
Acesse a página de upload e envie seu arquivo zip.
2
Configure seu ambiente
Após fazer o upload do seu arquivo zip, você precisará configurar o nome, o arquivo principal ou o ambiente de execução e outras configurações do seu projeto.
Se você estiver enviando um projeto web, certifique-se de selecionar “Publicação na Web” e definir um subdomínio para o seu projeto.
Se você estiver enviando um projeto web, certifique-se de selecionar “Publicação na Web” e definir um subdomínio para o seu projeto.
3
Faça o deploy do projeto
Por fim, clique no botão “Deploy” para hospedar seu projeto no Square Cloud.
Após o deploy, você poderá monitorar o status e os registros do seu projeto no painel.

4
Confirme que seu app está no ar
Seu primeiro deploy geralmente leva menos de um minuto. No dashboard, aguarde o status da sua aplicação mudar para em execução e verifique os registros em busca de erros de inicialização.
Se você fez deploy de um site ou API, abra
Se você fez deploy de um site ou API, abra
https://<seu-subdominio>.squareweb.app no navegador — você deve ver sua aplicação respondendo. Se você fez deploy de um bot, envie um comando para confirmar que ele está online.
Via CLI
Para usar esse método, você precisa criar um arquivo de configuração chamadosquarecloud.app no diretório raiz do seu projeto. Esse arquivo conterá a configuração necessária para o seu projeto.
Guia do arquivo de configuração
Saiba como criar o arquivo de configuração
squarecloud.app que define o ambiente da sua aplicação.1
Primeiro Passo
Primeiro, você precisa ter a CLI instalada em seu ambiente. Se você ainda não a possui, execute o seguinte comando em seu terminal:Se você já a possui, recomendamos atualizá-la. Para fazer isso, execute o seguinte comando em seu terminal:
- Windows
- Linux, macOS, e WSL
2
Segundo Passo
Agora, para autenticar e usar outros comandos da CLI, você encontrará sua chave de autorização aqui clicando em “Solicitar Chave da API”. Após obter sua chave de autorização, execute o seguinte comando:
3
Terceiro Passo
Finalmente, para fazer o deploy da sua aplicação para a Square Cloud usando a CLI, você precisa executar o seguinte comando:Ou se já possui o zip criado:
4
Confirme que seu app está no ar
Seu primeiro deploy geralmente leva menos de um minuto. Verifique o status e os registros da sua aplicação diretamente pelo terminal:Se você fez deploy de um site ou API, abra
https://<seu-subdominio>.squareweb.app no navegador — você deve ver sua aplicação respondendo. Se você fez deploy de um bot, envie um comando para confirmar que ele está online.
Testando o Bot
Verifique os registros da aplicação no dashboard da Square Cloud: no primeiro boot você verá o registro de geração do QR Code, e assim que você escaneá-lo com o WhatsApp no seu celular, a mensagemWhatsApp client successfully initialized! confirma que a sessão está ativa. Em seguida, envie !ping de outro número para a conta do WhatsApp vinculada e confirme que ele responde com pong - Bot working correctly!.
Usando o Baileys em vez do whatsapp-web.js
O Baileys é uma biblioteca alternativa que se conecta diretamente à API multi-dispositivo do WhatsApp via WebSocket, sem iniciar um navegador headless. Como não há uma instância do Chromium/Puppeteer para rodar, ele usa significativamente menos RAM do que o whatsapp-web.js. Como o Baileys não tem uma sessão de navegador para recorrer, ele precisa persistir seu próprio estado de autenticação (o arquivocreds.json e as chaves dentro da pasta de autenticação) entre reinícios, ou a sessão do dispositivo vinculado é perdida a cada redeploy e você precisará escanear o QR Code novamente. Recomendamos versionar essa pasta de autenticação em um armazenamento persistente, como o Blob Storage da Square Cloud, para que a sessão sobreviva a redeploys.
- Instale a biblioteca:
Terminal
- Crie um arquivo
index.jsusandomakeWASocketeuseMultiFileAuthStatepara carregar e persistir a sessão:
index.js
MEMORY menor do que o exemplo com whatsapp-web.js acima:
squarecloud.config

