Todos os guias

Ligar o Mastodon

Cria uma aplicação no teu próprio servidor Mastodon, copia um token e cola-o — cerca de dois minutos, sem nada para requerer.

O Mastodon é a plataforma mais fácil de ligar. Não há aplicação de programador para registar nem revisão para passar: passa-se tudo dentro do servidor Mastodon de onde já publicas, numa página de definições que quase ninguém abre. Os mesmos passos servem para qualquer servidor compatível com o Mastodon — o próprio Mastodon, e também o Pleroma e o GoToSocial.

O que colares fica cifrado e não sai do teu Mac. E como a aplicação é tua, no teu próprio servidor, os limites de publicação são só teus — nunca estás a partilhar uma quota com outros clientes do Social Quack.

1. Abrir a página Development no teu servidor

Inicia sessão no teu servidor Mastodon num navegador. O teu servidor é a parte a seguir ao segundo @ do teu handle — se és @[email protected], o teu servidor é mastodon.social.

Depois vai a Preferences → Development → New application.

2. Criar a aplicação

Dá-lhe o nome que quiseres — é só uma etiqueta que verás nas tuas próprias definições. "Social Quack" serve perfeitamente.

Assinala estes três scopes (um scope é apenas uma permissão que estás a conceder):

Scope O que permite ao Social Quack fazer
read Verificar o token e ler a que conta pertence, para o canal aparecer com o nome, o handle e a fotografia certos.
write:statuses Publicar as tuas publicações, e as respostas que formam uma sequência.
write:media Carregar as imagens que anexas a uma publicação.

Guarda a aplicação.

3. Copiar o access token

Abre a aplicação que acabaste de criar e copia o valor identificado como Your access token.

Trata-o como uma palavra-passe — quem o tiver pode publicar em teu nome. É a única coisa de que precisas; não há nada para colar de volta no Mastodon, nenhum endereço para registar e nenhuma aprovação pela qual esperar.

4. Colá-lo no Social Quack

No Social Quack abre Channels (canais), encontra o Mastodon em Add a channel (adicionar um canal) e clica em Connect (ligar). Aparecem duas caixas:

Campo O que pôr lá dentro
Instance URL O endereço web completo do teu servidor, https:// incluído — por exemplo https://mastodon.social. Uma barra no fim não faz mal, o Social Quack arruma isso.
Access token O token que acabaste de copiar. Fica mascarado enquanto escreves, como uma palavra-passe.

Clica em Connect. O Social Quack confirma logo o token junto do teu servidor, e a conta aparece na lista de canais com o nome que mostras, a fotografia e o handle @tu@o-teu-servidor completo. A configuração é toda esta.

5. O que esperar quando publicares

Comprimento 500 caracteres por publicação.
Sequências Suportadas. Cada parte é publicada como resposta à anterior, por isso lê-se mesmo como uma sequência.
Imagens Até 4, anexadas à primeira publicação de uma sequência — as partes seguintes saem como texto. O texto alternativo que escreveres no Social Quack viaja com a imagem.
Vídeo e GIF grandes O teu servidor processa estes ficheiros antes de poderem ser anexados, por isso o Social Quack espera — até cerca de dois minutos. Se o teu servidor ainda estiver a trabalhar no ficheiro quando esse tempo acabar, a publicação inteira falha e vai parar a Failed (falhadas) no Queue (a fila), em vez de sair sem ele — reagenda-a, ou anexa uma versão mais curta ou mais pequena.
Visibilidade As publicações saem públicas.

O Social Quack marca uma publicação como publishing antes de a enviar, por isso o agendador nunca consegue publicar a mesma coisa duas vezes.

Se alguma coisa correr mal

O que vês O que significa O que fazer
O token é recusado quando clicas em Connect Normalmente o scope read ficou por assinalar, ou o token foi copiado só em parte Cria uma aplicação nova em Preferences → Development, assinala os três scopes e copia outra vez o Your access token de uma ponta à outra
A ligação falha e escreveste apenas mastodon.social O Instance URL precisa do endereço completo Escreve-o como https://mastodon.social — com https:// à frente
As publicações falham, mas a conta ligou-se sem problemas Falta o write:statuses à aplicação Cria uma aplicação nova com os três scopes assinalados e cola o novo token
Mastodon media upload failed: … A imagem não pôde ser carregada — quase sempre porque o write:media ficou por assinalar, ou porque o teu servidor rejeitou o ficheiro Vê primeiro os scopes; se estiverem certos, experimenta uma imagem mais pequena ou exportada de novo
Mastodon media status check failed: … O teu servidor parou a meio do processamento do ficheiro Tenta outra vez, ou anexa uma versão mais pequena do vídeo ou do GIF
Uma publicação com vídeo ou GIF grande falha com 422 O teu servidor ainda estava a processar o ficheiro quando os dois minutos de espera acabaram Reagenda a publicação, ou anexa uma versão mais curta ou mais pequena
Mastodon did not return a status id O teu servidor aceitou a publicação mas não devolveu nada Tenta publicar de novo; se continuar a acontecer, o teu servidor deve estar com problemas — vê a página de estado dele
Um dia as publicações deixam de sair A aplicação foi revogada ou apagada no teu servidor Cria outra, copia o novo token e liga outra vez com o mesmo endereço de servidor — a mesma conta no mesmo servidor é atualizada em vez de aparecer duas vezes
Anexaste mais de 4 imagens Só as 4 primeiras são enviadas Tira as restantes. As imagens vão sempre na primeira parte de uma sequência, nunca numa posterior, por isso para publicares mais fotografias agenda uma segunda publicação

Continuas encravado? Escreve para [email protected].

Encravado nalgum passo? Escreve para [email protected] e uma pessoa responde-te.