L'application Wazo Mobile utilise les Push Notifications pour permettre de recevoir des appels et des notifications texte lorsque l'application mobile n'est pas au premier plan.
Contexte :
Auparavant, vous deviez configurer cela via l'API Google Firebase cela est désormais terminé.
Toutefois, cette API étant obsolète (arrêt définitif en Juin 2024), Wazo dispose désormais de son propre outil de Push Notifications pour les mobiles sous Android.
Limitations :
- Votre stack doit être en version >= à 23.17 (Documentation Mettre à jour de votre E-UC Stack)
- Actions à réaliser sur chaque sites (tenants) disposant d'external authentification de type Mobile
Migration manuelle
Dans le site (tenant) concerné, accédez au menu Paramètres > Identifications > Auth. Externe puis supprimez la source de type "mobile".
Nous vous conseillons de déconnecter/reconnecter les utilisateurs de leur application Wazo Mobile.
Migration automatique
Installez le plugin de stack qui permettra de modifier la configuration d'authentification externe sur l'ensemble des Tenants de votre Stack.
Pré-requis:
-
Pour rappel la Stack doit être au minimum en 23.17.
-
Le paquet
wazo-plugind-cli
doit être installé.
Vous pouvez vérifier qu'il soit bien installé avec la commande wazo-plugind-cli --help
s'il n'y a pas d'erreur c'est qu'il est installé.
Sinon vous pouvez l'installer avec la commande:apt install wazo-plugind-cli
Une fois cela fait vous pouvez installer le plugin qui va exécuter la modification du push
Information complémentaire:
Attention !!
Les utilisateurs mobiles devront redémarrer leur application mobile pour que la migration soit complète et que les notifications push et les appels fonctionnent correctement.
Les appels reçus après la migration et avant le démarrage de l'application seront perdus.
Si l'application mobile est déjà active et au premier plan au moment de la migration, l'application devra être fermée et ouverte à nouveau pour que les notifications push et les appels fonctionnent.
Ce plugin enverra une notification à chaque utilisateur mobile sur le serveur, avant d'effectuer la migration. La migration est effectuée tenant par tenant.
Installation du plugin
wazo-plugind-cli -c "install git https://github.com/wazo-communication/wazo-android-push-proxy-migration-plugin"
Pendant l'exécution du plugin vous pouvez vérifier les logs qui se trouvent dans: /var/log/wazo-android-push-proxy-migration.log
Aucun service ne sera redémarré par l'installation de ce plugin.
L'installation peut prendre un certain temps pour les Stack avec beaucoup d'utilisateurs ou de tenant, compter environ 1 minute pour chaque 1500 tenant, plus 1 minute pour chaque 200 utilisateurs, c'est-à-dire environ 11 minutes pour 2000 utilisateurs dans 1500 tenant.
Retirer le plugin de la Stack
Une fois la migration effectuée, nous vous conseillons de retirer le plugin qui ne sera d'aucune utilité sur la Stack. Cette action n'aura pas d'impact sur la configuration.
wazo-plugind-cli -c "uninstall wazocommunication/wazo-android-push-proxy-migration"