Read Datafeed

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 Real Time Events 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.

Last updated 3 months ago

Was this helpful?

POST /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" }

Read the specified real time message / event stream ("datafeed").