ブラウザのプッシュ通知を有効にする

ブラウザのプッシュ通知には2つの独立した許可が必要です。ブラウザで通知を許可し、dosyaでそのブラウザをサインイン中のアカウントに登録する必要があります。配信にはさらにブラウザのプッシュ通知の全体スイッチ、対象のイベントグループ、プッシュに対応するカタログ項目が必要です。

要件

サービスワーカーとPushManagerの両方を利用できるブラウザで、ウェブアプリにサインインしてください。通常のブラウザ動作では、サービスワーカーに安全なコンテキストが必要です。アカウントのプランとワークスペースのロールは登録に影響しません。

ブラウザがすでにdosyaの通知をブロックしている場合、許可を求める画面が再表示されないことがあります。まずブラウザ設定でサイトの権限を変更し、ウェブアプリに戻ってください。

手順

1. 通知を受信したいブラウザとアカウントでProfile → Notificationsを開いてください。
2. 配信チャンネルでブラウザのプッシュ通知をオンにしてください。このスイッチは配信を制御しますが、ブラウザの登録情報自体は作成しません。
3. ブラウザの通知を有効化を選択してください。
4. ブラウザの確認画面で許可を選択してください。
5. dosyaがアプリケーションキーを取得し、ユーザーに表示されるプッシュ通知の登録情報を作成して、エンドポイントをアカウントに登録するまで待ってください。
6. 成功を示す通知ブラウザの通知を有効にしましたを確認してください。
7. 必要なイベントグループを有効にしたまま、プッシュに対応するカタログ項目の影響のないイベントを1件発生させてください。

登録時には、エンドポイント、暗号化鍵、ブラウザのユーザーエージェントの先頭80文字までが端末名として保存されます。同じアカウントに同じエンドポイントを再登録すると、鍵が更新され、以前の取り消しが解除されます。別のアカウントに属するエンドポイントは再割り当てされず、拒否されます。

許可と配信の問題

• 権限がありませんと「Allow notifications in your browser settings」が表示される場合、許可の結果がgrantedではなかったことを意味します。
• 対応していませんと「This browser can’t receive web push」が表示される場合、サービスワーカーまたはPushManagerに対応していないことを意味します。
• 公開プッシュキーが設定されていないサーバーはPush not configuredを返します。必須項目の不足、未対応のエンドポイントホスト、別のアカウントに紐づくエンドポイントによっても登録ができない場合があります。

dosyaはウェブプッシュメッセージを有効期間60秒で送信します。配信はベストエフォートです。アプリを閉じても対応していますが、プッシュサービスやオフラインの端末がこの短い期間内に受信できないことがあります。プッシュプロバイダーから404または410の応答があると、保存された登録情報は自動的に取り消されます。その後、再び有効にすると有効な登録情報が作成または更新されます。

OSの通知を選択すると通知が閉じ、既存のdosyaウィンドウのうち最初のウィンドウにフォーカスしてイベントのパスに移動するか、新しいウィンドウを開きます。パスが指定されていない場合は/notificationsに移動します。

ブラウザのプッシュ通知をオフにすると、対象の通知の配信は停止しますが、ブラウザの許可の取り消しやエンドポイントの登録解除は行われません。サイトの権限を削除するにはブラウザの設定を使用してください。再び許可すれば元に戻せます。

期待される結果

ブラウザで通知が許可され、dosyaで登録が確認されます。プッシュに対応したテストイベントによって、このアカウントにOSの通知が届きます。通知を選択すると、保存された移動先、または代替先の通知の受信トレイが開きます。

関連ガイド

• 通知設定を変更する
• 通知を受け取るイベントグループを選ぶ
• セキュリティ通知を確認する