📱Telegram

Converse com suas sessões pelo celular. O Harness Maxxing inclui seu próprio gateway do Telegram: nenhum programa extra para instalar.

• Um bot, vinculado somente ao seu chat privado.
• Uma thread por sessão aberta - o chat do Telegram espelha a página Sessões - além de Crons (relatórios de jobs), Alerts (alertas de login) e Notifications (o feed de notificações: vendas, pedidos, seus scripts… conforme as regras que você definir, publicadas pelo próprio bot, com um botão Ask Harness). Uma thread se chama <projeto>/<tópico> · <título da sessão>, com o emoji do projeto na frente quando existir (menu … do projeto em Sessões -> Definir um emoji…), por exemplo 🛒 acme/blog · Launch plan. Mudar o emoji renomeia as threads.
• Uma thread é a própria sessão: o que você escreve no celular aparece na interface web e você pode continuar por lá, e vice-versa.
• Escreva no chat principal (ou crie uma thread) para iniciar uma nova sessão: o bot pergunta em qual tópico.

Configuração (Configurações -> Telegram)

1. No Telegram, abra o @BotFather, envie /newbot, escolha um nome e um nome de usuário terminado em bot. Copie o token que ele fornece (123456789:AA...).
2. No BotFather, abra as configurações do seu bot e ative os tópicos (threads) para chats privados, para que cada sessão aberta tenha sua própria thread. Sem isso, tudo funciona no chat principal (use /topic para escolher com qual tópico ele conversa).
3. Cole o token em Configurações -> Telegram. O servidor verifica o token.
4. Clique em Vincular, abra no celular o link t.me/<bot>?start=<code> e toque em Start. O código vale 15 minutos. A partir daí, as mensagens de qualquer outro chat são ignoradas.
5. Clique em Sincronizar threads (depois disso, é automático: veja abaixo).
6. Escolha as opções: relatórios de cron, alertas de login, login em duas etapas, modo de resposta (progresso ao vivo, o padrão = uma mensagem de status atualizada enquanto o Claude trabalha, com a lista de tarefas e cada etapa, condensada em um resumo no final; resposta final = somente a resposta). Toque em Enviar teste.

Threads = sessões abertas

Sessões espelhadas: aquelas com as quais você conversa (não as iniciadas por jobs agendados - os relatórios delas vão para Crons), não arquivadas, ativas nos últimos 30 dias (Configurações -> Telegram -> Manter uma thread por: 7, 14, 30 ou 90 dias), no máximo 50. Uma sessão mais antiga simplesmente ganha sua thread de volta quando é usada novamente. A sincronização roda alguns segundos após qualquer mudança e a cada 10 minutos; nada para agendar. Se o Telegram se recusar a excluir uma thread por um momento (muitas requisições, sem conexão), a próxima sincronização a exclui. Renomear uma sessão renomeia sua thread: o Telegram mostra uma pequena linha "tópico renomeado" na thread.

Como usar

• Escreva na thread de uma sessão: o Claude responde nessa thread. Enquanto trabalha, você vê "digitando…" e, em tarefas mais longas, a mensagem de status ao vivo.
• Envie fotos e arquivos: eles são salvos em <topic>/attachments/telegram/YYYY-MM/ e repassados ao Claude junto com sua legenda.
• Comandos:

• O sino de uma sessão (interface web, ao lado do título): com o espelhamento desativado (padrão), publica uma curta mensagem de "concluído" na thread da sessão quando um turno termina; com o espelhamento ativado, faz as respostas espelhadas tocarem.

Login em duas etapas

Configurações -> Telegram (ou Configurações -> Segurança) -> Login em duas etapas: depois da senha correta, um navegador que ainda não é confiável aguarda sua aprovação no Telegram. A thread Alerts recebe uma mensagem com o IP, o navegador, um código de 6 dígitos e dois botões:

• Allow: a página de login abre sozinha;
• Deny: o login é recusado - e, como a senha correta foi digitada, troque-a (Configurações -> Segurança).

Quando os botões não respondem, digite o código da mensagem na página de login. Uma solicitação expira após 2 minutos; 5 códigos errados a cancelam e, após 20 códigos errados em uma hora no servidor inteiro, os códigos ficam pausados pelo restante da hora (o botão Allow continua funcionando) - quem conhece a senha não consegue tentar códigos a partir de vários endereços. Uma página de login aberta novamente substitui a solicitação anterior. Confiar neste navegador por 30 dias (marcado por padrão) dispensa a segunda etapa nesse navegador; Esquecer navegadores confiáveis faz todos os outros navegadores pedirem de novo (trocar a senha também faz isso). Trocar a senha, esquecer os navegadores ou desativar o login em duas etapas também cancela todas as solicitações ainda em espera, mesmo uma que você tenha permitido por engano.

Ao ativar, é enviada uma primeira solicitação: ele só é ligado depois que você a aprova, então um bot que não responde não pode deixar você de fora. Desvincular o Telegram o desativa.

O Telegram não responde (bot excluído, Telegram fora do ar, celular perdido): no servidor, via SSH,

maxxing 2fa off             # password only again (every trusted browser is forgotten)
maxxing 2fa status          # on / off

Solução de problemas

maxxing telegram status     # bot, chat, threads, settings, last error
maxxing telegram test       # sends a test message

Para desconectar: Configurações -> Telegram -> Desvincular (esquece o token e o chat).