Matrix-WhatsApp bridge
communication
Current version: 0.10.9~ynh1
Potential alternative to: Whatsapp
A puppeting bridge between Matrix and WhatsApp packaged as a YunoHost service. Messages, media and notifications are bridged between a WhatsApp user and a matrix user. With the RelayBot login option, the matrix user can invite other matrix user in a bridged WhatsApp room, such that even people without a WhatsApp account can participate to WhatsApp group conversations. The "Mautrix-WhatsApp" bridge consists in a synapse app service and relies on postgresql (mysql also available). Therefore, Synapse for YunoHost should be installed beforehand.
** Attention: always backup and restore the Yunohost matrix_synapse et mautrix_whatsapp apps together!**
Important infos before installing
Multi-user support
- Bot users are not related to Yunohost users. Any Matrix account or Synapse server autorized in the configuration of the bridge can invite/use the bot.
- The WhatsApp bot is a local Matrix-Synapse user, but accessible through federation (synapse public or private).
- Several WhatsApp and Matrix users can be bridged with one bridge, each user has its own bot administration room.
- If several bot users are in a same WhatsApp group, only one Matrix room will be created by the bridge.
- See https://github.com/YunoHost-Apps/synapse_ynh#multi-users-support
Limitations
- Audio/Video calls are not bridged yet.
- If WhatsApp loses connection, e.g. the phone is set in flight mode or push notifications are deactivated, the bot has sometimes to be restarted manually by sending
!wa reconnnectin the Matrix administration room. - WhatsApp needs to get presence from the official app every two weeks at least, so bridge will send a reminder in the administration room.
Additional information
-
It is recommended to install WhatsApp on a virtual android running on a server, see upstream wiki Android-VM-Setup page More information on the documentation page: https://docs.mau.fi/bridges/go/whatsapp/index.html
-
To test communication between the App Service and Matrix-Synapse on a VM (e.g. with domain name: synapse.vm), you must install a certificate:
echo | openssl s_client -showcerts -servername synapse.vm -connect synapse.vm:443 2>/dev/null | awk '/-----BEGIN CERTIFICATE-----/, /-----END CERTIFICATE-----/' >> /usr/local/share/ca-certificates/synapse.vm.crt
update-ca-certificates
Miscellaneous information
- Matrix room (matrix bridges in YunoHost): #mautrix_yunohost:matrix.fdn.fr
- Matrix room (upstream app): #whatsapp:maunium.net
In case you need to upload your logs somewhere, be aware that they contain your contacts and your phone numbers. Strip them out with:
| sed -r 's/[0-9]{10,}/📞/g' - "Mautrix-WhatsApp" bridge is based on the Rhymen/go-whatsapp implementation of the sigalor/whatsapp-web-reveng project.