Introdução

Para desenvolver e hospedar um bot do Telegram na Square Cloud, é necessário seguir alguns pré-requisitos essenciais. Este guia apresentará o processo completo, desde a configuração inicial até o deploy final.

Pré-requisitos

  • Conta ativa no Telegram: Essencial para testar e interagir com seu bot. Caso não possua, acesse o site oficial do Telegram para criar sua conta gratuitamente.
  • Conta na Square Cloud: Necessária para hospedar sua aplicação. Registre-se através da página de cadastro em poucos minutos.
  • Plano pago ativo: Garante recursos dedicados e performance otimizada para seu bot. Consulte nossos planos disponíveis e escolha o mais adequado às suas necessidades.

Configuração Inicial do Bot

Iniciando o Processo

Acesse o Telegram Web e procure pelo bot oficial BotFather, responsável pela criação e gerenciamento de bots na plataforma.

Obtenção do Token de Autenticação

Inicie uma conversa com o BotFather e digite /start. Em seguida, selecione a opção /newbot para criar um novo bot. O sistema solicitará um nome para seu bot e, após a confirmação, gerará automaticamente o token de autenticação necessário.
Segurança Crítica: Mantenha o token do seu bot em absoluto sigilo. Este token concede controle total sobre o bot e deve ser tratado como informação confidencial.

Desenvolvimento do Bot

A escolha da biblioteca ou framework depende da linguagem de programação que você pretende utilizar. Abaixo estão algumas das opções mais populares:

Bibliotecas e Frameworks Recomendados

Configuração do Ambiente
  1. Verifique se o Node.js está instalado em seu sistema. Caso contrário, faça o download no site oficial do Node.js.
  2. Inicialize um novo projeto Node.js:
Terminal
npm init -y
  1. Instale a biblioteca oficial:
Terminal
npm install node-telegram-bot-api
Implementação Básica
  1. Crie o arquivo principal (index.js) com a seguinte estrutura:
index.js
// Importação da biblioteca node-telegram-bot-api
const TelegramBot = require("node-telegram-bot-api");

// Configuração do token de autenticação
const token = "SEU_TOKEN_AQUI";

// Inicialização do bot com polling habilitado
const bot = new TelegramBot(token, { polling: true });

// Obtenção das informações do bot
bot.getMe().then((botInfo) => {
  // Extração do nome do bot
  const botName = botInfo.username;

  // Definição do handler para mensagens não-comando
  bot.on("message", (msg) => {
    // Extração do ID do chat
    const chatId = msg.chat.id;
    // Captura da mensagem do usuário
    const userMsg = msg.text;
    // Formatação da resposta
    const responseMsg = `${botName} responde: ${userMsg}`;
    // Envio da mensagem de resposta
    bot.sendMessage(chatId, responseMsg);
  });

  // Log de confirmação da inicialização
  console.log(`Bot ${botName} iniciado com sucesso!`);
});

Configuração do Arquivo Square Cloud

Documentação Completa: Arquivo de Configuração Square Cloud

O arquivo squarecloud.app é o componente central de configuração da sua aplicação, definindo parâmetros essenciais como arquivo principal, recursos de sistema, versões e metadados do projeto.

Configuração Avançada do Campo START

Atenção: Utilize o campo START apenas se possuir conhecimento técnico avançado sobre scripts de inicialização personalizados.
O campo START no arquivo de configuração da Square Cloud é opcional e deve ser usado exclusivamente quando necessário executar scripts customizados de inicialização. Para os exemplos apresentados neste tutorial, este campo não é necessário.

Deploy na Square Cloud

Após a preparação completa dos arquivos do projeto, proceda com o upload para a Square Cloud seguindo uma das metodologias abaixo:
Acesse o Dashboard da Square Cloud e faça o upload dos arquivos do seu projeto.

Testes e Validação

Após o deploy bem-sucedido, localize seu bot no Telegram e envie uma mensagem de teste. O bot deve responder ecoando sua mensagem, confirmando o funcionamento correto da implementação.

Recursos Adicionais

Para aprofundar seus conhecimentos sobre desenvolvimento de bots Telegram, consulte a documentação oficial do telebot. A documentação oferece guias detalhados, tutoriais avançados e referência completa da API. 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.