Preços

O X Bot é gratuito para a maioria das comunidades. Usuários mais intensos têm dois caminhos — assinatura via cartão de crédito (recorrente; mais barata para qualquer chat que atinja aproximadamente 1.000+ posts/mês) ou pacote de créditos em ETH (compra única, nunca expira). Os dois se combinam de forma limpa. 1 crédito = 1 post do X retornado pela API.

Resumo — comece no FREE (100 posts/mês, sem cartão). Quando precisar de mais: assine via Stripe ($19/mês, primeiros 1.000 posts grátis, depois $0,02/post de excedente medido), ou compre um pacote de créditos ETH ($0,02/crédito, pacotes de 1.000 a 100.000, nunca expiram). Os dois se combinam de forma limpa — um chat pode ter créditos ETH e uma assinatura Stripe; o faturamento por busca consome primeiro os créditos ETH, depois a concessão mensal da assinatura, depois o excedente medido.

Compre ou faça upgrade em 3 toques: /setup → 💳 Comprar Créditos

Todo o fluxo de compra vive dentro do Telegram. Você nunca sai do bot para verificar preços ou saldos.

A partir do chat

1. Abra /setup → 💳 Comprar Créditos.
2. Toque em 💰 Comprar créditos / upgrade.
3. O bot responde com um card de opções de pagamento. As opções mostradas dependem do seu plano atual:

Plano atual	Opções mostradas
FREE	Ambas — assinatura Stripe ou pacote de créditos ETH
PRO · créditos (saldo ETH existente)	Ambas — continue recarregando via ETH, ou adicione uma assinatura Stripe por cima (seus créditos ETH permanecem e são gastos primeiro em cada busca)
PRO · assinatura (assinatura Stripe existente)	Encaminhamento para gerenciamento de cartão — já está no plano medido, nenhuma compra adicional necessária

4. Escolha um caminho:

Caminho A — Assinatura Stripe (chat FREE → assinatura PRO)

