Read Datafeed
Last updated
Was this helpful?
Last updated
Was this helpful?
Reads the specified datafeed. The datafeed provides messages and events from all conversations that the user is in. The types of events surfaced in the datafeed can be found in the list.
Backward compatibility breaking notice: Starting in May 2025, the ackId parameter must be either set to an empty string or omitted for the first Datafeed Read call.
ackId: The ackId sent as a parameter must be either set to an empty string or omitted in the first call. In the response, an ackId will be sent back and it must be used for the next call. This way, you acknowledge that you have received the events that came with that ackId and that the datafeed will remove the events associated with that ackId from your queue. Events that have not been acknowledged will be re-queued and distributed again in a successive call.
Datafeed ttl: A datafeed time-to-live (ttl) is 30 minutes which means that, if your code doesn't poll the feed for 30 minutes, the feed will be deleted and your program will not receive queued messages. If your code attempts to read an expired or deleted feed, you will receive a 400 error code. Upon receiving a 400 error code, you need to create a new feed to continue to receive messages. Messages sent between the time the feed is deleted and you re-create a new one, will be lost.
Available on Agent 2.57.0 and above.
The datafeed provides messages and events from all conversations that the user is in. The types of events surfaced in the datafeed can be found in the Real Time Events list. (see definition on top of the file)
Read the specified datafeed.
The ackId sent as parameter can be empty for the first call. In the response an ackId will be sent back and it can be used for the next call: in this way you acknowledge that you have received the events that came with that ackId; datafeed will remove the events associated with that ackId from your queue
ID of the datafeed
Session authentication token.
Key Manager authentication token.
An object containing the ackId (and parameters) associated with events that the client has received through an individual feed.
A unique id for events that can be deleted from a client's. Empty for the first read. If set to null or missing, it will be considered empty feed.
Set to false to avoid updating the user's presence when reading events. Default is true.
truePOST /agent/v5/datafeeds/{datafeedId}/read HTTP/1.1
Host: youragentURL.symphony.com
sessionToken: text
keyManagerToken: text
Content-Type: application/json
Accept: */*
Content-Length: 38
{
"ackId": "text",
"updatePresence": true
}{
"events": [
{
"id": "text",
"messageId": "text",
"timestamp": 1,
"type": "text",
"diagnostic": "text",
"initiator": {
"user": {
"userId": 1,
"firstName": "text",
"lastName": "text",
"displayName": "text",
"email": "text",
"username": "text"
}
},
"payload": {
"messageSent": {
"message": {
"messageId": "text",
"parentMessageId": "text",
"timestamp": 1,
"message": "text",
"sharedMessage": "[Circular Reference]",
"data": "text",
"attachments": [
{
"id": "text",
"name": "text",
"size": 1,
"images": [
{
"id": "text",
"dimension": "text"
}
]
}
],
"user": {
"userId": 1,
"firstName": "text",
"lastName": "text",
"displayName": "text",
"email": "text",
"username": "text"
},
"stream": {
"streamId": "text",
"streamType": "text",
"roomName": "text",
"members": [
{
"userId": 1,
"firstName": "text",
"lastName": "text",
"displayName": "text",
"email": "text",
"username": "text"
}
],
"external": true,
"crossPod": true
},
"externalRecipients": true,
"diagnostic": "text",
"userAgent": "text",
"originalFormat": "text",
"disclaimer": "text",
"sid": "fa691cd3-484a-4109-aeb2-57c05b78c95b",
"replacing": "text",
"replacedBy": "text",
"initialTimestamp": 1,
"initialMessageId": "text",
"silent": true
}
},
"sharedPost": {
"message": {
"messageId": "text",
"parentMessageId": "text",
"timestamp": 1,
"message": "text",
"sharedMessage": "[Circular Reference]",
"data": "text",
"attachments": [
{
"id": "text",
"name": "text",
"size": 1,
"images": [
{
"id": "text",
"dimension": "text"
}
]
}
],
"user": {
"userId": 1,
"firstName": "text",
"lastName": "text",
"displayName": "text",
"email": "text",
"username": "text"
},
"stream": {
"streamId": "text",
"streamType": "text",
"roomName": "text",
"members": [
{
"userId": 1,
"firstName": "text",
"lastName": "text",
"displayName": "text",
"email": "text",
"username": "text"
}
],
"external": true,
"crossPod": true
},
"externalRecipients": true,
"diagnostic": "text",
"userAgent": "text",
"originalFormat": "text",
"disclaimer": "text",
"sid": "fa691cd3-484a-4109-aeb2-57c05b78c95b",
"replacing": "text",
"replacedBy": "text",
"initialTimestamp": 1,
"initialMessageId": "text",
"silent": true
},
"sharedMessage": {
"messageId": "text",
"parentMessageId": "text",
"timestamp": 1,
"message": "text",
"sharedMessage": "[Circular Reference]",
"data": "text",
"attachments": [
{
"id": "text",
"name": "text",
"size": 1,
"images": [
{
"id": "text",
"dimension": "text"
}
]
}
],
"user": {
"userId": 1,
"firstName": "text",
"lastName": "text",
"displayName": "text",
"email": "text",
"username": "text"
},
"stream": {
"streamId": "text",
"streamType": "text",
"roomName": "text",
"members": [
{
"userId": 1,
"firstName": "text",
"lastName": "text",
"displayName": "text",
"email": "text",
"username": "text"
}
],
"external": true,
"crossPod": true
},
"externalRecipients": true,
"diagnostic": "text",
"userAgent": "text",
"originalFormat": "text",
"disclaimer": "text",
"sid": "fa691cd3-484a-4109-aeb2-57c05b78c95b",
"replacing": "text",
"replacedBy": "text",
"initialTimestamp": 1,
"initialMessageId": "text",
"silent": true
}
},
"instantMessageCreated": {
"stream": {
"streamId": "text",
"streamType": "text",
"roomName": "text",
"members": [
{
"userId": 1,
"firstName": "text",
"lastName": "text",
"displayName": "text",
"email": "text",
"username": "text"
}
],
"external": true,
"crossPod": true
}
},
"roomCreated": {
"stream": {
"streamId": "text",
"streamType": "text",
"roomName": "text",
"members": [
{
"userId": 1,
"firstName": "text",
"lastName": "text",
"displayName": "text",
"email": "text",
"username": "text"
}
],
"external": true,
"crossPod": true
},
"roomProperties": {
"name": "text",
"description": "text",
"creatorUser": {
"userId": 1,
"firstName": "text",
"lastName": "text",
"displayName": "text",
"email": "text",
"username": "text"
},
"createdDate": 1,
"external": true,
"crossPod": true,
"public": true,
"copyProtected": true,
"readOnly": true,
"discoverable": true,
"membersCanInvite": true,
"keywords": [
{
"key": "text",
"value": "text"
}
],
"canViewHistory": true
}
},
"roomUpdated": {
"stream": {
"streamId": "text",
"streamType": "text",
"roomName": "text",
"members": [
{
"userId": 1,
"firstName": "text",
"lastName": "text",
"displayName": "text",
"email": "text",
"username": "text"
}
],
"external": true,
"crossPod": true
},
"newRoomProperties": {
"name": "text",
"description": "text",
"creatorUser": {
"userId": 1,
"firstName": "text",
"lastName": "text",
"displayName": "text",
"email": "text",
"username": "text"
},
"createdDate": 1,
"external": true,
"crossPod": true,
"public": true,
"copyProtected": true,
"readOnly": true,
"discoverable": true,
"membersCanInvite": true,
"keywords": [
{
"key": "text",
"value": "text"
}
],
"canViewHistory": true
}
},
"roomDeactivated": {
"stream": {
"streamId": "text",
"streamType": "text",
"roomName": "text",
"members": [
{
"userId": 1,
"firstName": "text",
"lastName": "text",
"displayName": "text",
"email": "text",
"username": "text"
}
],
"external": true,
"crossPod": true
}
},
"roomReactivated": {
"stream": {
"streamId": "text",
"streamType": "text",
"roomName": "text",
"members": [
{
"userId": 1,
"firstName": "text",
"lastName": "text",
"displayName": "text",
"email": "text",
"username": "text"
}
],
"external": true,
"crossPod": true
}
},
"userJoinedRoom": {
"stream": {
"streamId": "text",
"streamType": "text",
"roomName": "text",
"members": [
{
"userId": 1,
"firstName": "text",
"lastName": "text",
"displayName": "text",
"email": "text",
"username": "text"
}
],
"external": true,
"crossPod": true
},
"affectedUser": {
"userId": 1,
"firstName": "text",
"lastName": "text",
"displayName": "text",
"email": "text",
"username": "text"
}
},
"userLeftRoom": {
"stream": {
"streamId": "text",
"streamType": "text",
"roomName": "text",
"members": [
{
"userId": 1,
"firstName": "text",
"lastName": "text",
"displayName": "text",
"email": "text",
"username": "text"
}
],
"external": true,
"crossPod": true
},
"affectedUser": {
"userId": 1,
"firstName": "text",
"lastName": "text",
"displayName": "text",
"email": "text",
"username": "text"
}
},
"roomMemberPromotedToOwner": {
"stream": {
"streamId": "text",
"streamType": "text",
"roomName": "text",
"members": [
{
"userId": 1,
"firstName": "text",
"lastName": "text",
"displayName": "text",
"email": "text",
"username": "text"
}
],
"external": true,
"crossPod": true
},
"affectedUser": {
"userId": 1,
"firstName": "text",
"lastName": "text",
"displayName": "text",
"email": "text",
"username": "text"
}
},
"roomMemberDemotedFromOwner": {
"stream": {
"streamId": "text",
"streamType": "text",
"roomName": "text",
"members": [
{
"userId": 1,
"firstName": "text",
"lastName": "text",
"displayName": "text",
"email": "text",
"username": "text"
}
],
"external": true,
"crossPod": true
},
"affectedUser": {
"userId": 1,
"firstName": "text",
"lastName": "text",
"displayName": "text",
"email": "text",
"username": "text"
}
},
"connectionRequested": {
"toUser": {
"userId": 1,
"firstName": "text",
"lastName": "text",
"displayName": "text",
"email": "text",
"username": "text"
}
},
"connectionAccepted": {
"fromUser": {
"userId": 1,
"firstName": "text",
"lastName": "text",
"displayName": "text",
"email": "text",
"username": "text"
}
},
"messageSuppressed": {
"messageId": "text",
"stream": {
"streamId": "text",
"streamType": "text",
"roomName": "text",
"members": [
{
"userId": 1,
"firstName": "text",
"lastName": "text",
"displayName": "text",
"email": "text",
"username": "text"
}
],
"external": true,
"crossPod": true
}
},
"symphonyElementsAction": {
"stream": {
"streamId": "text",
"streamType": "text",
"roomName": "text",
"members": [
{
"userId": 1,
"firstName": "text",
"lastName": "text",
"displayName": "text",
"email": "text",
"username": "text"
}
],
"external": true,
"crossPod": true
},
"formMessageId": "text",
"formId": "text",
"formValues": {}
},
"userRequestedToJoinRoom": {
"stream": {
"streamId": "text",
"streamType": "text",
"roomName": "text",
"members": [
{
"userId": 1,
"firstName": "text",
"lastName": "text",
"displayName": "text",
"email": "text",
"username": "text"
}
],
"external": true,
"crossPod": true
},
"affectedUsers": [
{
"userId": 1,
"firstName": "text",
"lastName": "text",
"displayName": "text",
"email": "text",
"username": "text"
}
]
}
}
}
],
"ackId": "text"
}