Por que redesenhamos o /setup: de 50 comandos a um único menu

Se você adicionou o X Bot a um grupo há algum tempo, deve se lembrar de um bot bem diferente. Havia /set_x_filtering, /set_calendar, /set_top_count, /set_colors, /set_points, /set_topic, e mais uns 45 comandos parecidos. Cada funcionalidade tinha seu próprio comando, porque isso parecia a forma natural de expor um conjunto de recursos em crescimento no Telegram. Não era.

Este post explica por que abandonamos essa estrutura e a substituímos por um único menu /setup, o que os números mostraram antes e depois, e o que mantivemos para quem gostava do jeito antigo.

O problema: 50 comandos não são uma lista de funcionalidades, são um labirinto#

O autocompletar de comandos do Telegram mostra uma lista rolável assim que você digita /. Isso funciona bem para cinco ou seis comandos. Com mais de 50, deixa de ser um menu e vira uma parede de texto que ninguém lê do início ao fim. Novos administradores — a pessoa em um grupo de Telegram de um projeto cripto que acabou de ouvir “ei, configura o bot de tracking” — digitava /setup, via uma parede de comandos desconhecidos e ou chutava errado ou desistia.

Ouvíamos isso constantemente nos tickets de suporte, antes mesmo de termos um fluxo de ❓ Ajuda e Suporte de verdade para captar isso: “como adiciono as cashtags,” “onde defino o horário,” “esse bot faz relatórios mesmo.” As respostas sempre eram um comando que eles não tinham encontrado, enterrado em uma lista que não tinham tempo de ler. O bot tinha todas as funcionalidades que as pessoas queriam. Só não dizia onde nada estava.

Comandos de barra também não se combinam bem. Se você quisesse configurar filtros, um horário e personalização, eram três (ou mais) invocações de comando separadas, cada uma exigindo que você lembrasse a sintaxe exata — /set_x_filtering @handle1 @handle2 $TOKEN, formatado exatamente certo, sem erros de digitação, sem tentativa tolerante. Um argumento malformado e você recebia um erro seco e tinha que recomeçar. Não havia um caminho guiado de “acabei de adicionar esse bot” até “tenho um relatório funcionando.”

A solução: um único ponto de entrada, tudo descobrível#

Reduzimos a superfície de comandos a um único comando /setup que abre um teclado inline — os menus de botões clicáveis que o Telegram suporta nativamente. Em vez de decorar 50 nomes de comandos, você vê 8 seções nomeadas e toca na que quiser:

• 🎯 Filters — contas, cashtags, palavras-chave, menções, exclusões, lista de ignorados, filtros nomeados
• ⏰ Schedule — predefinições diárias, horário customizado, dias específicos, ou uma expressão cron completa
• 📊 Reports — disparar um relatório sob demanda, revisar o histórico de relatórios
• 🎨 Customization — nome do projeto, descrição, logo, URLs, título e cor do leaderboard, pesos, contagem de top-N
• 👥 Admins — quem mais pode configurar o bot
• 💳 Buy Credits — pacotes de créditos ETH ou a assinatura PRO
• 📡 X Posts Auto-relay — encaminhar posts de contas selecionadas para o chat quase em tempo real
• ❓ Help & Support — abrir um ticket, receber respostas como DMs no Telegram

Cada botão leva a outro menu, não a uma sintaxe que você precisa lembrar. Configurar cashtags antes significava lembrar /set_x_filtering e acertar a ordem dos argumentos. Agora é /setup → 🎯 Filters → 💵 Cashtags → ➕ Add, e o bot pergunta o que precisa em seguida.

A experiência de primeiro uso foi o que mais mudou. Chats novos agora recebem um assistente de início rápido de 4 etapas: nome do projeto, depois filtros, depois horário, depois uma tela de confirmação — tudo em menos de um minuto, sem sintaxe de comando para errar.

O que realmente mudou: números de ativação#

