Introdução
Para desenvolver e hospedar um bot do X (Twitter) na Square Cloud, é fundamental seguir uma sequência específica de configurações e pré-requisitos. Este guia técnico abordará todo o processo, desde a configuração inicial até o deploy em produção.Pré-requisitos Essenciais
- Conta do X (Twitter) ativa: Necessária para autenticação e operação do bot. Caso não possua uma conta, registre-se através do site oficial do X.
- Conta de Desenvolvedor do X: Essencial para acesso às APIs. Solicite acesso através do Portal de Desenvolvedores do X.
- Conta ativa na Square Cloud: Plataforma de hospedagem para sua aplicação. Registre-se através da página de cadastro utilizando seu email.
- Plano pago ativo: Garante recursos dedicados e performance otimizada. Consulte nossos planos disponíveis e escolha o mais adequado para suas necessidades.
1
Acesso ao Portal de Desenvolvedores
- Acesse o Portal de Desenvolvedores do X.
- Faça login com sua conta do X (Twitter).
- Se for seu primeiro acesso, complete o processo de solicitação de acesso de desenvolvedor.
2
Criação do Projeto
- No dashboard, clique em “Create Project”.
- Escolha um nome para seu projeto (ex: “Bot Square Cloud”).
- Selecione o caso de uso mais apropriado (ex: “Making a bot”).
- Forneça uma descrição detalhada do seu bot.
- Confirme a criação do projeto.
3
Configuração da Aplicação
- Dentro do projeto criado, clique em “Create App”.
- Defina um nome único para sua aplicação.
- Confirme a criação da aplicação.
- Anote o App ID gerado para referência futura.
4
Geração das Chaves da API
- Navegue até a seção “Keys and tokens” da sua aplicação.
- Na seção “Consumer Keys”, clique em “Regenerate” para gerar:
- API Key (Consumer Key)
- API Secret Key (Consumer Secret)
- Importante: Copie e salve essas chaves imediatamente, pois não será possível visualizá-las novamente.
5
Configuração das Permissões
- Vá para a seção “App permissions”.
- Clique em “Edit” para modificar as permissões.
- Selecione “Read and write” para permitir que seu bot poste tweets.
- Se necessário, selecione “Read and write and Direct message” para funcionalidades de DM.
- Salve as alterações.
6
Geração dos Tokens de Acesso
- Retorne à seção “Keys and tokens”.
- Na seção “Access Token and Secret”, clique em “Generate”.
- Confirme a geração dos tokens.
- Copie e salve:
- Access Token
- Access Token Secret
- Atenção: Estes tokens não poderão ser visualizados novamente após o fechamento da página.
7
Verificação das Credenciais
- Confirme que você possui todas as 4 credenciais necessárias:
- API Key (Consumer Key)
- API Secret Key (Consumer Secret)
- Access Token
- Access Token Secret
- Armazene essas credenciais em local seguro
- Importante: Nunca compartilhe ou exponha essas credenciais publicamente
Configuração do Ambiente de Desenvolvimento
Instalação e Configuração do Node.js
- Verificação do Node.js: Confirme se o Node.js está instalado em seu sistema. Caso contrário, faça o download através do site oficial do Node.js.
- Inicialização do projeto: Configure um novo projeto Node.js executando o comando de inicialização:
Terminal
- Instalação das dependências: Instale as bibliotecas essenciais para o funcionamento do bot:
Terminal
Implementação do Bot do X (Twitter)
- Configuração das variáveis de ambiente: Crie o arquivo
.env
para armazenar suas credenciais de forma segura:
.env
- Criação do arquivo principal: Desenvolva o arquivo
index.js
com a estrutura base do bot:
index.js
Configuração do Arquivo Square Cloud
Documentação Técnica: Arquivo de Configuração Square Cloud
O arquivo
squarecloud.app
constitui o núcleo de configuração da aplicação, definindo parâmetros críticos como arquivo principal, alocação de recursos, versões de runtime e metadados essenciais do projeto.Exemplo de Configuração
Crie o arquivosquarecloud.app
na raiz do seu projeto:
squarecloud.app
Configuração Avançada do Campo START
Atenção Técnica: Utilize o campo START exclusivamente se possuir conhecimento especializado sobre scripts de inicialização customizados e suas implicações.
Configuração de Variáveis de Ambiente na Square Cloud
Segurança: Nunca inclua suas credenciais da API diretamente no código. Use sempre variáveis de ambiente na Square Cloud.
API_KEY
: Sua chave da API do XAPI_SECRET_KEY
: Sua chave secreta da API do XACCESS_TOKEN
: Seu token de acessoACCESS_TOKEN_SECRET
: Seu token secreto de acesso
Deploy e Hospedagem na Square Cloud
Após a finalização da preparação dos arquivos do projeto, proceda com o processo de upload seguindo uma das metodologias técnicas disponíveis:Acesse o Dashboard da Square Cloud e realize o upload dos arquivos do seu projeto através da interface web.
