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

Configuration du robot-relai mautrix-whatsapp

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.
documentation/sans-nuage/whatsappbridge.1651398958.txt.gz · Dernière modification : 2022/05/01 11:55 de optogram