Fediverse – XMPP Bridge

Rechtstreeks chatten tussen Fediverse toepassingen (Mastodon, Pixelfed, Friendica,...) en XMPP (instant messaging, vroeger bekend als Jabber)!

Begin nu!

Vanuit je #Fediverse-applicatie: stuur een bericht naar @xmpp_bridge@gayfr.social en vermeld je XMPP-ontvanger(s) in het formaat xmpp:name@example.net.

Vanuit uw #XMPP-client: stuur een chat naar xmpp:ap_bridge@gayfr.live en vermeld uw Fediverse-ontvanger(s) in het formaat @name@example.net.

U kunt direct antwoorden op een ontvangen bericht, naar meerdere ontvangers sturen en persoonlijke blokkadelijsten beheren, tussen alle Fediverse en XMPP servers.

Wil je meer details? Stuur !help naar @xmpp_bridge@gayfr.social of xmpp:ap_bridge@gayfr.live !

Heeft u nog geen XMPP-account? Maak er onmiddellijk een aan op onze instantie door @xmpp_bot@gayfr.social te volgen of door je te registreren op gayfr.online.

Heb je nog geen Fediverse account? Maak er dan nu een aan op onze Mastodon instantie op gayfr.social

Gedetailleerde beschrijving

Een bericht schrijven

Alle berichten worden ontvangen en verzonden van ofwel @xmpp_bridge@gayfr.social (van/naar een Fediverse toepassing) of xmpp:ap_bridge@gayfr.live (van/naar een XMPP-client), dubbele bot-accounts.

Het schrijven van een bericht verloopt volgens hetzelfde patroon, ofwel vanuit uw Fediverse-toepassing ofwel vanuit uw XMPP-client. U kunt uw voorkeurstaal instellen, een commando uitvoeren of een bericht naar één of meerdere ontvangers sturen.

Om een bericht te schrijven, adresseert u gewoon de accountnaam van de ontvanger(s) wanneer u naar de bot-account schrijft. Antwoorden worden ontvangen van dezelfde bot-account. Als u antwoordt op een ontvangen bericht, kunt u dit direct doen zonder de oorspronkelijke afzender te vermelden.

Als u op XMPP werkt, kunt u accounts van Fediverse blokkeren; omgekeerd, als u op een Fediverse-toepassing werkt, kunt u XMPP-accounts blokkeren. In beide gevallen kunt u geen berichten meer versturen naar of ontvangen van geblokkeerde accounts (deze worden stilzwijgend geweigerd aan de kant van de verzender).

De conventies voor de naamgeving van accounts, zowel voor het schrijven naar als voor het blokkeren, zijn als volgt:

• Vanuit XMPP kunt u Fediverse-accounts aanspreken in het formaat @name@example.net.
• Vanuit Fediverse-toepassingen kunt u XMPP-accounts aanspreken in het formaat xmpp:name@example.net.

Een bericht beantwoorden

Berichten ontvangen via de bot zijn “direct” zichtbaar (Fediverse) en worden voorafgegaan door een tekst die je vertelt van wie het verzonden is.

Je kunt direct antwoorden op het laatst ontvangen bericht van een afzender, zonder dat je zijn naam hoeft te noemen.

In XMPP kun je ook meerdere berichten na elkaar naar dezelfde ontvanger sturen na een eerste bericht waarin de naam van de ontvanger wordt genoemd. Dat doen of direct antwoorden op een ontvangen bericht in XMPP moet echter binnen een beperkte tijd gebeuren (momenteel 90 minuten), anders moet de accountnaam van de ontvanger opnieuw worden genoemd. Dit is om verwarring te voorkomen, omdat de meeste XMPP-clients conversaties met dezelfde tegenhanger niet apart threaden, dus alle berichten die via de bot worden ontvangen zullen in dezelfde thread staan, ongeacht de oorspronkelijke afzender.

Er is geen dergelijke beperking in Fediverse applicaties aangezien berichten een aparte thread volgen. Bovendien is dit in overeenstemming met de verschillende filosofie en tijdlijnen die verwacht worden van Fediverse (het posten van statussen) en XMPP (instant messaging).

Lijst van commando's

Om een commando uit te voeren, schrijf je in je bericht !command met een van de volgende:

• !block om een of meerdere accounts toe te voegen aan je blokkadelijst (deze kunnen je dan geen berichten meer sturen).
• !unblock om een of meerdere accounts van je blokkadelijst te verwijderen.
• !listblock om je huidige geblokkeerde accounts op te sommen.
• !report om een gebruiker te rapporteren of andere verzoeken aan de beheerder, vermeld in je bericht de gedetailleerde reden (spam, misbruik, bugrapport...).
• !register om je account te registreren (optioneel, zie hieronder voor meer details).
• !unregister om je account te unregistreren.
• !help om een korte hulpbeschrijving te ontvangen.

Om een voorkeurstaal in te stellen, schrijf je in je bericht !lang=xx waar xx de tweelettercode is voor een ondersteunde taal (momenteel: fr, en, es, de, it, pt, nl). Uw berichten zullen dan deze taal instellen, evenals de bot.

