Como hospedar um bot do Telegram 24/7

​

Introdução

​

Pré-requisitos

• Conta Square Cloud: Cadastre-se através da página de cadastro usando seu e-mail.
• Plano ativo: Garante recursos dedicados e desempenho otimizado para seu aplicativo. Confira nossos planos disponíveis e escolha o mais adequado às suas necessidades.

​

Crie o projeto

​

Aplicação de bot no Telegram

Encontre o BotFather

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

Obtenha o token

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.

​

Desenvolva o bot

npm init -y

npm install grammy

const { Bot } = require("grammy");

// O token vem da variável de ambiente TELEGRAM_BOT_TOKEN
const bot = new Bot(process.env.TELEGRAM_BOT_TOKEN);

// Responde a cada mensagem de texto com um eco
bot.on("message:text", async (ctx) => {
  await ctx.reply(`${ctx.me.username} responde: ${ctx.message.text}`);
});

// Long polling: o bot pede novas mensagens ao Telegram, então nenhuma URL pública é necessária
bot.start({
  onStart: (botInfo) => console.log(`Bot ${botInfo.username} iniciado com sucesso!`),
});

pip install pyTelegramBotAPI

import os

import telebot

# O token vem da variável de ambiente TELEGRAM_BOT_TOKEN
bot = telebot.TeleBot(os.environ["TELEGRAM_BOT_TOKEN"])
bot_name = bot.get_me().username


# Ecoa toda mensagem que não é um comando
@bot.message_handler(func=lambda message: not message.text.startswith("/"))
def echo_handler(message):
    bot.reply_to(message, f"{bot_name} responde: {message.text}")


if __name__ == "__main__":
    print(f"Bot {bot_name} iniciado com sucesso!")
    # Long polling: nenhuma URL pública é necessária
    bot.infinity_polling()

pyTelegramBotAPI

​

Configure a Square Cloud

DISPLAY_NAME=My Telegram Bot
MAIN=index.js
MEMORY=512
VERSION=recommended
AUTORESTART=true

DISPLAY_NAME=My Telegram Bot
MAIN=main.py
MEMORY=512
VERSION=recommended
AUTORESTART=true

• MAIN é o arquivo que a Square Cloud executa, e MEMORY é a RAM do bot em MB. Bots precisam de pelo menos 256 MB; 512 MB deixa espaço para crescer.
• AUTORESTART=true inicia o bot de novo se ele travar. Veja como funciona o auto restart.
• Não há SUBDOMAIN: com long polling, o bot não precisa de URL pública.

​

Defina o token do bot

• Dashboard: na página de upload, abra Configuração avançada e adicione uma variável chamada TELEGRAM_BOT_TOKEN com o seu token como valor. Para um bot que já está no ar, adicione-a na página Variáveis de ambiente da aplicação e reinicie o bot.
• CLI: logo depois de enviar o bot (veja Faça o deploy e verifique), defina-a com squarecloud app env set e reinicie o bot:

squarecloud app env set TELEGRAM_BOT_TOKEN=your_token_here
squarecloud app restart

​

O que vai no ZIP

• O seu arquivo principal (index.js ou main.py) e os seus outros arquivos de código.
• package.json ou requirements.txt.
• squarecloud.app.

​

Faça o deploy e verifique

​

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 na Square Cloud. Após o deploy, você poderá monitorar o status e os registros do seu projeto no dashboard.

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

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

npm install -g @squarecloud/cli@latest

squarecloud auth login

squarecloud upload

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

squarecloud app status
squarecloud app logs

​

Teste o bot

​

Erros comuns

​

Error 409: Conflict: terminated by other getUpdates request

​

Error 401: Unauthorized

​

Token vazio ou KeyError: 'TELEGRAM_BOT_TOKEN'

​

Próximos passos

​

Contate-nos