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.

Smartocto requires a feed with the most recent pushed stories which provides the following information per push:

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. We need to know which story has been pushed. Therefore we need the unique postId of the pushed story if this is also used in the url of the story, OR the full url of the story in case the postId is not available in the url. In case of the full url, remove the parameters like utm_tags from the url.

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"
  },
  {...}
 ]
}

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

The items must be sorted on timestamp in descending order. The list with items needs to contain the 25 most recent push notifications.

Smartocto will read your delivered feed every minute to detect and visualise the pushed messages.

Additional information & questions

In case of questions, please contact our support team via support@smartocto.com.