X (Twitter) API

X + N8N

A API do X (antigo Twitter) permite automatizar publicacoes, monitorar mencoes da sua marca, e criar bots que interagem com usuarios. Ideal para marketing e atendimento.

Publicar

Agende e publique tweets automaticamente

Monitorar

Acompanhe mencoes e hashtags em tempo real

Analisar

Colete dados de engajamento e metricas

Automatizar

Responda automaticamente a mencoes

Planos da API do X

Importante

A API do X mudou significativamente em 2023. O plano gratuito tem limitacoes severas. Para uso comercial, e necessario plano pago.

Free

$0

• 1.500 tweets/mes (POST)
• Apenas escrever tweets
• 1 App ID
• Sem leitura de tweets

Basic

$100/mes

• 3.000 tweets/mes (POST)
• 10.000 tweets/mes (GET)
• 2 App IDs
• Login com X

Pro

$5.000/mes

• 300.000 tweets/mes (POST)
• 1.000.000 tweets/mes (GET)
• 3 App IDs
• Full-archive search

1

Criar App no Developer Portal

Cadastro e configuracao inicial

Acessar Developer Portal

1. Acesse developer.twitter.com
2. Faca login com sua conta do X
3. Clique em Developer Portal
4. Aceite os termos de uso da API

Criar Projeto e App

1. Va em Projects & Apps → Overview
2. Clique em + Add Project
3. Preencha nome, descricao e caso de uso
4. Crie um App dentro do projeto

2

Obter Credenciais

API Keys e Access Tokens

Tipos de Credenciais

API Key & Secret

Identificam seu App. Usados para OAuth.

Bearer Token

Para endpoints que nao precisam de usuario (App-only).

Access Token & Secret

Permitem agir em nome de um usuario especifico.

Gerar Access Token

1. No seu App, va em Keys and Tokens
2. Em Consumer Keys, clique em Regenerate
3. Copie API Key e API Key Secret
4. Em Authentication Tokens, gere o Access Token
5. Copie Access Token e Access Token Secret

Permissoes

Configure as permissoes em User authentication settings. Para postar tweets, precisa de Read and Write.

3

Configurar no N8N

Adicionar credencial do X

Criar Credencial

1. No N8N, va em Credentials → Add Credential
2. Busque por X (Formerly Twitter) OAuth1 API
3. Preencha os 4 campos:

Consumer Key: sua-api-key
Consumer Secret: sua-api-key-secret
Access Token: seu-access-token
Access Token Secret: seu-access-token-secret

Pronto!

Agora voce pode usar o node X para postar tweets e buscar dados.

4

Operacoes Disponiveis

O que voce pode fazer com o node X

Tweet

• Create - Postar tweet
• Delete - Apagar tweet
• Search - Buscar tweets
• Like - Curtir tweet
• Retweet - Retweetar

User

• Get - Buscar usuario
• Get Followers - Listar seguidores
• Get Following - Listar seguindo

Direct Message

• Send - Enviar DM

List

• Get - Buscar lista
• Add Member - Adicionar membro

Exemplos Praticos

1. Postar tweet automaticamente

// Schedule Trigger: Every day at 9am
// → X: Create Tweet

Text: "Bom dia! Confira nosso conteudo de hoje: {{ $json.link }}"

2. Monitorar mencoes e responder

// Schedule Trigger: Every 15 min
// → X: Search Tweets (query: @suamarca)
// → OpenAI: Gerar resposta
// → X: Create Tweet (reply)

// Search:
Query: "@suamarca -is:retweet"

// Reply:
Text: "@{{ $json.author.username }} {{ $('OpenAI').item.json.text }}"
Reply To: {{ $json.id }}

3. Tweet quando publicar blog post

// RSS Feed Trigger: Seu blog
// → X: Create Tweet

Text: "Novo post: {{ $json.title }}

{{ $json.link }}

#blog #novidade"

4. Coletar tweets de hashtag para analise

// Schedule Trigger: Every hour
// → X: Search Tweets
// → Google Sheets: Append Row

// Search:
Query: "#n8n OR #automation lang:pt"

// Sheets row:
Date: {{ $now }}
User: {{ $json.author.username }}
Tweet: {{ $json.text }}
Likes: {{ $json.public_metrics.like_count }}

Troubleshooting

403 Forbidden

Permissoes insuficientes. Verifique se o App tem "Read and Write" em User Authentication Settings.

429 Too Many Requests

Limite de taxa atingido. Aguarde alguns minutos ou reduza frequencia dos requests.

401 Unauthorized

Tokens invalidos ou expirados. Regenere as credenciais no Developer Portal.

Cannot read tweets (Free plan)

O plano gratuito nao permite leitura de tweets. Upgrade para Basic ($100/mes) para ter acesso.