Aula 4 · 20 min
O inemaccbot é um gateway do Telegram com fila durável: você manda o pedido pelo celular e o seu computador (ou uma VPS) executa como agente. Nesta aula você instala, pareia o bot com o seu chat e deixa rodando como serviço.
Começar a aula
Objetivo: instalar o inemaccbot, parear com o seu chat e ver o /ping responder no Telegram.
Do celular ao resultado.
Clique em cada bloco. Para instalar e usar, você não precisa mexer no código: só no .env e no Telegram.
Testado no Ubuntu com Node 24. O atalho ./scripts/instalar.sh faz a parte mecânica e para no que exige você.
Node 22 ou mais novo (node -v; o Ubuntu 24.04 traz o 18). claude instalado e logado: confira com claude auth status; instalado não é o mesmo que autenticado. ffmpeg e python3 para as tarefas de áudio e vídeo.
Sem o claude logado o bot sobe e aceita comandos, mas todo trabalho de agente falha. É a falha mais confusa, porque tudo parece certo.
Clone o repositório e rode npm ci (não npm install: o ci segue o lockfile e a instalação fica igual em toda máquina).
Clone também os repos de domínio promoavatar e promoavatar3 como pastas irmãs. Sem eles o bot sobe, mas os fluxos quebram na primeira fase e dezenas de testes falham.
Fale com o @BotFather, mande /newbot e guarde o token que ele devolve. Esse valor é o BOT_TOKEN.
O token é um segredo: nunca vai para o Git, para print ou para mensagem.
Copie o .env.example, proteja com chmod 600 e preencha BOT_TOKEN, QUEUE_DB, STATE_DIR e LOG_FILE.
Em ALLOWED_CHAT_IDS, deixe 0. É o modo pareamento: o primeiro /ping cadastra o seu chat como dono e fecha a porta. Vazio não é pareamento: é erro de propósito, o bot não sobe.
Enquanto a allowlist for 0, quem mandar /ping primeiro leva o bot. Pareie antes de deixar rodando.
Rode npm test e npm run build, depois suba na mão com ./start.sh para ver qualquer erro na tela.
Mande /ping para o seu bot. Ele responde com o id do chat e grava esse id no .env. A partir daí, só você é atendido.
Para o bot sobreviver ao logout e subir sozinho no boot, instale o serviço de usuário e ligue o linger. Numa VPS, use o serviço de sistema (deploy/inemaccbot-sistema.service).
Nunca rode o ./start.sh e o serviço ao mesmo tempo com o mesmo token: os dois disputam as mensagens e cada um perde metade. O start.sh já recusa subir quando o serviço está ativo.
Na ordem. Troque só o que estiver indicado.
cd ~/projetos git clone https://github.com/inematds/inemaccbot.git git clone https://github.com/inematds/promoavatar.git git clone https://github.com/inematds/promoavatar3.git cd inemaccbot ./scripts/instalar.sh --checar # só diz o que falta, não muda nada npm ci npm test npm run build
cp .env.example .env chmod 600 .env # edite o .env: BOT_TOKEN=<do BotFather> ALLOWED_CHAT_IDS=0 ./start.sh # log na tela; Ctrl+C encerra drenando o que estiver rodando # no Telegram: /ping → o bot responde e grava o seu chat id
mkdir -p ~/.config/systemd/user cp deploy/inemaccbot.service ~/.config/systemd/user/ systemctl --user daemon-reload systemctl --user enable --now inemaccbot loginctl enable-linger "$USER" systemctl --user status inemaccbot # espere: active (running)
No log aparece a linha de recuperação, mesmo numa fila vazia:
boot: recuperação de leases — requeued=0 failed=0
Erro de configuração derruba o processo nesse ponto, de propósito. Leia a mensagem antes de mexer em outra coisa.
config: falta BOT_TOKEN: o .env não tem o token./ping não responde: allowlist com o id errado (o log mostra rejeitada — fora da allowlist).claude não está logado.tsc: not found no build: refaça com NODE_ENV=development npm ci --include=dev.O .env do bot guarda configuração: token, allowlist, caminhos. Chaves de outros serviços moram num cofre separado, um arquivo por máquina com chmod 600, nunca versionado. Regra do projeto: o .env guarda caminho e id; segredo de terceiro mora no arquivo do dono dele.
Reserve uma hora sem interrupção.
Siga os passos até o bot responder no Telegram. Pareie com ALLOWED_CHAT_IDS=0 e confira que o .env tem chmod 600. Depois teste /ajuda e /fila.
Pronto quando: /ping responde no seu Telegram e /fila mostra as filas vazias.
Passo a passo completo, com VPS e usuário dedicado: README do inemaccbot.
A explicação aparece depois da sua resposta.
Pergunta 1 de 3
O serviço está active (running), mas o bot não responde ao seu /ping. Qual é a causa mais provável?
Pergunta 2 de 3
Para que serve deixar ALLOWED_CHAT_IDS=0 na primeira subida?competência
Pergunta 3 de 3
Onde deve ficar a chave de um serviço de terceiros que uma tarefa usa?
Escolha uma alternativa. A explicação aparece depois da sua tentativa.