1. Toque em 💳 Pagar com Cartão de Crédito.
2. O bot cria uma sessão do Stripe Checkout e responde com um botão de link de checkout.
3. Toque no botão; o Stripe Checkout abre no seu navegador.
4. Digite os dados do cartão, conclua o pagamento.
5. O Stripe redireciona você de volta ao Telegram (https://t.me/BWS_X_Bot?start=payment_success_<chatId>).
6. O webhook do Stripe dispara o handler de ativação do bot em segundos — /setup → 💳 Comprar Créditos agora mostra PRO ✓ (assinatura).
7. O bot envia uma DM aos admins designados do chat confirmando a ativação.

O que você é cobrado:

• $19 de base todo mês enquanto a assinatura estiver ativa (cobrado no primeiro dia do mês seguinte, com proporção depois disso).
• $0,02 por post para cada post buscado acima de 1.000 no mês corrente — medido pelo Stripe, adicionado à fatura daquele mês.
• Os primeiros 1.000 posts de cada mês estão incluídos na base — são um limite gratuito, não um saldo de créditos que você pode acumular.

Cancele a qualquer momento — /setup → 💳 Comprar Créditos → 🛠 Gerenciar assinatura abre o Portal do Cliente Stripe. O cancelamento entra em vigor no fim do período pago atual; até lá você continua PRO com as mesmas regras de medição.

Caminho B — Pacote de créditos ETH (FREE → PRO·créditos, ou PRO·créditos → recarga)

1. Toque em 🪙 Pagar com ETH.

2. O bot cria uma sessão de compra de curta duração e responde com um botão de link válido por ~15 min.

3. Toque; abre xbot.ninja/buy-ethereum.html no seu navegador.

4. Conecte sua carteira (MetaMask, WalletConnect, etc.).

5. Escolha um pacote de créditos no menu suspenso:

   Tamanho do pacote	Preço (USD)
   1.000 créditos	$20
   2.000 créditos	$40
   3.000 créditos	$60
   4.000 créditos	$80
   5.000 créditos	$100
   10.000 créditos	$200
   50.000 créditos	$1.000
   100.000 créditos	$2.000

6. A página cota o equivalente em ETH na cotação atual.

7. Assine a transação. Os fundos vão para o contrato de tesouraria da BWS na mainnet do Ethereum.

8. Assim que a confirmação on-chain chega, o backend concede os créditos ao seu chat. Visível em /setup → 💳 Comprar Créditos como Créditos restantes: <saldo>.

O que você é cobrado: nada recorrente. Você paga uma vez por pacote, ETH é o único método de pagamento.

Recarregar depois: mesmo fluxo — escolha outro pacote no mesmo menu suspenso. Os créditos existentes se somam ao valor do novo pacote. Créditos nunca expiram.

Caminho A e Caminho B se combinam de forma limpa

Um chat pode ter ambos ao mesmo tempo. O faturamento por busca esgota os saldos nesta ordem:

1. Créditos ETH primeiro (decremento atômico de LICENSES.REMAINING_CREDITS).
2. Concessão mensal da assinatura (1.000 posts grátis no PRO·assinatura).
3. Excedente medido pelo Stripe ($0,02/post acima da concessão).

Se você tem 5.000 créditos ETH e assina, as próximas 5.000 buscas consomem os créditos (sem cobrança do Stripe); as buscas de 5.001 a 6.000 usam a concessão mensal da assinatura; buscas a partir de 6.001 são medidas. O saldo ETH sobrevive ao upgrade.

A única restrição que permanece: um chat que já está em PRO·assinatura não pode adicionar um pacote ETH hoje (o fluxo de compra bloqueia). Cancele a assinatura primeiro se precisar mudar para faturamento somente em créditos.

Depois da compra

Saldo de créditos + plano visíveis a qualquer momento:

/setup → 💳 Buy Credits

💳 Buy Credits & Plan

Plan:               PRO ✓ (credits)
Credits remaining:  4 152
Total purchased:    5 000

[💰 Buy credits / upgrade]
[🛠 Manage subscription]
[📊 Usage this month]

(Para chats com assinatura Stripe, a linha mostra Plan: PRO (subscription) ✓ sem saldo de créditos — o uso é medido, não debitado de uma contagem armazenada. 📊 Uso deste mês mostra o contador contínuo de fetched_posts que conduz o limite de medição.)

Planos em resumo

	FREE	PRO assinatura	PRO créditos (ETH)
Custo recorrente	$0	$19 / mês	$0
Custo por post	n/a — limite rígido de 100/mês	$0 nos primeiros 1.000/mês, $0,02/post acima (medido)	$0,02 / crédito fixo
Saldo de créditos	n/a — apenas contador de STATS	n/a — contador de STATS + medidor Stripe	Registro de REMAINING_CREDITS
Cartão necessário	Não	Sim (checkout Stripe)	Não (carteira ETH)
Renovação automática	n/a	Mensal, cancele quando quiser	n/a (compra única)
Créditos expiram	Reinicia mensalmente para 100	n/a	Nunca
Comportamento no esgotamento	Bot pausa buscas; DM ao admin	n/a (ilimitado, apenas faturado)	Rebaixa automaticamente para FREE; bot reaplica o limite de 100/mês
Melhor para	Grupos de teste, comunidades pequenas, KOLs independentes	Comunidades de produção estáveis, volume mensal previsível	Times cripto-nativos / pontuais / com picos de uso; créditos como orçamento sem expiração

A matemática dos créditos, na versão honesta

Um crédito equivale a um post do X retornado pela API. Se seu filtro traz de volta 47 posts em um relatório diário, isso são 47 créditos debitados (PRO·créditos) ou 47 posts marcados no limite deste mês (PRO·assinatura) ou no limite de 100/mês (FREE).

O que conta:

• Todo tweet distinto retornado pela chamada da API do X conta, mesmo que acabe fora do tema e seja descartado após a busca.
• Consultas do Auto-relay de Posts do X retornam 0 posts na maioria dos ticks (grátis) e de 1 a 10 em um tick onde o usuário realmente postou (um crédito por post encaminhado).
• Quote tweets contam: a API do X não tem exclude=quotes, então o bot os busca e filtra do lado do cliente. Economiza ruído no chat, mas não créditos.

O que não conta:

• exclude=retweets / exclude=replies do lado do servidor — esses posts nunca voltam da API, então não debitam nada.
• Buscas que falham com erro 4xx antes de retornar dados.
• Posts em cache reservidos por /setup → 📊 Relatórios → 📰 Mostrar último relatório.

Dimensionando sua necessidade mensal

Padrões comuns:

Padrão	Volume	Melhor plano
Portfólio de conta única, 1–2 posts/dia	~50 posts/mês	FREE
Comunidade pequena, 30 seguidores, tráfego leve de $TOKEN	100–300	FREE — ou pacote ETH de 1.000 créditos ($20) para um mês ocasional de pico
Agência de 5 KOLs, relatórios diários de 24h só no tema	800–1.500	Na fronteira entre FREE → PRO·assinatura. Se você regularmente ultrapassa 1.000 → assine; se for um mês pontual → pacote ETH
Projeto grande, campanha de hashtag, mais de 50 postadores	3.000–8.000	PRO·assinatura: $19 + ($0,02 × ~5.000 excedente) ≈ $119/mês — previsível
Auto-relay pesado (5 contas × 5 posts/dia × 30)	750/mês só dos relays	Se for só relays: fique no FREE se o resto for leve. Com relatórios também: PRO·assinatura.

Quando escolher qual

Fique no FREE

• Comunidade com ≤ 100 posts no tema por mês.
• Portfólio de KOL independente (uma conta, cadência baixa).
• Avaliando o produto sem nenhum compromisso.
• Grupos de teste/staging.

Migre para a assinatura PRO ($19/mês)

• Comunidade de produção estável — volume mensal de posts previsível.
• Múltiplas campanhas ou filtros nomeados rodando simultaneamente — mais fácil absorver picos via medição do que ficar comprando pacotes ETH o tempo todo.
• Agência de KOL ativa — relatórios diários para muitos clientes.
• Você prefere não pensar em saldos de crédito; "apenas me cobre pelo que eu usar".

Compre um pacote de créditos ETH

• Uso em picos: uma janela de lançamento / concurso / campanha onde você vai ter um pico e depois ficar quieto.
• Projetos pontuais — compre 5.000 créditos, use-os ao longo de N meses.
• Time cripto-nativo que prefere pagamento on-chain, sem autorização recorrente de cartão.
• Requisito de compliance / contabilidade que não permite faturamento recorrente por cartão.
• Orçamento sem expiração: créditos comprados hoje ainda são gastáveis daqui a um ano.
• Contratos com teto de gasto — "o cliente limitou esta campanha a $400, sem excedente": compre um pacote de 20.000, parada garantida quando a carteira esvaziar.

Perguntas frequentes sobre faturamento

P. Posso ter uma assinatura Stripe E créditos ETH no mesmo chat?Sim — eles se combinam. Um chat PRO·créditos que assina via Stripe mantém seu saldo ETH; o faturamento por busca esgota o saldo ETH primeiro, depois a concessão mensal da assinatura, depois mede o restante. A restrição atual: um chat que já está em uma assinatura Stripe ativa não pode adicionar um pacote ETH no mesmo fluxo (o buy.mjs bloqueia a segunda compra). Cancele a assinatura primeiro se precisar voltar para faturamento somente em créditos.

P. O que acontece com meu chat quando o PRO·créditos chega a zero? A licença é automaticamente rebaixada para FREE; a próxima busca cai sob o limite de 100 posts/mês (que ainda inclui qualquer contador do nível FREE do mês corrente). O bot então oferece novamente as duas opções no próximo /buy.

P. O que acontece no PRO·assinatura se eu exceder 1.000 posts em um mês? Você é medido. O Stripe recebe uma chamada record_usage para cada post acima do limite de 1.000, e a próxima fatura mensal inclui $0,02 × excedente. Não há limite rígido nem pausa surpresa — o bot continua buscando e a conta cresce.

P. Os créditos são por chat ou por usuário? Por chat. Cada grupo do Telegram tem seu próprio saldo e licença. Adicionar o bot a um segundo grupo significa uma segunda cota FREE de 100/mês.

P. Posso compartilhar uma assinatura entre múltiplos chats? Não — cada chat tem seu próprio cliente + assinatura Stripe.

P. Os créditos acumulam de um mês para o outro?

• FREE: não, cada mês é um novo ciclo de 100. Créditos não usados do nível 100 não se acumulam.
• 1.000 incluídos da assinatura PRO: não — o limite reinicia no seu ciclo de faturamento.
• Créditos comprados em ETH: sim, nunca expiram. Um pacote comprado em março ainda tem seu restante em novembro.

P. Comprei créditos, mas o saldo não mudou?

• Stripe: o webhook geralmente dispara em segundos. Se depois de 5+ minutos os créditos ainda estiverem faltando, contate o suporte com seu recibo do Stripe + ID do chat.
• ETH: a confirmação on-chain pode levar de 1 a 3 minutos. Se depois de 10 min os créditos não aparecerem, contate o suporte com o hash da transação + ID do chat.

P. Posso pedir reembolso? Para tempo de assinatura não usado: sim, contate o suporte — faremos o rateio. Para pacotes de créditos já parcialmente consumidos: caso a caso, mas geralmente só quando o bot claramente teve mau funcionamento. Compras em ETH não são reembolsáveis assim que a transação é confirmada (o protocolo não reverte).

P. O total "pago ao longo da vida" no admin não bate com meus recibos. O Stripe agrupa pagamentos de forma diferente para assinaturas vs. cobranças. O admin soma cobranças bem-sucedidas + faturas pagas. Compras em ETH não estão incluídas (são rastreadas via a tesouraria on-chain, não pelo Stripe). Reembolsos não são subtraídos (marcados separadamente). Para uma trilha de auditoria, use o Stripe Dashboard → Customers → busque pelo ID do chat.

P. Cancelei minha assinatura no meio do mês — quando perco o PRO? No fim do período de faturamento atual. O Stripe define cancel_at_period_end: true; o webhook do bot reverte a licença para FREE no evento real de cancelamento (customer.subscription.deleted), que dispara no fim do período.

P. Existe um teste grátis do PRO? O plano FREE é o seu teste. 100 posts/mês é generoso para avaliação; se você ultrapassar isso durante os testes, o menor pacote ETH (1.000 créditos = $20) é o caminho mais barato para estender.

Para onde ir depois

• Instalação — coloque um chat no ar em 3 passos.
• O menu /setup — tour completo da tela de Assinatura.
• Solução de problemas — matriz de sintomas específica de faturamento.
• Suporte — modelo de escalonamento + SLA de resposta.

Veja a visão geral do produto para os casos de uso (rastreamento de agência de KOL, engajamento de comunidade, portfólios de KOL independente, agências multi-cliente) que cada nível de preço suporta.