Outils pour utilisateurs

Outils du site


documentation:sans-nuage:whatsappbridge

Ceci est une ancienne révision du document !


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 :

Applications Yunohost
  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)
Documentation
  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

Fonctionnement

  • 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.

Maintenance

  • 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

Mettre à jour les paquets YunoHost des bridges

  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é.

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

documentation/sans-nuage/whatsappbridge.1651398978.txt.gz · Dernière modification : 2022/05/01 11:56 de optogram