Instalação
Configure o X Bot no seu grupo do Telegram em três passos. A maioria dos times conclui a instalação em menos de três minutos; o assistente faz o trabalho pesado.
Caminho mais rápido —
@BWS_X_Bot→ adicionar ao grupo →/setup→ 🚀 Início Rápido. As quatro perguntas seguintes são tudo que você precisa.
Reúna Estes 5 Itens Antes de Começar
Antes de começar, tenha isto em mãos:
Para um tour tela a tela de cada opção que você vai configurar abaixo, veja O menu /setup.
| Você precisa de | De onde vem |
|---|---|
| Uma conta no Telegram | telegram.org |
| Direitos de admin em um grupo do Telegram | Crie um se ainda não tiver: Telegram → Novo Grupo |
| O(s) handle(s), cashtag(s) ou palavra(s)-chave do X que deseja rastrear | Ex.: @seu_usuario, $SEU_TOKEN, "#SuaCampanha" |
| (Opcional) Logo do projeto + lista de URLs | Para o showcase público do xbot.ninja |
| (Opcional) Preferência de fuso horário | O cronograma é em UTC; escolha um horário UTC que caia no momento em que sua comunidade está mais ativa |
Não tem certeza de qual plano vai precisar? Confira Preços — a maioria dos times começa no plano FREE (100 posts/mês) e faz upgrade depois.
Se não tem certeza de qual cenário se aplica a você, dê uma olhada nos 4 casos de uso na Visão Geral — escolha o mais próximo e use a recomendação de filtro dele no passo 2 abaixo.
Passo 1 — Adicione o bot ao seu grupo
- Abra o Telegram e procure por @BWS_X_Bot.
- Adicione o bot ao seu grupo.
- Promova-o a admin. Nenhuma permissão especial é necessária além do admin padrão (o bot precisa de status de admin apenas para que o Telegram permita a ele ler mensagens do grupo e postar relatórios).
Grupo, não DM
Os recursos de analytics do bot só funcionam em grupos, não em DMs privadas. Se você iniciar uma DM com @BWS_X_Bot, verá que /help e /buy funcionam, mas a maior parte do menu de configuração não.
Passo 2 — Execute /setup
No seu grupo, digite:
/setupO bot responde com um menu interativo. Toque em 🚀 Início Rápido para abrir o assistente de quatro passos.
O assistente faz quatro perguntas em ordem:
| Passo | Pergunta | Exemplos |
|---|---|---|
| 1 | Nome do projeto | MyToken, KOL Campaign Q2, @seu_usuario Performance |
| 2 | O que rastrear no X | 📢 Contas + handles, 💵 Cashtags + tickers, ou 🔍 Palavras-chave + frases |
| 3 | Quando o bot deve rodar | Escolha um horário predefinido diário (09:00 / 14:00 / 18:00 / 22:00 UTC) ou envie um horário personalizado |
| 4 | Concluído | Resumo do que foi salvo |
Pular e Sair estão sempre disponíveis — um assistente parcialmente concluído nunca te bloqueia, as configurações simplesmente permanecem nos valores padrão.
Por que
/setup? Ele encapsula todo comando de admin em uma interface clicável, editável no local, para você não precisar decorar comandos. As configurações salvam instantaneamente. Usuários avançados ainda podem digitar comandos de barra diretamente — as duas superfícies são equivalentes e o comportamento é idêntico. Tour completo: O menu /setup.
Passo 3 — Verifique
Quando o assistente terminar, abra /setup → 📊 Relatórios → ⚡ Gerar relatório agora para disparar um relatório imediato (o próximo relatório agendado rodará no horário que você escolheu no passo 2).
O bot posta a imagem do leaderboard no grupo em ~1–3 minutos. Chats menores (poucas contas, baixo volume de posts) terminam mais rápido; chats de comunidade com centenas de posts para buscar podem levar de 2 a 3 minutos.
Aguarde a primeira execução agendada
Após o Gerar relatório agora manual, a próxima execução automática acontece no horário de cron configurado. Você recebe um relatório por disparo — sem postagem duplicada.
Custo & créditos
O X Bot usa a API oficial do X para toda a busca de dados. Cada chat começa no FREE; a partir daí você pode combinar um ou ambos os caminhos pagos:
| Plano | O que você paga | O que cobre |
|---|---|---|
| FREE | $0 | 100 posts/mês com um limite rígido. O bot pausa as buscas em 100; reinicia no dia 1º do mês seguinte. |
| Assinatura PRO (Stripe) | $19/mês + $0,02/post acima de 1.000/mês (medido pelo Stripe) | Renovação automática. Os primeiros 1.000 posts/mês estão incluídos como um limite gratuito (não é um saldo de créditos — não há acúmulo). |
| Créditos PRO (ETH) | $0,02/crédito, pacotes de 1.000 / 2.000 / 3.000 / 4.000 / 5.000 / 10.000 / 50.000 / 100.000 | Compra única. Créditos nunca expiram. Complementa um saldo existente. |
Um chat pode ter tanto PRO·assinatura quanto PRO·créditos ao mesmo tempo — o faturamento por busca consome primeiro os créditos em ETH, depois a concessão mensal da assinatura, depois o excedente medido. Veja preços para a matriz completa de transição de planos e o fluxo de compra.
Plano + saldo sempre visíveis em /setup → 💳 Comprar Créditos. Admins designados recebem uma DM no Telegram quando os créditos atingem 80% e novamente quando se esgotam completamente.
Próximos passos recomendados por caso de uso
Escolha a linha que combina com seu cenário, depois siga a seção da Visão Geral vinculada para a receita completa:
| Cenário | O que adicionar após o assistente | Detalhes |
|---|---|---|
| Agência de KOL acompanhando 5 KOLs | Refinamento de cashtag + hashtag de campanha, cronograma 22:00 UTC | Caso de uso 1 |
| Projeto engajando a comunidade | Logo + URLs em 🎨 Personalização para o card público do xbot.ninja | Caso de uso 2 |
| Portfólio de KOL independente | Foto pessoal + URL do LinkedIn em Personalização, compartilhe a URL do xbot.ninja com clientes em potencial | Caso de uso 3 |
| Agência multi-cliente | /setup → 🎯 Filtros → ⤴ Filtros nomeados → ➕ Adicionar filtro nomeado — um por cliente | Caso de uso 4 |
| Recebendo posts de conta do X em tempo real | /setup → 📡 Auto-relay de Posts do X → ➕ Adicionar Conta | O menu /setup |
O que é configurado
| Seção em /setup | O que você define | Por que importa |
|---|---|---|
| 🎯 Filtros | Contas, cashtags, palavras-chave, menções a rastrear no X | Define quais posts o bot busca |
| ⏰ Cronograma | Horário do dia para o relatório automatizado | O bot roda a busca + renderização nesse cron |
| 📊 Relatórios & Período | Janela de datas opcional (ex.: período de competição) | Restringe o relatório a um intervalo específico |
| 🎨 Personalização | Nome do projeto, descrição, logo, URLs, pesos e cores do leaderboard | Marca para a imagem do relatório e o showcase público do xbot.ninja |
| 👥 Admins | Quem recebe DMs privadas sobre problemas de crédito / busca | Visibilidade operacional |
| 💳 Assinatura | Plano, saldo de créditos, ponto de entrada para upgrade | Visibilidade de custo e pagamento |
| 📡 Auto-relay | Contas do X para encaminhar ao chat em tempo real (a cada 5 min) | Atualizações ao vivo entre os relatórios agendados |
Showcase público (opcional)
Se seu projeto atende os limites de listagem pública (≥ 300 de pontuação máxima, ≥ 5 posts, ≥ 2 usuários ativos no mês corrente), ele aparece no xbot.ninja. Adicione os metadados do projeto em /setup → 🎨 Personalização (Nome, Descrição, Logo, URLs).
Configurações de KOL independente (conta única) não passam na regra de "≥ 2 usuários ativos" e permanecem acessíveis apenas em sua URL direta — isso é intencional.
Verificando a instalação
A maioria dos diagnósticos é visível diretamente no /setup (cada tela mostra o estado atual do chat no topo). Checklist rápido de sanidade:
| Verificação | Como |
|---|---|
| O bot é admin | Telegram → configurações do grupo → Administradores |
| O rastreamento está configurado | /setup → 🎯 Filtros → veja contas/cashtags/palavras-chave listadas |
| O filtro renderiza corretamente | /setup → 🎯 Filtros |
| O cronograma está definido | /setup (topo do menu mostra o cronograma atual) |
| Créditos disponíveis | /setup → 💳 Comprar Créditos |
| Relatório manual funciona | /setup → 📊 Relatórios → ⚡ Gerar relatório agora |
O primeiro relatório não apareceu — solução de problemas
Se Gerar relatório agora não produzir uma postagem em 3 minutos:
| Sintoma | Causa provável | Solução |
|---|---|---|
| DM do bot diz "nenhum post encontrado" | Filtro muito restrito OU nenhum post recente correspondente | /setup → 🎯 Filtros — verifique a query literal da API do X em busca de erros de digitação. Tente ampliar (remova o período de data se configurado). |
| DM do bot diz "crédito esgotado" | Chat FREE atingiu o limite de 100/mês | Aguarde o próximo mês, ou /setup → 💳 Comprar Créditos → 💰 Comprar para assinar / comprar um pacote de créditos |
| Nada acontece, sem DM | Bot não é admin, OU o webhook parou | Repromova o bot a admin. Se ainda assim nada, contate o suporte. |
| Imagem renderiza mas o texto está vazio | Comentário de IA expirou | Execute novamente; é transitório. Se persistir, contate o suporte — o provedor de IA às vezes tem interrupções passageiras |
| Erro "Unauthorized" / "Forbidden" | Problema de token da API do X (lado do operador) | Contate o suporte; não há nada que o usuário possa corrigir |
Diagnósticos de autoatendimento
/setup → ℹ️ Sobre mostra o ID do seu chat, plano e cronograma em uma única tela. Copie esse texto em qualquer solicitação de suporte — isso reduz o tempo de triagem em ~80%.
Perguntas frequentes sobre instalação
P. Posso instalar o bot em um canal do Telegram (não um grupo)? Não, apenas grupos e supergrupos. Canais não permitem contexto de resposta a mensagens, que o fluxo de relatório utiliza.
P. Posso rodar o bot em um grupo estilo fórum com tópicos? Sim. Use /set_topic de dentro do tópico onde deseja que os relatórios sejam postados. O bot posta nesse tópico a partir de então; se não configurado, posta na thread principal.
P. O bot precisa de acesso de leitura às mensagens do meu grupo? O bot só precisa receber mensagens de comando (ex.: /setup). Ele não lê o chat normal. Os dados do lado do X vêm da API oficial do X, não das suas mensagens no Telegram.
P. Posso rastrear uma conta privada/protegida do X? Não — a API do X só retorna posts públicos. Rastrear uma conta protegida retorna silenciosamente nenhum resultado.
P. Remover o bot do grupo apaga meus dados? Não. Configurações, histórico, pontuações e relatórios permanecem no banco de dados do bot. Se você readicionar o bot ao mesmo chat ID, tudo é retomado. Se quiser uma remoção completa, peça ao suporte.
P. Posso mudar o nome do projeto depois? Sim — /setup → 🎨 Personalização → 🏷 Nome. Atualiza o próximo relatório e o slug da URL pública no xbot.ninja.
P. Por que vejo contagens de posts diferentes das de [ferramenta X]? O X Bot busca diretamente da API oficial do X. A maioria dos rastreadores de terceiros faz scraping ou extrapola. Encontramos discrepâncias de 20–50% na prática. O número da API do X é a fonte da verdade.
P. Como eu cancelo?
- Chats FREE: basta remover o bot do grupo.
- Assinatura PRO:
/setup→ 💳 Comprar Créditos → 🛠 Gerenciar assinatura abre o Portal do Cliente Stripe onde você pode cancelar. O cancelamento entra em vigor no fim do período pago atual. - Créditos PRO (ETH): créditos não renovam automaticamente — o chat rebaixa para FREE por conta própria quando o saldo chega a zero. Remova o bot a qualquer momento.
Precisa de ajuda?
Veja Suporte, ou abra /setup → ℹ️ Sobre no seu chat para informações de diagnóstico para compartilhar com o time.
Leia a visão geral do X Bot para o detalhamento completo do que cada público — projetos cripto, agências de KOL, KOLs independentes, investidores — obtém do bot antes de começar a configuração.