Federação do Mastodon com o PeerTube: Fluxo de Resposta em Vídeo

Você tem uma conta no Mastodon e quer responder a um vídeo do PeerTube diretamente da sua timeline. Quando você digita uma resposta pública a um vídeo do PeerTube impulsionado, seus seguidores no Mastodon veem a resposta, mas o criador original do vídeo no PeerTube pode não receber uma notificação. Isso acontece porque Mastodon e PeerTube usam o mesmo protocolo ActivityPub, mas tratam respostas e notificações de forma diferente. Este artigo explica como funciona o link de federação entre as duas plataformas e fornece um fluxo de trabalho confiável passo a passo para garantir que suas respostas em vídeo cheguem ao criador no PeerTube.

Como Funciona a Federação entre Mastodon e PeerTube para Respostas em Vídeo

Mastodon e PeerTube implementam o protocolo ActivityPub, que permite trocar atividades como notas, curtidas e compartilhamentos. Quando um vídeo do PeerTube é compartilhado no Mastodon, o servidor do Mastodon recebe uma atividade da instância do PeerTube. O vídeo aparece na sua timeline como um status com um link para o vídeo do PeerTube. Se você responder a esse status da sua conta do Mastodon, sua resposta é enviada para seus seguidores no Mastodon e também para a instância do PeerTube que originalmente enviou a atividade do vídeo.

O detalhe crítico é que o PeerTube trata as respostas de forma diferente do Mastodon. O PeerTube espera que a resposta seja endereçada à caixa de entrada ActivityPub do canal. Se sua resposta no Mastodon endereçar apenas a conta que impulsionou ou o usuário do Mastodon que impulsionou o vídeo, a instância do PeerTube pode não entregar a resposta à caixa de entrada do criador do vídeo. O criador então nunca vê seu comentário. Para garantir a entrega, sua resposta deve incluir o handle ActivityPub do canal do PeerTube.

Cada canal do PeerTube tem um handle ActivityPub único no formato @canal@instancia.tube. Por exemplo, um canal chamado “TechReviews” na instância do PeerTube video.example.com tem o handle @TechReviews@video.example.com. Quando você inclui esse handle na sua resposta, a implementação ActivityPub do Mastodon endereça a mensagem para a caixa de entrada desse canal. O PeerTube então processa a resposta e a exibe na seção de comentários do vídeo.

Fluxo de Trabalho Passo a Passo para Responder a um Vídeo do PeerTube a Partir do Mastodon

Método 1: Responder Usando a Postagem Impulsionada com a Menção Correta

Este método funciona quando o vídeo do PeerTube aparece na sua timeline do Mastodon como uma postagem impulsionada de outro usuário ou do próprio canal de vídeo.

1. Localize o vídeo do PeerTube impulsionado na sua timeline
   Encontre o status que contém o link do vídeo do PeerTube. Geralmente mostra um cartão de pré-visualização com o título do vídeo e uma miniatura. A postagem pode vir de um usuário do Mastodon que a impulsionou ou diretamente da conta do canal do PeerTube.
2. Copie o handle do canal do PeerTube
   Abra o link do vídeo no seu navegador. Na página do vídeo do PeerTube, procure o nome do canal abaixo do título do vídeo. Clique no nome do canal para ir à página do canal. A URL contém o handle do canal, como video.example.com/accounts/TechReviews. O handle no formato ActivityPub é @TechReviews@video.example.com. Anote ou copie esse handle.
3. Clique no botão de resposta na postagem impulsionada
   No Mastodon, clique no ícone de resposta (a seta apontando para a esquerda) no status impulsionado. Isso abre um novo campo de postagem com o handle do autor original já incluído.
4. Adicione o handle do canal do PeerTube à resposta
   No campo de resposta, adicione um espaço após o handle existente e digite o handle do canal do PeerTube que você copiou. Exemplo: @usuarioOriginal @TechReviews@video.example.com Seu texto de resposta aqui.
5. Publique a resposta
   Clique no botão de publicar. O Mastodon envia a resposta tanto para o autor original quanto para o canal do PeerTube. A instância do PeerTube processa a resposta e a adiciona como um comentário na página do vídeo.

Método 2: Criar uma Nova Postagem com o Link do Vídeo e a Menção ao Canal

