You are viewing a section of Superface that will be deprecated in Q4 2023. Until then, you can continue to use it as you have before but we recommend that you migrate to our latest version soon. For more details visit superface.ai/docs/migrate.
Chat Messages
chat/messages@1.0.22 providers
Get chat messages
Retrieve paginated list of messages
Input
Destination
After Timestamp
Before Timestamp
Limit
Page
Result
Messages
Next Page
Rate Limit
1.Choose a provider
2.Use GetMessages with mock in your code
Below instructions are for our Node.js SDK. Use OneService for other languages.
npm i @superfaceai/one-sdk
Structure details
Input (object)
destination
required
Representation of a messaging destination. Can be ID or channel name, depending on the provider capability.
string
afterTimestamp
optional
Retrieve only messages after the given UNIX timestamp (in milliseconds, e.g. 1095379198750)
number
beforeTimestamp
optional
Retrieve only messages before the given UNIX timestamp (in milliseconds, e.g. 1095379198750)
number
limit
optional
Maximum number of messages to retrieve in one page
number
page
optional
Identification of page with paginated results (cursor)
string
Example
Result (object)
messages
required
List of retrieved messages
list
id
required
Unique identifier of the message
string
author
required
Author of retrieved message. Contains ID and username, depending on the provider capability.
object
id
required
string
username
optional
string
createdAt
required
UNIX timestamp (in milliseconds, e.g. 1095379198750) when the message was created
number
url
optional
URL address pointing to retrieved message.
string
hasThread
optional
Boolean that represents whether message is parent to some thread
boolean
threadId
optional
If the message was sent to a thread, identifies the parent thread by its Id.
string
text
optional
Contents of the retrieved message
string
updatedAt
optional
UNIX timestamp (in milliseconds, e.g. 1095379198750) when the message was last updated
number
reactions
optional
List of reactions on retrieved message. Each reaction contains emoji string containing encoded emoji,
number of reactions and list of users (IDs or usernames, depending on the provider capability)
list
emoji
optional
string
count
optional
number
users
optional
list
attachments
optional
List of attachments in retrieved message. Contains
list
id
required
Unique identifier of the attachment
string
createdAt
required
UNIX timestamp (in milliseconds, e.g. 1095379198750) when the attachment was created
number
fileName
optional
Name of attached file
string
mediaType
optional
MIME type of the attached file
string
url
optional
Source url of the attachment
string
nextPage
optional
Cursor to the next page for pagination forwards
string
rateLimit
optional
Rate limit details.
object
bucket
optional
Different parts of API may have different rate limits.
Bucket identifies to which part of API the rate limits apply.
string
totalRequests
optional
Total requests available in the time window.
number
remainingRequests
optional
Remaining requests available in the time window.
number
remainingRequestsPercentage
optional
Remaining requests available in the time window in percents.
number
resetTimestamp
optional
Unix timestamp when the rate limits will reset (in milliseconds).
number
resetAfter
optional
Number of seconds until reset of rate limit
number
retryAfter
optional
Number of seconds until user can retry the request
number