Skip to content
English
Want to know more about us?
  • There are no suggestions because the search field is empty.

Realtime - Connect data - Push notifications

Smartocto can show the moment a browserpush or app-notification is sent to your readers. To have it in smartocto we need to receive information from you. This article describes the required information and format.

To integrate push notifications with Smartocto, provide a feed of your most recently sent push notifications. Each item in the feed must include the following fields:

  1. Timestamp of the moment of sending the push-notification in ISO 8601-format
  2. The headline of the push notification, or the title of the story in case you cannot supply the used text in the notification
  3. The story identifier: provide the unique postId of the pushed story if it appears in the story's URL. If the postId is not part of the URL, provide the full story URL instead — with all query parameters (e.g. UTM tags) removed.

Example when you have the postId in url:

{
 "items": [
  {
   "id": "12345",
    "pubDate": "2023-06-14T14:30:00+01:00",
    "title": "Some title of a story"
  },
  {...}
 ]
}

Example when you don’t have the postId in your story-url:

{
 "items": [
  {
   "id": "https://domain.org/some-url-over/here/with/no/parameters/",
    "pubDate": "2023-06-14T14:30:00+01:00",
    "title": "Some title of a pushed story"
  },
  {...}
 ]
}

NOTE: {...} in code is not valid, it's to indicate that more items can be added.

Timestamp

The timestamp can be formatted one in the following formats:

"pubDate": "2023-06-14T14:30:00+01:00" // ISO 8601
"pubDate": "Wed, 09 Feb 2022 07:05:16 +0100"
"pubDate": "2023-02-07T9:46:27Z"
"pubDate": "1675763254000"

Sorting & amount of items

Items must be sorted by timestamp in descending order (newest first). The feed must contain the 25 most recent push notifications.

Smartocto polls your feed every minute to detect and display new push notifications.

Additional information & questions

If you have any questions about setting up your push notifications feed, contact our support team at support@smartocto.com.