Acompanhamos a porcentagem de chats novos que disparavam o primeiro relatório em até 24 horas após adicionar o bot — o sinal mais claro de “essa pessoa realmente concluiu a configuração, ou desistiu no meio do caminho.” Antes do redesenho do menu, uma grande parte das novas instalações nunca completava a configuração; administradores mexiam em alguns comandos de barra, recebiam um erro por um argumento malformado e sumiam. Depois do redesenho, a maioria dos chats novos que iniciavam o assistente de início rápido o concluía e já tinha um relatório agendado no mesmo dia. O maior ganho do assistente não foi ensinar novas funcionalidades — foi eliminar a chance de digitar algo errado.

Os tickets de suporte sobre “como configuro X” também caíram bastante depois que o menu foi lançado, dando lugar a perguntas mais específicas sobre ajustes finos (como funciona o seletor do melhor tweet, por exemplo) em vez de “onde está o botão para isso.”

O que mantivemos como comandos diretos#

Não apagamos tudo. Um punhado de comandos é usado com frequência suficiente, ou é útil como atalho rápido, para mantê-los fora do menu:

• /setup — abre o menu (o próprio ponto de entrada)
• /report — dispara um relatório imediatamente, sem navegar pelo menu
• /buy — vai direto para a compra de créditos
• /subscription — verifica ou gerencia a assinatura PRO
• /add_admin — adiciona um admin do bot sem entrar em 👥 Admins
• /set_topic — define o tópico de destino em grupos com modo fórum
• /status — verificação rápida de saúde (filtros ativos, horário, plano)
• /get_chatid — necessário ocasionalmente para tickets de suporte e depuração de API

Esses são os comandos que usuários avançados digitam por hábito, e os que scripts ou automações têm mais chance de chamar diretamente. Mantê-los significou que não quebramos o fluxo de trabalho de ninguém, ao mesmo tempo em que corrigimos a descoberta de funcionalidades para todos os demais. Os outros 40+ comandos legados ainda tecnicamente funcionam por compatibilidade retroativa, mas não estão documentados nem sugeridos em lugar nenhum — o menu é o caminho suportado agora.

Valeu o custo da migração?#

Sim, mas não foi de graça. Toda tela do menu tinha que lidar com o caso de um usuário tocar em um botão, fechar o Telegram e voltar três dias depois esperando o mesmo estado — teclados inline não retêm o contexto da conversa indefinidamente, então tivemos que tornar cada etapa reentrante em vez de assumir um fluxo linear. Também tivemos que pensar mais em permissões: um menu convida a mais cliques do que um comando que a pessoa precisava procurar e digitar, então 👥 Admins e as verificações de papel foram reforçadas ao mesmo tempo.

Se você está construindo um bot de Telegram com mais do que um punhado de opções de configuração, nossa recomendação é: não espere ter 50 comandos para tomar essa decisão. O limite em que uma lista de comandos deixa de ser útil é menor do que parece quando você é quem está adicionando funcionalidades uma de cada vez. Se seus usuários estão configurando coisas que não fazem diariamente — sintaxe de horário, combinações de filtros, filtros nomeados — um menu guiado vence um comando decorado sempre. Se é um comando que alguém vai rodar dezenas de vezes por dia, mantenha como um comando direto e rápido.

Para um olhar mais aprofundado sobre como o lado de filtragem do /setup funciona na prática, veja tracking X activity for a token launch e cashtag tracking for crypto projects — ambos percorrem o menu atual 🎯 Filters passo a passo. Para a referência completa do menu, a documentação do menu de setup cobre cada tela, e x-bot-overview é o melhor ponto de partida se você é novo no bot.

Pronto para acompanhar sua comunidade no X? Adicione @BWS_X_Bot ao seu grupo do Telegram, rode /setup, e seu primeiro relatório dispara no horário configurado. O plano FREE cobre 100 posts/mês — sem necessidade de cartão.

Sobre este artigo: este post foi redigido com assistência de IA usando o fluxo de conteúdo do X Bot e revisado por Nacho Coll, Fundador e Principal na Blockchain Web Services (BWS), antes da publicação. Toda afirmação sobre o produto é verificada no bot em produção. Leia como usamos IA no nosso conteúdo. Encontrou um erro? Fale conosco via /setup → ❓ Help & Support.

“Esta é uma de muitas atualizações de produto que cobrimos — veja o blog do X Bot para notas de release, estudos de caso e análises aprofundadas.”