Como conectar sua conta do X (Twitter) por chaves de API e agendar posts pelo FarejaLeads
Atualizado em
Você cria um app no console de desenvolvedor do X, gera as quatro chaves com permissão de escrita e cadastra no FarejaLeads. Daí agenda posts pela tela ou pedindo ao seu agente (Claude, ChatGPT) pelo MCP. A API do X não agenda sozinha: o FarejaLeads guarda o post e publica na hora marcada.
O que você ganha
- Agendar posts de texto em uma ou várias contas do X
- Pedir pelo agente: “agenda no @minhaempresa amanhã às 9h: …”
- Ver o que saiu, o que falhou (com o motivo em português) e cancelar o que ainda não saiu
Antes de começar
- Entre no console do X com a MESMA conta em que os posts vão sair: as chaves geradas no console publicam na conta dona do app. Para outra conta, repita o guia entrando com ela.
- Crédito no console do X: a API é paga por uso (sem plano grátis para conta nova). Post de texto custa US$ 0,015 e post com link, US$ 0,20, descontados do seu crédito no X — o FarejaLeads não cobra pelo post.
Passo a passo
1. Crie o app no console do X
Abra console.x.com e entre com a conta do X que vai publicar. Aceite os termos de desenvolvedor se for a primeira vez.
Crie um app (Create App ou New Project → App): nome FarejaLeads-SuaEmpresa, descrição curta e o uso ("agendar posts da minha conta").
Em Billing / Credits, compre um pouco de crédito. Sem crédito, o X responde 402 e nada sai.
O nome deste menu pode ter mudado na plataforma. Viu outro? Conte abaixo: o guia se corrige com o seu relato.
2. Ligue "Read and write" ANTES de gerar o Access Token
No app, abra Settings → User authentication settings → Set up (ou Edit). Em App permissions, marque "Read and write".
Em Type of App, escolha "Web App, Automated App or Bot". O X pede Callback URI e Website URL: pode usar https://farejaleads.com nos dois (o FarejaLeads não usa esse retorno). Salve.
A ordem importa: o Access Token guarda a permissão do momento em que foi gerado. Token gerado antes de ligar "Read and write" continua só-leitura e o post falha com 403.
O nome deste menu pode ter mudado na plataforma. Viu outro? Conte abaixo: o guia se corrige com o seu relato.
3. Gere as quatro chaves
No app, abra Keys and tokens. Em Consumer Keys, gere (ou regenere) a API Key e a API Key Secret.
Em Authentication Tokens → Access Token and Secret, clique em Generate (ou Regenerate, se já existia de antes da permissão). Confira que aparece "Read and Write" junto do token.
Copie as quatro na hora: o console mostra cada segredo uma vez só. Não use o Bearer Token: ele só lê dado público e não publica.
O nome deste menu pode ter mudado na plataforma. Viu outro? Conte abaixo: o guia se corrige com o seu relato.
4. Cadastre no FarejaLeads pela tela
No app, abra Posts no X (farejaleads.com/app/posts-x) → Adicionar conta. Dê um apelido (ex.: empresa) e cole API Key, API Key Secret, Access Token e Access Token Secret.
Ao salvar, o FarejaLeads confere as chaves no X e mostra o @handle da conta. As chaves ficam cifradas e nunca aparecem de novo; para trocar, cadastre outra vez com as novas.
5. Ou cadastre e agende pelo seu agente (MCP)
Conecte o MCP do FarejaLeads (farejaleads.com/mcp) e, na tela de permissões, marque "Cadastrar suas contas do X (Twitter) e agendar, listar e cancelar posts nelas". Já conectou antes? Desconecte e conecte de novo para marcar essa permissão.
Pelo agente dá para cadastrar a conta (cadastrar_conta_x), mas as chaves passam pelo cliente MCP e podem ficar no histórico da conversa: prefira a tela do passo 4.
Exemplos de pedido: "agenda no @minhaempresa amanhã às 9h: Abrimos as inscrições da turma de novembro"; "quais posts do X estão agendados esta semana?"; "cancela o post de sexta". O agente mostra texto, conta e hora antes de agendar; o fuso padrão é o de Recife (America/Recife).
6. Erros comuns
401: chave errada, incompleta ou regenerada no console. Copie de novo as quatro e cadastre outra vez.
403 com permissão: o Access Token é só-leitura. Ligue "Read and write" (passo 2) e regenere o Access Token e o Secret (passo 3). 403 duplicado: o X recusa post igual a um recente da mesma conta.
429: limite de uso do X (100 posts a cada 15 minutos por conta, 10.000 por dia por app). O FarejaLeads espera a janela reabrir e tenta de novo sozinho, até 5 vezes. 402: acabou o crédito no console do X.
Regras que valem sempre
- O post sai em até um minuto depois da hora marcada (o FarejaLeads confere a fila de minuto em minuto).
- Só texto, até 280 caracteres pela contagem do X: link conta 23 e emoji conta 2. Para imagem e vídeo, use o Metricool.
- Remover a conta no FarejaLeads apaga as chaves e cancela os posts que ainda não saíram. Para cortar o acesso de vez, regenere as chaves no console do X.
- Nunca cole as chaves em e-mail, print ou conversa com outra pessoa: quem tem as quatro publica na sua conta.