List of OneTimeMsg

Retrieve a list of OneTimeMsg objects

Parameter

Accessible via URL https://api.channel.io/open/v3/mkt/one-time-msgs and HTTP GET

Parameter

Example

Required

Description

Parameter Type

since

1605795977290

Optional

Epoch time in microseconds of the first OneTimeMsg to be retrieved.
Pagination is supported along with the next value contained in the root object of the JSON response.

Query

limit

25

Optional

Restrict the maximum number of OneTimeMsg objects to be retrieved

  • min : 1
  • max : 500
  • default : 25

Query

states

active (draft, waiting, sent, canceled)

Optional

A set of OneTimeMsg states to be retrieved.

Query

Example

GET https://api.channel.io/open/v3/mkt/one-time-msgs?since=1605795977290&limit=25&states=draft&states=canceled

Response

Returns a list of OneTimeMsg objects

{
  "next": 1605163155357,
  "oneTimeMsgs": [
    {
      "id": "string",
      "channelId": "string",
      "name": "string",
      "state": "draft",
      "botName": "string",
      "message": {
        "blocks": [
          {
            "type": "bullets",
            "language": "string",
            "value": "string"
          }
        ],
        "buttons": [
          {
            "title": "string",
            "theme": "blue",
            "url": "string"
          }
        ],
        "files": [
          {
            "id": "string",
            "type": "string",
            "name": "string",
            "size": 0,
            "contentType": "string",
            "duration": 0,
            "width": 0,
            "height": 0,
            "orientation": 0,
            "animated": true,
            "bucket": "string",
            "key": "string",
            "previewKey": "string"
          }
        ],
        "webPage": {
          "id": "string",
          "url": "string",
          "title": "string",
          "description": "string",
          "imageUrl": "string",
          "videoUrl": "string",
          "publisher": "string",
          "author": "string",
          "width": 0,
          "height": 0,
          "bucket": "string",
          "previewKey": "string",
          "logo": "string",
          "name": "string"
        }
      },
      "exposureType": "fullScreen",
      "userQuery": {
        "key": "string",
        "type": "boolean",
        "operator": {},
        "values": [
          {}
        ],
        "and": [
          null
        ],
        "or": [
          null
        ]
      },
      "goalEventName": "string",
      "goalEventQuery": {
        "key": "string",
        "type": "boolean",
        "operator": {},
        "values": [
          {}
        ],
        "and": [
          null
        ],
        "or": [
          null
        ]
      },
      "enableSupportBot": true,
      "followingSupportBotId": "string",
      "advertising": true,
      "sendToOfflineUser": true,
      "startAt": 1605163155489,
      "draft": {
        "oneTimeMsg": {}
      },
      "createdAt": 1605163155489,
      "updatedAt": 1605163155489,
      "sent": 0,
      "view": 0,
      "goal": 0,
      "click": 0
    }
  ]
}