O Mastodon oferece suporte a emojis personalizados que administradores de servidor podem enviar para seus usuários. Esses emojis aparecem no seletor de emoji e podem ser usados em postagens, impulsionamentos e respostas. No entanto, emojis personalizados não aparecem automaticamente em outras instâncias quando um usuário os inclui em uma postagem. O emoji precisa ser federado da instância de origem para a instância de visualização para que outros possam vê-lo corretamente. Este artigo explica como a federação de emojis personalizados funciona e fornece as etapas para garantir que seus emojis fiquem visíveis no fediverso.
Principais Conclusões: Federando Emojis Personalizados Entre Instâncias do Mastodon
- Administração > Configurações do Servidor > Emojis Personalizados: Envie emojis para sua instância para disponibilizá-los aos seus usuários.
- Postar com emoji personalizado: Quando um usuário de outra instância visualiza uma postagem contendo seu emoji personalizado, o emoji é buscado e armazenado em cache nessa instância.
- Emoji remoto no seletor local: Usuários de outras instâncias não podem usar seu emoji personalizado em suas próprias postagens, a menos que o administrador deles o adicione manualmente.
Como Funciona a Federação de Emojis Personalizados no Mastodon
Emojis personalizados no Mastodon são pequenos arquivos de imagem, geralmente no formato PNG. Um administrador envia essas imagens pelo painel de administração e atribui a cada uma um shortcode — um nome como :blobcat: que os usuários digitam para inserir o emoji. Quando um usuário na instância de origem inclui um emoji personalizado em uma postagem, o shortcode do emoji é incluído no conteúdo HTML da postagem. Outras instâncias que recebem a postagem via federação veem o shortcode e tentam buscar a imagem do emoji na instância de origem.
O processo de federação funciona através do ActivityPub, o protocolo que o Mastodon usa para se comunicar entre instâncias. Quando uma instância remota processa uma postagem contendo um emoji personalizado, ela verifica seu próprio cache de emojis. Se o emoji não estiver presente, a instância remota faz uma requisição HTTP à instância de origem para baixar o arquivo do emoji. O emoji é então armazenado no cache da instância remota e exibido na postagem. Esse cache acontece automaticamente e não requer intervenção do administrador na instância remota.
O Que é Federado e O Que Não é
Apenas o arquivo de imagem do emoji e seu shortcode são federados. O emoji não é adicionado ao seletor de emoji da instância remota. Um usuário em outra instância pode ver o emoji em uma postagem, mas não pode usá-lo em suas próprias postagens, a menos que seu administrador o adicione manualmente ao conjunto de emojis local. O emoji também não é pesquisável no seletor de emoji da instância remota. Essa limitação é proposital para evitar que instâncias sejam inundadas com emojis de outros servidores sem controle do administrador.
Etapas para Garantir que Emojis Personalizados Sejam Federados Corretamente
Para tornar os emojis personalizados visíveis para usuários em outras instâncias, a instância de origem deve estar acessível e o emoji deve estar configurado corretamente. Siga estas etapas para verificar e solucionar problemas de federação.
- Envie o emoji personalizado em sua instância
Faça login no painel de administração do Mastodon. Navegue até Administração > Configurações do Servidor > Emojis Personalizados. Clique no botão Enviar e selecione o arquivo de imagem do emoji. Insira um shortcode sem dois pontos — por exemplo, digiteblobcatpara:blobcat:. Clique em Salvar. O emoji agora está disponível para todos os usuários em sua instância. - Poste uma mensagem de teste usando o emoji personalizado
Crie uma nova postagem em sua instância. Abra o seletor de emoji e selecione o emoji personalizado que você enviou. Alternativamente, digite o shortcode manualmente entre dois pontos. Publique a mensagem. Essa mensagem será enviada para seguidores em outras instâncias. - Verifique se sua instância está acessível publicamente
A federação exige que outras instâncias possam fazer requisições HTTP para sua instância. Use uma ferramenta comocurlou um serviço online para verificar se sua instância responde na porta 443. Se sua instância estiver atrás de um firewall ou usar um proxy reverso, certifique-se de que o endpoint de emojis personalizados esteja acessível. A URL do endpoint éhttps://suainstancia.exemplo.com/custom_emoji/. - Verifique se instâncias remotas podem buscar o emoji
Peça a um usuário em outra instância para visualizar sua postagem de teste. Se o emoji aparecer como uma imagem pequena, a federação está funcionando. Se o emoji aparecer como uma imagem quebrada ou o shortcode for exibido como texto simples, a instância remota não conseguiu buscar o emoji. Verifique os logs do servidor para erros relacionados à busca de emojis. - Verifique o tamanho e formato do arquivo do emoji
O Mastodon aceita formatos PNG e GIF. O tamanho máximo do arquivo é 256 KB. Arquivos maiores podem ser rejeitados pelo sistema de upload ou falhar ao carregar em instâncias remotas. Redimensione seu emoji para 48×48 pixels para exibição consistente. Use um editor de imagens para garantir que o arquivo esteja abaixo do limite de tamanho.
Problemas Comuns de Federação e Como Resolvê-los
Emoji Personalizado Aparece como Imagem Quebrada em Instâncias Remotas
Uma imagem quebrada indica que a instância remota não conseguiu baixar o arquivo do emoji. Isso geralmente acontece quando a instância de origem bloqueia requisições de determinadas faixas de IP ou usa um certificado SSL autoassinado. Certifique-se de que seu certificado SSL seja válido e emitido por uma autoridade certificadora confiável. Verifique também se o firewall do seu servidor não bloqueia conexões de entrada de instâncias do fediverso. Consulte os logs do servidor web para erros 403 ou 404 no endpoint de emojis.
Emoji Personalizado Aparece como Shortcode em Texto Simples
Quando uma instância remota exibe o shortcode como texto, significa que a instância não conseguiu resolver o shortcode do emoji para uma imagem. Isso pode ocorrer se a instância remota estiver executando uma versão antiga do Mastodon que não suporta federação de emojis personalizados. Peça ao administrador da instância remota para atualizar o Mastodon para a versão 3.0 ou posterior. Outra causa é que o shortcode do emoji contém caracteres não permitidos — use apenas letras minúsculas, números e underscores.
Usuários Remotos Não Podem Usar Seu Emoji Personalizado em Suas Postagens
Isso é esperado. Emojis personalizados não são adicionados ao seletor de emoji em instâncias remotas. Apenas a instância que enviou o emoji pode oferecê-lo no seletor. Se você quiser que usuários de outra instância usem seu emoji, peça ao administrador dessa instância para adicionar manualmente o emoji ao próprio conjunto de emojis personalizados. Eles podem baixar o arquivo do emoji da sua instância e enviá-lo pelo painel de administração deles.
Federação de Emojis Personalizados do Mastodon vs. Compartilhamento Manual
| Item | Federação Automática | Compartilhamento Manual |
|---|---|---|
| Visibilidade em postagens | Emoji aparece em postagens da instância de origem | Emoji aparece em postagens da instância de origem |
| Disponibilidade no seletor de emoji | Apenas na instância de origem | Em toda instância que adicionar o emoji manualmente |
| Esforço do administrador | Nenhum em instâncias remotas | Administradores remotos devem enviar o emoji |
| Duração do cache | Armazenado em cache até que a instância remota limpe seu cache | Permanente após o envio |
A federação de emojis personalizados é o processo automatizado onde as imagens dos emojis são buscadas e exibidas em postagens em instâncias remotas. O compartilhamento manual exige que administradores enviem o emoji para sua própria instância. A federação oferece conveniência para visualização, mas não para reutilização. O compartilhamento manual dá controle total, mas requer coordenação entre administradores de instâncias.
Conclusão
A federação de emojis personalizados permite que usuários em diferentes instâncias do Mastodon vejam emojis do seu servidor em postagens. O processo é automático assim que você envia o emoji e publica uma mensagem contendo-o. Para solucionar problemas de federação, verifique o certificado SSL do seu servidor, o tamanho do arquivo e a acessibilidade da rede. Para controle avançado, considere configurar um pacote de emojis compartilhado que administradores possam baixar e adicionar às suas próprias instâncias. Essa abordagem dá a usuários remotos a capacidade de usar seus emojis em suas próprias postagens, mantendo a administração dentro de cada instância.