Pular para o conteúdo principal

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.
Se sua implementação precisar acessar o caminho remoto para a versão do WhatsApp Web, siga este procedimento técnico:
  1. Acesse o repositório wa-version
  2. Selecione a versão desejada (sempre é recomendado usar a mais recente)
  3. Clique em “Raw” para visualizar o arquivo
  4. Copie a URL gerada para uso posterior
Exemplo de URL configurada:

Desenvolvendo o projeto

  1. 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.
  2. Inicialização do projeto: Configure um novo projeto Node.js executando o comando de inicialização:
Terminal
  1. Instalação de dependências: Instale as bibliotecas essenciais para a funcionalidade do bot:
Terminal
  1. Criação do arquivo principal: Desenvolva o arquivo index.js com 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.
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.
Enviando aplicação para a Square Cloud
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 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.
Seu app não está iniciando? Veja o guia de solução de problemas para as causas e correções mais comuns.

Via CLI

Para usar esse método, você precisa criar um arquivo de configuração chamado squarecloud.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:
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.
Seu app não está iniciando? Veja o guia de solução de problemas para as causas e correções mais comuns.

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 mensagem WhatsApp 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 arquivo creds.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.
  1. Instale a biblioteca:
Terminal
  1. Crie um arquivo index.js usando makeWASocket e useMultiFileAuthState para carregar e persistir a sessão:
index.js
Como o Baileys não precisa de um navegador, seu arquivo de configuração na Square Cloud pode usar um valor de MEMORY menor do que o exemplo com whatsapp-web.js acima:
squarecloud.config

Recursos Adicionais

Para aprofundar seus conhecimentos sobre o desenvolvimento de bots do WhatsApp usando o whatsapp-web.js, consulte a documentação oficial da biblioteca whatsapp-web.js. A documentação oferece guias técnicos detalhados, tutoriais avançados e referência completa da API para maximizar o potencial de implementação.

Contate-nos

Se você continuar enfrentando dificuldades técnicas, nossa equipe de suporte especializada está disponível para auxiliá-lo. Entre em contato conosco e teremos prazer em ajudá-lo a resolver qualquer questão — a qualidade do suporte é uma grande parte do motivo pelo qual desenvolvedores avaliam a Square Cloud com 4.9/5 em 402 avaliações no Google e Trustpilot.