Connector API
Search…
⌃K

Message threads

Get all message threads

Get all message threads that you have created, filtered by time interval and/or specific message thread IDs. Note this operation uses Pagination.

Request

[PlatformAddress]/api/connector/v1/messageThreads/getAll
{
"ClientToken": "E0D439EE522F44368DC78E1BFB03710C-D24FB11DBE31D4621C4817E028D9E1D",
"AccessToken": "C66EF7B239D24632943D115EDE9CB810-EA00F8FD8294692C940F6B5A8F9453D",
"Client": "Sample Client 1.0.0",
"CreatedUtc":{
"StartUtc": "2022-03-03T00:00:00Z",
"EndUtc": "2022-03-14T00:00:00Z"
},
"Limitation":{
"Cursor": "e7f26210-10e7-462e-9da8-ae8300be8ab7",
"Count": 10
}
}
Property
Type
Contract
Description
ClientToken
string
required
Token identifying the client application.
AccessToken
string
required
Access token of the client application.
Client
string
required
Name and version of the client application.
MessageThreadIds
array of string
optional, max 1000 items
Unique identifiers of Message threads. Required if no other filter is provided.
CreatedUtc
optional, max length 3 months
Interval in which the Message thread was created. Required if no other filter is provided.
UpdatedUtc
optional, max length 3 months
Interval in which the Message thread was updated. Required if no other filter is provided.
Limitation
required
Limitation on the quantity of message thread data returned (using cursor pagination).

Time interval

Property
Type
Contract
Description
StartUtc
string
required
Start of the interval in UTC timezone in ISO 8601 format.
EndUtc
string
required
End of the interval in UTC timezone in ISO 8601 format.

Response

{
"MessageThreads": [
{
"Id": "7f9325f6-ef44-4911-89a8-ae51010a5aa4",
"OriginalSender": "John Doe",
"Subject": "Example subject",
"CreatedUtc": "2022-03-07T16:09:45Z",
"UpdatedUtc": "2022-03-07T16:09:45Z"
}
],
"Cursor": "7f9325f6-ef44-4911-89a8-ae51010a5aa4"
}
Property
Type
Contract
Description
MessageThreads
array of Message threads
required
The filtered message threads.
Cursor
string
optional
Unique identifier of the last and hence oldest message thread returned. This can be used in Limitation in a subsequent request to fetch the next batch of older message threads.

Message thread

Property
Type
Contract
Description
Id
string
required
Unique identifier of the message thread.
OriginalSender
string
required
The sender of the original message in the thread.
Subject
string
required
Subject of the message thread.
CreatedUtc
string
required
Creation date and time of the message thread in UTC timezone in ISO 8601 format.
UpdatedUtc
string
required
Last update date and time of the message thread in UTC timezone in ISO 8601 format.

Add message thread

Creates a new Message thread on behalf of the specified customer, i.e. the sender of the original message in the message thread.

Request

[PlatformAddress]/api/connector/v1/messageThreads/add
{
"ClientToken": "E0D439EE522F44368DC78E1BFB03710C-D24FB11DBE31D4621C4817E028D9E1D",
"AccessToken": "C66EF7B239D24632943D115EDE9CB810-EA00F8FD8294692C940F6B5A8F9453D",
"Client": "Sample Client 1.0.0",
"OriginalSender": "John Doe",
"Subject": "Example subject"
}
Property
Type
Contract
Description
ClientToken
string
required
Token identifying the client application.
AccessToken
string
required
Access token of the client application.
Client
string
required
Name and version of the client application.
OriginalSender
string
required
The sender of the original message in the thread.
Subject
string
required
Subject of the message thread.

Response

{
"MessageThreads": [
{
"Id": "8d02142f-31cf-4115-90bf-ae5200c7a1ba",
"OriginalSender": "John Doe",
"Subject": "Example subject",
"CreatedUtc": "2022-03-08T12:06:50Z",
"UpdatedUtc": "2022-03-08T12:06:50Z",
"IsResolved": false
}
]
}
Property
Type
Contract
Description
MessageThreads
array of Message threads
required
The created message threads.
Last modified 4mo ago