Notifications push

Les notifications push vous préviennent quand un agent a besoin de vous ou a terminé, alors qu’OAR n’est pas ouvert devant vous : une question attend, un turn s’est terminé, un plan est prêt. Elles sont désactivées par défaut et vous les activez séparément sur chaque appareil.

Votre propre relais les envoie à vos appareils via le service push de l’éditeur de votre navigateur, avec la bibliothèque web push standard et ses propres clés VAPID. Aucun serveur OAR n’intervient. Le relais crée les clés à son premier démarrage et les garde dans sa base de données, si bien qu’elles survivent aux redémarrages. Le texte d’une notification se limite à ce que vous autorisez sous Ce que montre une notification : par défaut, une ligne générique sans aucun texte de la conversation.

Ce qu’il vous faut #

• Une page sécurisée. Ouvrez OAR en HTTPS, ou sur localhost. Sur toute autre adresse, le navigateur ne propose pas le push, et les réglages Notifications indiquent « Push requires a secure context. Open the app over HTTPS (or localhost) to enable notifications on this device. » Voir Installer comme app pour la même règle.
• Un navigateur avec le web push. Il lui faut les service workers, la Push API et la Notification API. Sinon, les réglages indiquent « This browser does not support Web Push notifications. » (ou « ...service workers, which push notifications require. »).
• La même chose sur tous les systèmes. OAR vérifie ces fonctions du navigateur et rien d’autre ; il n’a pas de règle propre à iOS. Si le navigateur de votre iPhone ou iPad ne les propose pas, les réglages Notifications le disent.

L’activer #

Faites-le sur chaque appareil qui doit recevoir des notifications. Le réglage est enregistré par appareil : l’activer dans le navigateur de votre portable ne fait rien pour votre téléphone.

1. Ouvrez Settings → Notifications (Réglages → Notifications).
2. Activez Enable push notifications on this device (Activer les notifications push sur cet appareil).
3. Autorisez les notifications quand le navigateur le demande. La demande n’apparaît qu’après votre clic sur l’interrupteur, jamais au chargement de la page.
4. La ligne d’état indique « Push notifications are enabled on this device. They are only sent while no device has the app open. » et les autres contrôles se déverrouillent. (La règle exacte est qu’aucun appareil n’affiche OAR au premier plan ; voir Quand aucune notification n’est envoyée.)
5. Choisissez les événements et ce que montrent les notifications (ci-dessous).

Il n’y a pas de bouton de notification de test. Pour vérifier que cela fonctionne, laissez OAR en arrière-plan (ou fermez son onglet) et laissez un court turn se terminer.

Désactiver de nouveau l’interrupteur garde l’appareil dans la liste, marqué disabled (désactivé), et cesse de lui envoyer des notifications. Le réactiver est immédiat.

La liste des appareils #

En bas de l’onglet, Devices (Appareils) liste tous les appareils abonnés sur ce relais, le dernier modifié en premier. Une ligne affiche :

• le nom de l’appareil (par exemple Android Chrome), déduit du navigateur et du système, ou Unnamed device (Appareil sans nom), avec (this device) (cet appareil) sur le vôtre et disabled là où il est désactivé ;
• Last delivery (Dernière remise) : quand une notification l’a atteint pour la dernière fois, ou never (jamais), plus la dernière erreur si la dernière tentative a échoué.

Rename (Renommer) demande un nouveau nom (jusqu’à 80 caractères). Revoke (Révoquer) demande une confirmation, retire l’appareil du relais et, sur l’appareil que vous utilisez, retire aussi son abonnement du navigateur. Un autre appareil que vous révoquez d’ici cesse aussitôt de recevoir, mais son navigateur ne peut pas en être informé d’ici : le navigateur garde son propre abonnement jusqu’à ce que vous le supprimiez là-bas. Sur cet appareil, ouvrez Settings → Notifications ; l’interrupteur apparaît désactivé. Réactivez-le pour recevoir des notifications, ou retirez la permission de notification du site dans les réglages de site de ce navigateur pour supprimer l’abonnement pour de bon.

Les événements #

Chaque événement a son propre interrupteur sous Notify about (Notifier pour). Les interrupteurs appartiennent à l’appareil : votre téléphone et votre portable peuvent donc différer.

Quand aucune notification n’est envoyée #

