X (Twitter) do zero: console de desenvolvedor, crédito com teto, app com escrita e as 4 chaves

Para que serve no AFK

• Publicar um post na sua conta, com texto e, se quiser, uma imagem, um GIF ou um vídeo.
• Enviar a mídia pela API do X e esperar o X terminar de processar o vídeo antes de postar.
• Explicar a recusa. Se o X recusar a mídia por falta de crédito ou por app sem escrita, o AFK diz o que fazer.
• Como roda: por um comando no terminal do AFK. Nenhuma rotina do AFK posta no X sozinha.

O que o AFK não faz no X: não publica thread (um post só por comando), não agenda horário, não responde e não lê métricas. A habilidade /thread escreve a thread pronta. Diga ao AFK "cria uma thread sobre bolo de pote" e poste no X pelo app ou pelo site.

Sem a conexão: o AFK entrega a thread pronta para você colar.

Antes: grátis ou pago

A API do X cobra por uso, com crédito pré-pago. Não há plano grátis nem valor fixo por mês.

Preços da documentação oficial, conferidos em 30/10/2026, em dólar:

• Link encarece 13 vezes. Post com endereço de site no texto entra no preço de post com link. Para divulgar o site, ponha o link na bio.
• Crédito grátis de entrada. Conta nova que salva o primeiro cartão (crédito ou débito, não pré-pago) e faz a primeira compra de crédito ganha US$ 20. A primeira recarga automática ganha o mesmo valor em crédito, até US$ 50. Esse crédito grátis vence em 3 meses. O X avisa que esse bônus ainda está chegando aos poucos às contas.
• Teto de gasto. O console deixa pôr um limite de gasto por ciclo. Ao bater o limite, o X bloqueia os pedidos até o ciclo seguinte. Ligue sempre (Parte 3).
• Limite de ritmo: até 100 posts a cada 15 minutos por conta.
• Risco de bloqueio: baixo pela API oficial. O que derruba conta é spam: post repetido, muitas menções e link em massa. O X recusa post com texto igual a um anterior.
• O preço muda. Confira em docs.x.com/x-api/getting-started/pricing e no console.

Parte 1: conta do X e segurança

1. Use a conta do X do negócio, por exemplo @minhaempresa. O app que você vai criar posta na conta que criou o app.
2. Ligue a autenticação de dois fatores. Em Configurações e privacidade → Segurança e acesso à conta → Segurança → Autenticação de dois fatores, escolha App de autenticação ou Chave de segurança. O SMS é o mais fraco dos três.

Parte 2: entrar no console de desenvolvedor

O console do X é em inglês. Os nomes abaixo estão como aparecem na tela.

1. Abra console.x.com e entre com a conta do X do negócio.
2. Aceite o contrato de desenvolvedor.

Parte 3: crédito e teto de gasto

1. No console, abra a área de cobrança (Billing).
2. Cadastre um cartão de crédito ou débito.
3. Compre crédito. Para 30 posts por mês sem link, US$ 5 duram cerca de 10 meses.
4. Ponha um limite de gasto por ciclo, por exemplo US$ 10. Assim um erro não esvazia o cartão.
5. A recarga automática é opcional. Com ela ligada, o X tira do cartão sempre que o saldo cai abaixo do valor que você escolher. Se ligar, mantenha o teto de gasto.

Parte 4: criar o app e gerar as 4 chaves

A ordem importa: permissão primeiro, chaves depois. Token gerado antes de mudar a permissão continua só de leitura.

1. No console, clique em Create App. Preencha o nome (por exemplo, AFK Minha Empresa), a descrição e o uso.
2. Nas permissões do app (OAuth 1.0a), escolha Read and write. Não escolha Read, write, and DMs: o AFK não usa mensagem direta.
3. Salve.
4. Em Keys and tokens, gere a API Key e a API Key Secret.
5. Na mesma tela, gere o Access Token e o Access Token Secret. Confira que a permissão mostrada para eles é leitura e escrita.
6. Copie os quatro valores na hora. O X só mostra cada um uma vez. Perdeu: gere de novo, e o antigo para de funcionar.

Parte 5: colar no AFK

1. No painel do AFK, abra Conexões e clique no cartão X (Twitter).
2. Cole cada valor no campo de mesmo nome: API Key, API Key Secret, Access Token e Access Token Secret.
3. Clique em Salvar conexão. O cartão não tem Testar. A prova é o primeiro post (Parte 6).

Onde as chaves ficam. Só no arquivo .env da pasta do AFK, no seu computador. Elas não vão para a nuvem do AFK e não sobem para o GitHub. Nunca cole as chaves no chat, no WhatsApp ou em print.

Parte 6: primeiro post

1. Abra o terminal na pasta do AFK.
2. Se nunca rodou as ferramentas de Python do AFK, instale as bibliotecas uma vez:

   pip install -r ferramentas/comum/requirements.txt

3. Publique um post de teste, sem link:

   python ferramentas/publicar/postar_x.py --texto "Teste da Minha Empresa"

4. O certo é aparecer Publicado no X: https://x.com/i/status/.... Abra o link e confira. Apague o post de teste pelo app, se quiser.

No dia a dia

Se uma chave vazar: gere todas de novo no console na hora. As antigas param de funcionar. Cole as novas no AFK.

Erros e soluções

Se nada funcionar

Veja Travou ou quero sugerir uma melhoria: o que mandar. Mande o texto do erro. Nunca mande as chaves.

Fontes oficiais (conferido em 30/10/2026): docs.x.com/x-api/getting-started/pricing (só uso por crédito, sem assinatura; post US$ 0,015; post com link US$ 0,20; leitura US$ 0,005; teto de gasto por ciclo; recarga automática) · docs.x.com/x-api/getting-started/free-credits (US$ 20 após a primeira compra com o primeiro cartão; recarga automática igualada até US$ 50; crédito grátis vence em 3 meses; bônus ainda em liberação) · docs.x.com/fundamentals/developer-apps (console.x.com; Create App; permissões Read only, Read and write, Read, write, and DMs; mudar a permissão pede token novo; credencial mostrada uma vez) · docs.x.com/x-api/getting-started/getting-access (Access Token & Secret agem pela sua própria conta; gerar de novo invalida o antigo) · docs.x.com/x-api/media/upload-media (envio de mídia aceita token de usuário OAuth 1.0a ou OAuth 2.0 com media.write) · docs.x.com/x-api/fundamentals/rate-limits (POST /2/tweets: 100 a cada 15 minutos por usuário, 10.000 por dia por app) · docs.x.com/x-api/fundamentals/response-codes-and-errors (401, 403, 429 e os tipos de erro) · help.x.com/managing-your-account/two-factor-authentication (caminho da autenticação de dois fatores; SMS, app de autenticação ou chave de segurança).