Ligar o X (Twitter) ao Social Quack

Uma aplicação tua na consola do X, uns dólares de crédito, e as tuas publicações saem à hora marcada — com as chaves cifradas no teu próprio Mac.

O X é a única plataforma do Social Quack em que publicar custa dinheiro. De resto é simples: crias uma pequena aplicação de programador tua, colas duas chaves no Social Quack e aprovas a ligação na página do próprio X. Fazes isto uma vez — a ligação do X nunca caduca, por isso não há nada para voltar a ligar de poucas em poucas semanas.

Como a aplicação é tua, as chaves ficam cifradas no teu computador e a permissão de publicação é só tua. Não estás a partilhar um bolo com as contas de mais ninguém, por isso a atividade de terceiros nunca te pode valer um limite.

1. Quanto custa

O X já não tem nível gratuito para publicar. O antigo acesso Free (Standard Basic) está descontinuado — uma aplicação que ainda esteja lá é recusada de cada vez que tenta publicar. Para publicares através da API do X precisas de uma conta de programador no plano Pay Per Use com algum crédito carregado. Uma publicação custa cêntimos.

Carregar 5 a 10 $ chega bem para começar. Isto aplica-se só ao X; o Bluesky, o Mastodon e as outras plataformas do Social Quack são gratuitos.

2. Abre primeiro o cartão do X no Social Quack

Começa na aplicação, para teres logo no ecrã o valor que vais ter de copiar:

Channels (canais) na barra lateral → o cartão X (Twitter) → Set up app keys (configurar chaves da aplicação).

(Assim que um workspace tiver chaves guardadas, esse botão passa a dizer Edit app keys (editar chaves da aplicação) — abre o mesmo painel.)

Esse painel tem as duas caixas que vais preencher no fim e, por cima delas, o endereço de redirecionamento a que o X chama Callback URI, com um botão para copiar ao lado. Inclui a porta em que esta cópia do Social Quack está a correr, por isso tira-o do botão de copiar em vez de o escreveres — o X rejeita-o se houver um único carácter fora do sítio. Deixa essa janela aberta.

3. Criar um projeto Pay Per Use e carregar crédito

1. Vai a https://console.x.com e abre Projects. Precisas de um projeto no plano Pay Per Use. Se só tiveres um projeto antigo em Free (Standard Basic), ele já não funciona — usa o de Pay Per Use, ou cria um.
2. Billing → Credits: carrega 5 a 10 $.

4. Criar a aplicação

Dentro do projeto Pay Per Use: Apps → Create App.

Já tens uma aplicação parada num projeto antigo? Podes movê-la, em Project Access → Manage.

5. Definir as permissões e o endereço de retorno

Abre a aplicação → Settings, na secção Authentication settings:

Grava. Faz isto antes do passo seguinte: chaves criadas antes de uma mudança de permissões ficam com o nível antigo, e a ligação falha depois de aprovares no X.

6. Copiar a API Key e o Secret

Aplicação → Keys & Tokens → OAuth 1.0 Keys → Regenerate na Consumer Key e depois copia os dois valores que te mostra:

• API Key (Consumer Key)
• API Key Secret (Consumer Secret)

O segredo é mostrado uma única vez. Se fechares a página sem o copiares, gera outro — e gera outro sempre que mudares as permissões da aplicação.

Gerar de novo substitui o par antigo em todo o lado: o X assina cada uma das tuas publicações com estas chaves, por isso assim que geras um par novo, o antigo morre. Se os tiveres colado em mais do que um workspace, abre o painel Set up app keys de cada um desses workspaces e cola lá também o par novo — ao gravar abre-se outra vez a página de autorização do X, e aprovar volta a ligar essa conta por cima, mantendo tudo o que ela tem na fila. Um workspace que fique com as chaves antigas deixa de conseguir publicar.

7. Colá-las e ligar

De volta ao Social Quack, nesse mesmo painel Set up app keys: cola-as em API Key (Consumer Key) e API Key Secret (Consumer Secret) e clica em Save (guardar). Não há mais nada para carregar — guardar as chaves abre logo a página de autorização do X no teu navegador. Aprova-a para a conta com que queres publicar. O navegador vai depois parar numa página Connected! que te diz para fechares o separador e voltares ao Social Quack. Faz isso: a conta já lá está à tua espera, na página Channels.

Assim que as chaves estiverem guardadas, o botão Connect (ligar) do cartão do X começa essa mesma autorização sozinho — é esse que hás de usar noutro dia, para acrescentares uma segunda conta ou para voltares a ligar uma.

Podes ligar várias contas através da mesma aplicação: uma por workspace, se mantiveres marcas separadas. Cada workspace guarda a sua própria cópia das chaves, por isso muda de workspace na barra lateral e cola os mesmos dois valores no painel Set up app keys desse workspace — gravar ali abre também a página de autorização para esse workspace. Uma só aplicação no X cobre todos.

8. O que podes publicar no X

As fotografias maiores do que o X aceita, ou num formato que ele não leve, são redimensionadas e convertidas por ti antes de saírem — não tens de preparar nada.

Se alguma coisa correr mal

Continuas encravado? [email protected].