Como Hospedar Bots do Telegram

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.

Está se perguntando quanta RAM e CPU seu plano precisa para hospedar Bots do Telegram?
Não se preocupe, estamos aqui para ajudar. Nosso plano Hobby oferece 2GB de RAM e 2vCPU, o que deve ser suficiente para a maioria dos Bots do Telegram. No entanto, se você estiver trabalhando em um projeto maior e precisar de mais estabilidade, recomendamos considerar nosso plano Pro. Com recursos adicionais, você pode manter a estabilidade mesmo durante picos de demanda. Para comprar, basta clicar aqui.

Criando o projeto

Uma conta no Telegram é essencial para testar e interagir com seu bot. Se você não tem uma, visite o site oficial do Telegram para criar sua conta gratuitamente.

Aplicação de Bot no Telegram

Primeiros Passos

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

Obtendo o 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 pedirá um nome para o 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 sigilo absoluto. Este token concede controle total sobre o bot e deve ser tratado como informação confidencial.

Desenvolvendo o projeto

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

Node.js - node-telegram-bot-api
Python - telebot

Configuração do Ambiente

Verifique se o Node.js está instalado em seu sistema. Caso contrário, baixe-o no site oficial do Node.js.
Inicialize um novo projeto Node.js:

Terminal

npm init -y

Instale a biblioteca oficial:

Terminal

npm install node-telegram-bot-api

Implementação Básica

Crie o arquivo principal (index.js) com a seguinte estrutura:

index.js

// Importa a 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 ativado
const bot = new TelegramBot(token, { polling: true });

// Obtém informações do bot
bot.getMe().then((botInfo) => {
  // Extrai o nome de usuário do bot
  const botName = botInfo.username;

  // Define o manipulador para mensagens que não são comandos
  bot.on("message", (msg) => {
    // Extrai o ID do chat
    const chatId = msg.chat.id;
    // Captura a mensagem do usuário
    const userMsg = msg.text;
    // Formata a resposta
    const responseMsg = `${botName} responde: ${userMsg}`;
    // Envia a mensagem de resposta
    bot.sendMessage(chatId, responseMsg);
  });

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

Configuração do Ambiente

Verifique se o Python e o pip estão instalados. Caso contrário, baixe-os no site oficial do Python.
Instale a biblioteca telebot:

Terminal

pip install telebot

Implementação Básica

Crie o arquivo principal (main.py):

main.py

# Importa a biblioteca telebot_router
from telebot_router import TeleBot

# Inicialização da aplicação
app = TeleBot(__name__)

# Define rota para mensagens que não são comandos
@app.route('(?!/).+')
def echo_handler(message):
    # Extrai o ID do chat de destino
    chat_dest = message['chat']['id']
    # Captura a mensagem do usuário
    user_msg = message['text']
    # Obtém informações do bot
    bot_info = app.get_me()['result']
    # Extrai o nome de usuário do bot
    bot_name = bot_info['username']
    # Formata a mensagem de resposta
    response_msg = f"{bot_name} responde: {user_msg}"
    # Envia a mensagem
    app.send_message(chat_dest, response_msg)
    
# Função principal de execução
if __name__ == '__main__':
    # Configuração da chave da API
    app.config['api_key'] = 'SEU_TOKEN_AQUI'
    # Obtém informações do bot
    bot_info = app.get_me()['result']
    # Extrai o nome de usuário do bot
    bot_name = bot_info['username']
    # Log de confirmação
    print(f"Bot {bot_name} iniciado com sucesso!")
    # Inicia o polling
    app.poll(debug=True)

Crie o arquivo requirements.txt para gerenciar as dependências:

requirements.txt

telebot

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

Acesse a página de upload

Acesse a página de upload e envie seu arquivo zip.

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.

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.

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.

Saiba mais sobre: Como criar arquivo de configuração da Square Cloud.

O arquivo squarecloud.app é um arquivo de configuração que será usado para configurar seu aplicativo; ele será usado para definir seu ambiente.

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:

npm install -g @squarecloud/cli

Se você já a possui, recomendamos atualizá-la. Para fazer isso, execute o seguinte comando em seu terminal:

Windows
Linux, macOS, e WSL

squarecloud update

curl -fsSL https://cli.squarecloud.app/install | bash

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:

squarecloud auth login

Terceiro Passo

Finalmente, para fazer o deploy da sua aplicação para a Square Cloud usando a CLI, você precisa executar o seguinte comando:

squarecloud upload

Ou se já possui o zip criado:

squarecloud upload --file <caminho/para/zip>

Testando o Bot

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 a correta funcionalidade da implementação.

Recursos Adicionais

Para aprofundar seu conhecimento sobre o desenvolvimento de bots do Telegram, consulte a documentação oficial do telebot. A documentação oferece guias detalhados, tutoriais avançados e referência completa da API.

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.

Square Cloud

Tutoriais

Bots

Projetos Prontos

APIs

Website

Como Hospedar Bots do Telegram

Introdução

Pré-requisitos

Criando o projeto

Aplicação de Bot no Telegram

Desenvolvendo o projeto

Realizando o Deploy

Via dashboard

Via CLI

Saiba mais sobre: Como criar arquivo de configuração da Square Cloud.

Testando o Bot

Recursos Adicionais

Contate-nos

Square Cloud

Tutoriais

Bots

Projetos Prontos

APIs

Website

​Introdução

​Pré-requisitos

​Criando o projeto

​Aplicação de Bot no Telegram

​Desenvolvendo o projeto

​Realizando o Deploy

​Via dashboard

​Via CLI

Saiba mais sobre: Como criar arquivo de configuração da Square Cloud.

​Testando o Bot

​Recursos Adicionais

​Contate-nos

Introdução

Pré-requisitos

Criando o projeto

Aplicação de Bot no Telegram

Desenvolvendo o projeto

Realizando o Deploy

Via dashboard

Via CLI

Testando o Bot

Recursos Adicionais

Contate-nos