Use este método quando a postagem impulsionada não permitir respostas ou quando você quiser iniciar uma nova conversa.

1. Copie a URL do vídeo do PeerTube
   Abra o vídeo do PeerTube no seu navegador. Copie a URL completa da barra de endereços, por exemplo https://video.example.com/w/abc123.
2. Abra a caixa de composição do Mastodon
   Clique no botão de compor no seu cliente Mastodon.
3. Cole a URL do vídeo e adicione o handle do canal
   Cole a URL do vídeo do PeerTube no campo de composição. Em seguida, digite o handle do canal do PeerTube no formato @canal@instancia.tube. Exemplo: https://video.example.com/w/abc123 @TechReviews@video.example.com Ótima análise, obrigado por compartilhar!
4. Defina a visibilidade da postagem como Pública
   Certifique-se de que a configuração de visibilidade esteja como Pública. O PeerTube não pode processar respostas não listadas ou apenas para seguidores como comentários no vídeo.
5. Publique a postagem
   Clique em publicar. O Mastodon envia a atividade para a instância do PeerTube. O criador do vídeo recebe uma notificação e a resposta aparece na seção de comentários do vídeo.

Problemas Comuns de Federação e Como Evitá-los

A Resposta Não Aparece como Comentário no PeerTube

A causa mais frequente é que a resposta do Mastodon não incluiu o handle do canal do PeerTube. Sem o handle, o Mastodon endereça a resposta apenas para a conta que impulsionou ou para a instância que enviou a atividade do vídeo. O PeerTube não recebe a resposta na caixa de entrada do canal. Para corrigir, sempre inclua o handle completo no formato @canal@instancia.tube em cada resposta.

A Instância do PeerTube Bloqueia Sua Instância do Mastodon

Algumas instâncias do PeerTube têm bloqueios de domínio que impedem a federação com certos servidores Mastodon. Se sua resposta nunca chegar à instância do PeerTube, verifique a política de moderação da instância do PeerTube. Você pode pedir ao administrador da instância para permitir seu servidor Mastodon. Alternativamente, poste sua resposta diretamente na página do vídeo do PeerTube usando uma conta do PeerTube.

A Resposta Está Definida como Não Listada ou Apenas para Seguidores

O PeerTube processa apenas respostas públicas. Se a visibilidade da sua postagem no Mastodon estiver definida como Não Listada ou Apenas para Seguidores, a instância do PeerTube ignora a atividade. Sempre defina a resposta como Pública quando quiser que ela apareça como comentário no vídeo.

O Criador do Vídeo Usa uma Instância Diferente do PeerTube

Se o criador do vídeo moveu seu canal para uma instância diferente, o handle antigo pode não funcionar mais. Verifique o handle atual do canal visitando a página do vídeo e clicando no nome do canal. Use o handle que aparece na página do vídeo, não um handle antigo que você possa ter salvo.

Resposta no Mastodon vs. Comentário Direto no PeerTube: Comparação

Item	Fluxo de Resposta no Mastodon	Comentário Direto no PeerTube
Requer conta	Apenas conta no Mastodon	Conta no PeerTube na mesma instância
Notificação ao criador	Entregue via ActivityPub se o handle for incluído	Entregue pelo sistema de notificação interno do PeerTube
Visibilidade da resposta	Visível tanto no Mastodon quanto no PeerTube	Visível apenas no PeerTube
Dependência da instância	Ambas as instâncias devem federar	Apenas a instância do PeerTube importa
Facilidade de uso	Requer busca manual do handle	Um clique após o login

O fluxo de resposta no Mastodon oferece a vantagem de manter a conversa na sua timeline inicial enquanto ainda contribui para a seção de comentários do vídeo no PeerTube. O método de comentário direto é mais simples, mas requer uma conta separada no PeerTube e não aparece no Mastodon.

Agora você pode responder a vídeos do PeerTube a partir do Mastodon e ter seus comentários aparecendo na página do vídeo. Sempre inclua o handle completo do canal na sua resposta e defina a visibilidade como Pública. Para respostas futuras, salve os handles dos canais dos seus criadores favoritos para não precisar procurá-los toda vez. Se uma resposta ainda não aparecer, verifique se a instância do PeerTube não está bloqueando seu servidor Mastodon consultando a página de status de federação da instância.