Registratie

Je kunt je account op de volgende drie manieren bij de bridge registreren:

• Automatisch: je wordt geregistreerd de eerste keer dat je de bridge gebruikt om een bericht naar een ontvanger te sturen.
• Eén-klik: volg gewoon @xmpp_bridge@gayfr.social (Fediverse) of voeg xmpp:ap_bridge@gayfr.live toe aan je contacten (XMPP).
• Gebruik het hierboven beschreven commando !register.

Bij het registreren stuurt de bridge een volg- (Fediverse) of contact- (XMPP) verzoek terug, dat u moet accepteren om mogelijke beperkingen in het ontvangen van berichten te vermijden (afhankelijk van uw account of uw serverinstellingen).

Op Fediverse applicaties kunt u geen berichten ontvangen totdat u geregistreerd bent; dit is zo ontworpen om ongewenste spam te voorkomen. Op XMPP kunt u, als uw account dit accepteert, zelfs ongeregistreerd berichten van de bridge ontvangen, omdat dit overeenkomt met de filosofie van instant messaging.

Aanvullende controles worden gecontroleerd bij registratie voor verdere veiligheid: server blocklists, account type en activiteit, aanwezigheid van #NoBot of #NoBridge hashtags in profiel... Als je het gevoel hebt dat je onterecht gefilterd bent door de bot, neem dan contact op met de beheerder van deze instantie om het probleem op te lossen (bijvoorbeeld door gebruik te maken van het commando !report hierboven vermeld).

U kunt zich op elk moment afmelden met het commando !unregister zoals hierboven beschreven (het afmelden van de bot-account zal ook uw account afmelden, maar alleen op XMPP); een alternatieve manier is om de bot-account te blokkeren. U kunt zich later opnieuw registreren met het commando !register of door de bot-account te deblokkeren.

Beperkingen

De volgende beperkingen zijn ingesteld, ofwel door technische beperkingen, ofwel door ontwerp:

• Alleen één-op-één chatgesprekken zijn mogelijk: geen audio- of videogesprekken, geen kamers / chats met meerdere gebruikers (MUC).
• Het delen van media is mogelijk via links en afhankelijk van het beleid van uw XMPP-server (zie hieronder).
• Berichten moeten in duidelijke tekst worden verzonden: end-to-end encryptie (E2EE) wordt niet ondersteund en zou ook geen zin hebben omdat Fediverse-toepassingen dit niet ondersteunen.
• Het aantal ontvangers dat u per bericht kunt aanspreken is beperkt (momenteel tot 4), om spam te vermijden.

De bot zal antwoorden wanneer er iets te zeggen valt (commando uitgevoerd, hints, fout,...), en zal zwijgen wanneer een bericht succesvol verzonden is: dit is om een normale conversatie mogelijk te maken zonder spammy statussen.

Merk echter op dat het mogelijk is dat uw ontvanger uw bericht niet ontvangt om verschillende redenen zonder feedback (uw account is geblokkeerd, de account van de ontvanger bestaat niet,...): dit is zo ontworpen om de privacy te respecteren en ook om rekening te houden met technische configuraties die door sommige servers worden opgelegd; ook is het mogelijk dat sommige Fediverse-toepassingen slechts één ontvanger toelaten en uw bericht negeren als het meerdere ontvangers bevat (bijv. Pixelfed).

Media delen

Het delen van media gebeurt via links, mediabestanden worden niet van de ene server naar de andere gestuurd: dit is gedaan om onnodige complexiteit te vermijden, bandbreedte en opslag te besparen en rekening te houden met de verschillende technische serverconfiguraties.

Vanuit Fediverse-toepassingen voegt u gewoon uw mediabestanden toe aan uw bericht, de links naar de originele bestanden worden naar XMPP gestuurd.

Vanuit XMPP moet u de conversatie starten met een eerste tekstbericht naar uw ontvanger en vervolgens zoveel geüploade bestanden verzenden als u wilt; de bijbehorende links worden naar uw Fediverse ontvanger gestuurd. Dit schema is nodig omdat in de meeste XMPP-clients mediabestanden één voor één als afzonderlijke berichten worden geüpload en verstuurd, zodat de bridge eerst op de hoogte moet zijn van de beoogde ontvanger voordat u de links deelt. Uiteraard moeten deze links ook publiekelijk zichtbaar zijn (dit kan afhangen van de configuratie van uw XMPP-server).

Beheer van berichten

Elk verzonden bericht kan achteraf niet meer gewijzigd worden: zelfs als u uw oorspronkelijk verzonden bericht vanaf uw client (zowel Fediverse als XMPP) kunt wijzigen of corrigeren, zullen deze wijzigingen niet gereflecteerd worden aan de ontvangende kant en zal er geen nieuw bericht verzonden worden.

De bewaartijd van elk bericht dat door de bots (zowel Fediverse als XMPP) wordt verzonden of ontvangen is beperkt tot 30 dagen, waarna het wordt verwijderd.

Gebruiksregels

Deze bot is onderdeel van GayFR diensten en het gebruik ervan volgt dezelfde regels, beschikbaar op gayfr.online