• Tant qu’un appareil a OAR au premier plan. Si l’un de vos appareils affiche OAR à l’écran, rien n’est envoyé à aucun appareil. Une page visible le signale au relais toutes les 30 secondes, et le relais considère un appareil comme actif pendant 90 secondes après son dernier signalement. Une page masquée le signale aussitôt. Si le relais ne peut pas le savoir, il n’envoie rien.
• Pour un turn qu’un autre agent a démarré. Quand un agent sur un autre relais (ou une session démarrée par un agent) envoie un prompt à une session, ce turn n’envoie ni Turn completed ni Turn failed : c’est l’agent qui attend, et il vous rend compte lui-même. Voir messages entre agents. Les questions vous parviennent toujours.
• Pour un turn qui répond à des événements du relais. Un turn démarré par un événement du relais n’envoie ni l’une ni l’autre, pour la même raison ; un agent qui surveille et répond à des événements envoie lui-même une notification quand quelque chose compte. Rien ne change pour les questions.
• Les événements que vous avez désactivés sur cet appareil, ou un appareil désactivé.

Une notification qui ne peut pas être remise tout de suite est conservée par le service push jusqu’à 12 heures.

Ce que montre une notification #

Trois réglages, eux aussi par appareil, décident de la part de la conversation qui quitte le relais.

Avec Message preview sur None (generic text), le corps est une ligne fixe :

Avec un aperçu, le corps est le texte de la question, la réponse (ou le texte d’erreur d’un turn échoué), ou le titre du tableau de plan. Full text est coupé à 2 000 caractères.

La notification porte aussi quelques identifiants dont l’app a besoin pour ouvrir la bonne conversation (la conversation, la question, le tableau ou le message). Les choix courts d’une question l’accompagnent aussi, quel que soit le réglage d’aperçu, parce qu’ils deviennent les boutons (voir Répondre depuis la notification).

Trois événements ignorent le réglage d’aperçu. CLI went offline affiche toujours sa ligne fixe. Host suspend fired or was dropped affiche toujours son propre message (« All agents finished; the host is suspending now. » ou « Queued host suspend dropped: relay ... »). Queued relay restart waited its maximum time affiche lui aussi toujours son propre message, par exemple « The queued relay restart has waited 30 min for 2 sessions. Restart now, keep waiting or cancel it. ».

Pour plus de confidentialité, laissez le titre et l’aperçu désactivés : rien de vos conversations ne figure alors dans la notification.

Appuyer sur une notification #

Appuyer sur une notification ouvre OAR sur cette conversation (une notification sans conversation, comme CLI offline, ouvre simplement OAR). Si OAR est déjà ouvert dans une fenêtre, cette fenêtre passe au premier plan et affiche la conversation ; sinon, une nouvelle fenêtre s’ouvre. Chaque événement a sa propre notification : elles s’empilent et ne se remplacent pas.

Répondre depuis la notification #

Une notification de question peut porter des boutons pour les choix de la question :

• jusqu’à trois choix, et pas plus de boutons que votre appareil n’en affiche ;
• un choix de plus de 120 caractères n’a pas de bouton, et le libellé d’un bouton est raccourci à 40 caractères (la réponse envoyée est le choix complet) ;
• appuyer sur un bouton envoie cette réponse au relais sans ouvrir OAR, tant que la question attend encore et que le navigateur est connecté au relais.

Si la réponse n’aboutit pas (la question a reçu une réponse ailleurs, a expiré, ou vous êtes hors ligne), l’appui ouvre plutôt la conversation, pour que vous voyiez pourquoi. Voir cartes de question.

Plusieurs appareils, abonnements expirés, nouvelle adresse #

• Plusieurs appareils. Chaque appareil que vous avez activé reçoit chaque notification dont il a activé l’événement. La règle du premier plan s’applique à tous ensemble.
• Un abonnement expiré. Quand le service push signale qu’un abonnement n’existe plus, le relais retire de lui-même l’appareil de la liste. Un appareil qui continue d’échouer pour une autre raison est retiré après 8 envois échoués d’affilée. Réactivez le réglage sur cet appareil pour l’abonner à nouveau.
• Après un changement d’adresse du relais. Un abonnement appartient à la page depuis laquelle vous l’avez activé. Ouvrez OAR à la nouvelle adresse sur chaque appareil et regardez Settings → Notifications : un appareil qui n’y est pas abonné montre l’interrupteur désactivé. L’ancienne entrée reste dans la liste jusqu’à ce que vous la supprimiez avec Revoke ou que le service push la signale disparue. Le relais garde ses clés push d’un redémarrage à l’autre : un redémarrage à la même adresse ne demande donc pas de nouvelle configuration.

Dépannage #

Voir aussi Settings (Réglages) pour la liste des contrôles, et pause à la limite d’utilisation pour la façon dont un turn en pause envoie ses notifications.