Différences

Ci-dessous, les différences entre deux révisions de la page.

--- documentation:sans-nuage:whatsappbridge [2022/05/01 11:46] – [Maintenance du Bridge WhatsApp] optogram
+++ documentation:sans-nuage:whatsappbridge [2022/05/01 11:59] – [Connexion à la VM LineageOS et l'app WhatsApp] optogram
@@ Ligne 1: / Ligne 1: @@
-======  Créer et maintenir son bridge Whatsapp sur une instance Yunohost  ======
+=====  Créer et maintenir son bridge Whatsapp sur une instance Yunohost  =====
 Pour gérer votre bridge Whatsapp sur votre instance Yunohost, voici ce dont vous aurez besoin :
@@ Ligne 15: / Ligne 15: @@
   - Documentation utilisateur (cette doc) : https://wiki.arn-fai.net/documentation:sans-nuage:whatsapp
-======  Maintenance du Bridge WhatsApp  ======
+=====  Fonctionnement  =====
-- Le bridge est basé sur Whatsapp Web, une page web permettant de discuter via navigateur sur 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.
+  * //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.//
-- L'application peut être maintenue sur une machine virtuelle Android.
+  * Mais, pour éviter l'utilisation d'un téléphone, il est possible d'utiliser l'application sur une machine virtuelle Android.
-- Si le bridge est bien à jour, bien login à l'App whatsapp de la VM et que celle ci est bien à jour, alors
-- Regarder les logs /var/log/mautrix_whatsapp/mautrix_whatsapp.log et /var/log/matrix-synapse/homeserver.log
+===== Maintenance =====
-- Envoyer les erreurs sur le salon de support du bridge whatsapp : https://matrix.to/#/#whatsapp:maunium.net
+  * 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
+===== Mettre à jour les paquets YunoHost des bridges =====
+  - Dans le cas de modifications mineures, sur Github
+    - Mettre à jour le paquet Upstream.
+      - Modifier les sources des fichiers dans "conf/xxx.src" pour que le paquet aille chercher les nouvelles sources automatiquement.
+        - Changer l'URL de la source
+        - Le Checksum SHA 256
+        - La valeur SUM correspondante
+      - rmq: le paquet yunohost télécharge les sources du paquet upstream (synapse, mautrix_whatsapp,..).
+    - Mettre à jour le fichier "conf/config.yaml "
+      - 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.
+      - Le but est de conserver les paramètres du paquet Yunohost (__ENCRYPTION__,...) en mettant à jour les lignes concernées par les nouvelles mises à jour.
+    - Modifier le numéro de version dans le "manifest.json" du paquet concerné.
+Rmq:  les paquets yunohost sont toujours centrés sur 5 scripts, backup, ... etc et donc entre version de yunohost ça peut changer genre upgrade de bullseye.
+    La partie settings:
+il y a la liste des messages autorisés que le bot doit prendre en compte.
+Si tu en mets un en commentaire ça le supprime de la liste des messages autorisés. Permet entre autre de ne pas relayer les messages du bot whatsapp vers signal et vice-versa
+===== Se connecter au système Android =====
+  - Se connecter à l'hôte qui fait tourner la VM
+  - si ''lsvps | grep lineageos'' n'indique pas ''running'', Démarrer la VM : ''gnt-instance start lineageos''
+  - Créer un pont ssh entre un port de la VM Android WhatsApp de l'infrastructure et votre PC
+  - Installer Tight VNC (vncviewer)
+  - Lancer VNC : ''vncviewer localhost:5001''
+  - Rentrer dans l'app Whatsapp et vérifier que tout roule
+    - 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.
+    - L'app  WA est protégée contre l'ouverture, il faut cliquer sur une notification ou aller dans Aurora Store pour l'ouvrir
+    - puis rentrer le schéma pour déverrouiller l'app
+    - vérifier dans Aurora Store que l'app WhatsApp est à jour
+    - 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"