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: Plataforma de hospedagem para seu aplicativo. 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

Finally, click on the "Deploy" button to host your project on Square Cloud.
After deployment, you can monitor your project's status and logs from the dashboard.

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