Alsace Réseau Neutre

Pour gérer votre bridge Whatsapp sur votre instance Yunohost, voici ce dont vous aurez besoin :

1. Application Synapse : https://github.com/YunoHost-Apps/synapse_ynh (Maintenu par la communauté)
2. Client Element : https://github.com/YunoHost-Apps/element_ynh (Maintenu par la communauté)
3. Bridge Signal : https://github.com/YunoHost-Apps/mautrix_signal_ynh (jusque 03/2022 maintenu par gaut d'ARN (gaut)
4. Bridge Whatsapp : https://github.com/YunoHost-Apps/mautrix_whatsapp_ynh (jusque 03/2022 maintenu par gaut d'ARN (gaut)

1. Documentation de déploiement et maintenance : https://wiki.arn-fai.net/benevoles:procedures:sans-nuage
2. Documentation utilisateur (cette doc) : https://wiki.arn-fai.net/documentation:sans-nuage:whatsapp

• Le bridge est basé sur Whatsapp Web, une page web permettant de discuter via navigateur sur Whatsapp.
• Whatsapp n'autorise pas une connexion principale sur le client web, il est nécessaire de se connecter sur un téléphone régulièrement toutes les 2 semaines afin de maintenir la session web active.
• Mais, pour éviter l'utilisation d'un téléphone, il est possible d'utiliser l'application sur une machine virtuelle Android.

• Se connecter avec le compte robot “@Compte administrateur défini à l'installation” sur le client Element. Vérifier l'état du bridge avec les commandes dans la discussion “WhatsApp Bridge Bot”
• OU Aller sur n'importe quel salon bridgé WhatsApp avec un compte administrateur du bridge
• Taper la commande “!wa ping” pour vérifier l'état de la connexion
• Si la connexion semble problématique, Entrer la commande “!wa reconnect”

Dans le cas d'un échec des commandes !

• Vérifier s'il existe une mise à jour pour le bridge, voir la section “ Mettre à jour les paquets ”
• Vérifier s'il existe une mise à jour de l'application Whatsapp sur le téléphone ou la machine virtuelle
• Si le bridge semble ne plus être connecté à l'application WhatsApp du téléphone ou de la machine virtuelle LineageOS, voir le point suivant

• Si le bridge est à jour, connecté à une application Whatsapp, elle aussi à jour, nous allons chercher de l'aide :
• Regarder les logs /var/log/mautrix_whatsapp/mautrix_whatsapp.log et /var/log/matrix-synapse/homeserver.log
• Envoyer les erreurs sur le salon de support du bridge whatsapp : https://matrix.to/#/#whatsapp:maunium.net

cf. https://github.com/tulir/mautrix-whatsapp/wiki/Relaybot

Prérequis sur l'interface admin de sans-nuage https://sans-nuage.fr/yunohost/admin/ :

• synapse installé sur le domaine matrix.sans-nuage.fr
• element installé sur chat.sans-nuage.fr
• mautrix_whatsapp installé pour l'instance synapse matrix.sans-nuage.fr
• ARN-Messager installé
• Utilisateur arnmessager créé

1. Se connecter sur chat.sans-nuage.fr (Element) avec le compte d'administration des bots mautrix d'ARN mautrix_admin

1. Restart mautrix_whatsapp puis Inviter @whatsappbot:sans-nuage.fr
2. Mautrix répond ``This is the relaybot management room. Send `!wa help` to get a list of commands.``
3. écrire ``!wa login`` dans ce salon
4. whatsappbot envoie un QR-code sous forme d'une image téléchargeable au lien du type https://matrix.sans-nuage.fr/_matrix/media/r0/download/sans-nuage.fr/PCwbjLdvxxxfbZlUAvSADne
5. Flash le QR-code avec la VM whatsapp puis transfère la VM sur l'infra

Autorisation de nouveaux utilisateurs à bridger des salons, càd à “utiliser whatsappbot”. Ajouter une ligne avec niveau d'autorisation 10 dans /opt/yunohost/mautrix_whatsapp/config .yaml

permissions: '*': 5 '@arn:sans-nuage.fr': 100 matrix.fdn.fr: 10 sans-nuage.fr: 10

L'autorisation 100 permet d'administrer le bridge, donc lui envoyer des commandes !wa login, etc.

  You may also want to set allow_user_invite to true so that you can invite more users to portals created by the bridge. The option is not applied retroactively, but you can use !wa set-pl to make yourself admin in existing rooms.