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, voir la section “ Se connecter au système Android ”
• 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

1. Dans le cas de modifications mineures, sur Github
   1. Mettre à jour le paquet Upstream.
      1. Modifier les sources des fichiers dans “conf/xxx.src” pour que le paquet aille chercher les nouvelles sources automatiquement.
         1. Changer l'URL de la source
         2. Le Checksum SHA 256
         3. La valeur SUM correspondante
      2. rmq: le paquet yunohost télécharge les sources du paquet upstream (synapse, mautrix_whatsapp,..).
   2. Mettre à jour le fichier “conf/config.yaml ”
      1. En comparant les deux versions, via le lien suivant : https://github.com/mautrix/whatsapp/compare/v0.2.4...v0.3.0 , en prenant soin de vérifier les deux versions concernées.
      2. Le but est de conserver les paramètres du paquet Yunohost (ENCRYPTION,…) en mettant à jour les lignes concernées par les nouvelles mises à jour.
   3. Modifier le numéro de version dans le “manifest.json” du paquet concerné.

1. Se connecter à l'hôte qui fait tourner la VM: hwhost-1 ou -2
2. si lsvps | grep lineageos n'indique pas running, Démarrer la VM : gnt-instance start lineageos
3. Créer un pont ssh entre un port de la VM Android WhatsApp de l'infrastructure et votre PC : ssh -L 5001:127.0.0.1:11020 -N -f -p 2222 nomutilisateur@hwhost-1.arn-fai.net
4. Installer Tight VNC (vncviewer)
5. Lancer VNC : vncviewer localhost:5001
6. Rentrer dans l'app Whatsapp et vérifier que tout roule
   1. base de mdp sans-nuage.kdbx nécessaire
   2. Entrer le mdp pour déverouiller lineageOS, attention à la casse. Parfois il faut cliquer avec le clavier virtuel Android plutot qu'utiliser le clavier pour que le mdp passe.
   3. L'app WA est protégée contre l'ouverture, il faut cliquer sur une notification ou aller dans Aurora Store pour l'ouvrir
   4. puis rentrer le schéma pour déverrouiller l'app
   5. vérifier dans Aurora Store que l'app WhatsApp est à jour
   6. vérifier dans l'app WA que le Bridge apparaît dans les appareils connectés. Si non, les ennuis commencent :D

⇒ Voir à partir du point 7. de la section “Déployement VM LineageOS/WhatsApp sur l'infra”