-
chevron_right
Bridge de XMPP para Fediverse - Página de ajuda do utilizador
XMPP/AP Bridge • Il y a 4 jours - 08:58 edit • 7 minutes
Fediverse – Bridge XMPP
Converse diretamente entre aplicações Fediverse (Mastodon, Pixelfed, Friendica,...) e XMPP (mensagens instantâneas, anteriormente conhecido como Jabber)!
Comece agora!
A partir da sua aplicação #Fediverse: envie uma mensagem para @xmpp_bridge@gayfr.social e mencione o(s) seu(s) destinatário(s) XMPP utilizando o formato xmpp:name@example.net
A partir do seu cliente #XMPP: envie uma conversação para xmpp:ap_bridge@gayfr.live e mencione o(s) seu(s) destinatário(s) Fediverse utilizando o formato @name@example.net
Pode responder diretamente a uma mensagem recebida, enviar para vários destinatários e gerir listas de bloqueio pessoais, entre qualquer servidor Fediverse e XMPP.
Quer mais pormenores? Basta enviar !help
para @xmpp_bridge@gayfr.social ou xmpp:ap_bridge@gayfr.live !
Ainda não tem uma conta XMPP? Crie uma imediatamente na nossa instância, seguindo @xmpp_bot@gayfr.social ou registando-se em gayfr.online
Ainda não tem uma conta Fediverse? Crie uma agora na nossa instância Mastodon em gayfr.social
Descrição pormenorizada
Escrever uma mensagem
Todas as mensagens são recebidas e enviadas a partir de @xmpp_bridge@gayfr.social (de/para uma aplicação Fediverse) ou xmpp:ap_bridge@gayfr.live (de/para um cliente XMPP), contas de bots gémeos.
A escrita de uma mensagem segue o mesmo padrão, quer a partir da sua aplicação Fediverse quer a partir do seu cliente XMPP. Pode definir o seu idioma preferido, executar um comando ou enviar uma mensagem para um ou vários destinatários.
Para escrever uma mensagem, basta endereçar o(s) nome(s) da(s) conta(s) do(s) destinatário(s) ao escrever para a conta do bot. As respostas serão recebidas a partir dessa mesma conta bot. Se estiver a responder a uma mensagem recebida, pode fazê-lo diretamente sem ter de mencionar o remetente original.
Se estiveres no XMPP, podes bloquear contas do Fediverse; inversamente, se estiveres numa aplicação do Fediverse, podes bloquear contas XMPP. Em ambos os casos, deixará de poder enviar ou receber qualquer mensagem de contas bloqueadas (estas serão silenciosamente rejeitadas do lado do remetente).
As convenções de nomeação de contas, tanto para escrever como para bloquear, são as seguintes:
- A partir do XMPP, pode dirigir-se às contas do Fediverse utilizando o formato @name@example.net
- A partir de aplicações Fediverse, pode dirigir-se a contas XMPP utilizando o formato xmpp:name@example.net
Responder a uma mensagem
As mensagens recebidas através do bot têm visibilidade “direta” (Fediverse) e são precedidas de um texto que indica quem as enviou.
Pode responder diretamente à última mensagem recebida de um remetente, sem ter de mencionar o seu nome.
No XMPP, também é possível enviar várias mensagens seguidas ao mesmo destinatário depois de uma primeira mensagem inicial com o seu nome. No entanto, fazer isso ou responder diretamente a uma mensagem recebida em XMPP deve ser feito dentro de um período de tempo limitado (atualmente 90 minutos), caso contrário o nome da conta do destinatário tem de ser mencionado novamente. Isto é para evitar confusões, uma vez que a maioria dos clientes XMPP não encadeia separadamente as conversas com a mesma contraparte, pelo que todas as mensagens recebidas através do bot estarão no mesmo encadeamento, independentemente do remetente original.
Não existe essa limitação nas aplicações Fediverse, uma vez que as mensagens seguem uma thread separada. Para além disso, isto está em conformidade com a filosofia e os prazos diferentes esperados do Fediverse (publicação de estados) e do XMPP (mensagens instantâneas).
Lista de comandos
Para executar um comando, escreva na sua mensagem !command
com uma das seguintes opções:
!block
para adicionar uma ou várias contas à sua lista de bloqueio (essas contas deixarão de poder enviar-lhe mensagens).!unblock
para remover uma ou várias contas da sua lista de bloqueio.!listblock
para listar as contas atualmente bloqueadas.!report
para denunciar um utilizador ou fazer outros pedidos ao administrador. Inclua na sua mensagem o motivo detalhado (spam, abuso, relatório de bug...).!register
para registar a sua conta (opcional, veja abaixo para mais detalhes).!unregister
para cancelar o registo da sua conta.!help
para receber uma breve descrição da ajuda.
Para definir um idioma preferido, escreva na sua mensagem !lang=xx
em que xx
é o código de duas letras para um idioma suportado (atualmente: fr, en, es, de, it, pt, nl). As suas mensagens irão então definir esta língua definida, bem como o bot.
Registo
Pode, opcionalmente, registar a sua conta na Bridge, das três formas seguintes:
- Automático: será registado na primeira vez que utilizar a bridge para enviar uma mensagem a um destinatário.
- Um clique: basta seguir @xmpp_bridge@gayfr.social (Fediverse) ou adicionar xmpp:ap_bridge@gayfr.live aos seus contactos (XMPP).
- Utilize o comando
!register
descrito acima.
Ao registar-se, a Bridge enviará um pedido de seguimento (Fediverse) ou de contacto (XMPP), que deve aceitar para evitar potenciais limitações na receção de mensagens (dependendo da sua conta ou das definições do seu servidor).
Nas aplicações Fediverse, não poderá receber qualquer mensagem até estar registado; isto foi concebido para evitar spam indesejado. No XMPP, se a sua conta o aceitar, pode receber mensagens da Bridge mesmo sem estar registado, uma vez que isto se enquadra na filosofia das mensagens instantâneas.
Para maior segurança, são verificados controlos adicionais aquando do registo: listas de bloqueio de servidores, tipo de conta e atividade, presença de hashtags #NoBot ou #NoBridge no perfil... Se considerar que foi injustamente filtrado pelo bot, contacte o administrador desta instância para resolver o problema (por exemplo, utilizando o comando !report
mencionado acima).
Pode anular o registo em qualquer altura utilizando o comando !unregister
descrito acima (deixar de seguir a conta do bot também anulará o registo da sua conta, mas apenas no XMPP); uma forma alternativa é bloquear a conta do bot. Pode registar-se novamente mais tarde usando o comando !register
ou desbloqueando a conta do bot.
Limitações
As seguintes limitações são estabelecidas, quer devido a constrangimentos técnicos, quer por conceção:
- Só são possíveis conversas de chat um-para-um: não são possíveis chamadas de áudio ou vídeo, nem salas / chats multi-utilizador (MUC).
- A partilha de multimédia é possível utilizando ligações e dependendo das políticas do servidor XMPP (ver abaixo).
- As mensagens devem ser enviadas em texto claro: a encriptação de ponta a ponta (E2EE) não é suportada e não faria sentido, uma vez que as aplicações do Fediverse não a suportam.
- O número de destinatários que pode endereçar em cada mensagem é limitado (atualmente 4), para evitar spam.
O bot responder-te-á quando houver algo a dizer (comando executado, dicas, erro,...), e permanecerá em silêncio quando uma mensagem for enviada com sucesso: isto é para permitir conversas normais sem estados intermédios de spam.
No entanto, por favor note que o seu destinatário pode não receber a sua mensagem por diferentes razões possíveis e sem feedback (a sua conta está bloqueada, a conta do destinatário não existe,...): isto é intencional para respeitar a privacidade, e também para ter em conta as configurações técnicas impostas por alguns servidores; também, algumas aplicações Fediverse podem permitir apenas um destinatário e descartar a sua mensagem se esta contiver vários destinatários (por exemplo, Pixelfed).
Partilha de ficheiros multimédia
A partilha de ficheiros multimédia é feita através de links, os ficheiros multimédia não serão enviados de um servidor para os outros: isto é feito para evitar complexidade desnecessária, poupar largura de banda e armazenamento, e ter em conta as diferentes configurações técnicas dos servidores.
A partir das aplicações Fediverse, basta anexar os seus ficheiros multimédia à sua mensagem; as ligações para os ficheiros originais serão enviadas para o XMPP.
A partir do XMPP, terá de iniciar a conversa com uma primeira mensagem de texto para o destinatário e, em seguida, enviar tantos ficheiros carregados quantos quiser; as ligações correspondentes serão enviadas para o destinatário do Fediverse. Este esquema é necessário porque, na maioria dos clientes XMPP, os ficheiros multimédia são carregados e enviados um a um como mensagens separadas, pelo que a ponte tem de ser informada do destinatário pretendido antes de partilhar as ligações. Obviamente, estas ligações também têm de ser visíveis publicamente (isto pode depender da configuração do seu servidor XMPP).
Gestão de mensagens
Qualquer mensagem enviada não pode ser modificada posteriormente: mesmo que possa modificar ou corrigir a mensagem original enviada a partir do seu cliente (tanto Fediverse como XMPP), estas alterações não serão reflectidas no destinatário e não será enviada uma nova mensagem.
O período de retenção de qualquer mensagem enviada ou recebida pelos bots (tanto Fediverse como XMPP) é limitado a 30 dias, após os quais será apagada.
Regras de utilização
Este bot faz parte dos serviços GayFR e a sua utilização segue as mesmas regras, disponíveis em gayfr.online