Statuses
What each attempt and notification state means, what is reported back, and why accepted is not the same as seen.
Every notification creates one attempt per connected browser it goes to, and each attempt has its own status. There is no delivered status, because no browser vendor's push service reports delivery to a screen. Push's service worker reports shown instead.
Warning
accepted means the service took the message. For a browser it does not mean the notification was displayed: the device may be off, offline past the TTL, muted or in Do Not Disturb. A browser's shownAt is the signal that it was displayed.Attempt statuses#
| Status | Final | Meaning |
|---|---|---|
| queued | not yet | Created and waiting for the sender, or waiting again after a retryable answer: a network failure, a timeout, 429, 5xx, or any other status that is not an acceptance, 404/410 or 400/403/413. See what happens next. |
| processing | not yet | Being sent right now. A sender holds it for 60 seconds; if the sender stops, the attempt is picked up again. |
| accepted | final | The browser vendor's push service accepted the message for that browser. With a test key the attempt is set to accepted the moment it is created, and nothing is sent. |
| failed | final | The push service rejected the message for good (400, 403 or 413), the last of the 6 tries of a send job got a retryable answer, the attempt was picked up 12 times without finishing, or the request could not be built. |
| expired | final | The TTL passed before Push could hand the message over, or its content had already been removed. The TTL counts from the release time of a scheduled notification. A ttl of 0 gets 300 seconds. |
| invalid_subscription | final | The push service answered 404 or 410 (the browser is gone), or the browser was disconnected before sending. The browser is disconnected, and for a live send the attempt is removed from the month's count. |
Shown, clicks and dismissals#
Each attempt carries what happened after it was accepted. These fields are certain when present, and only the first event of each kind is kept.
| Field | Meaning |
|---|---|
| shownAt | When the browser displayed the notification. Push's service worker reports it once the notification is on screen. The first delivery policy waits for it before falling back. |
| clickedAt | When the person first clicked the notification or one of its action buttons. |
| actionClicked | The id of the action button behind that first click, or null for a click on the notification itself. See actions. |
| closedAt | When the person first dismissed the notification without clicking it. |
NoteBrowser events are recorded only if they reach Push. A missing
shownAt or clickedAt does not prove nobody looked: the browser may have been offline when it tried to report.Notification states#
The notification itself has a state, separate from its attempts. Only scheduled notifications spend time in anything but sent.
| state | Meaning |
|---|---|
| scheduled | Waiting for its sendAt. It has no attempts yet and can be cancelled. |
| sent | Sent at once or released. Its attempts carry their own statuses. |
| cancelled | Cancelled before release. Nothing was sent or charged. |
| dropped | Not released, because the recipient had no connected browsers left (no_browsers) or usage could not be covered (quota_exceeded). Nothing was sent or charged. |
Lifecycle#
⫻
lifecycle
- Every
liveattempt starts asqueued, moves toprocessingwhen a sender picks it up, and ends in exactly one final status. - A retryable answer sends a
processingattempt back toqueuedfor another try, up to 6 tries per send job with growing waits. An attempt stuck for more than 15 minutes is queued again by the hourly cleanup with a fresh budget, until its TTL runs out. See what happens next. - A final status never changes again. Clicks and dismissals are added on top of
acceptedattempts.
Reading statuses#
Read a notification and all its attempts with its id:
⫻
curl
⫻
200 OK
- Most attempts settle within seconds. If you poll, a few seconds apart is enough, and stop once every attempt has a final status.
- Polling counts toward your rate limits.
- Each attempt names its browser in
browser(id,label), andstepshows the delivery policy step. - The dashboard shows the same attempts for each notification, with the last error the service returned.