The following events are returned when reading from a real time messages and events from the datafeed:
All events follow the structure below:
id: A randomly generated ID for the event, distinct from the ID of the message or chatroom or other objects that the event pertains to. These IDs are unique, except in the situation where two activities are performed simultaneously in the Symphony Messaging client (for example, members are added during the creation of a room). In this case, the two associated events will share the same id. This is for Symphony Messaging internal use.
timestamp: The timestamp for when the event occurred in Unix timestamp milliseconds format. For certain events, this will be equivalent to the created timestamp of the object the event pertains to (for instance, room creation timestamp).
type: The type of event that occurred (for instance, a "MessageSent" or "RoomCreated" event).
initiator: The actor that initiated the event. Currently, initiator will always be a user. The initiator user may be distinct from the affected user (for instance, when one user adds another user to a chatroom).
payload: An object containing event-specific information that is keyed off the event type.
Message Sent
Generated when a message is sent in an 1-1 chat or chatroom of which the user in context is a member, including messages sent by the user him/herself.
Note that since Symphony v20.3.1, the event payload returned by the Datafeed has changed. The attribute actionStream has been removed and the formStream attribute has been renamed to stream.
Shared Wall Posts
Generated when either:
The user in context shares a wall post written by another user.
Another user shares a wall post written by the user in context.
{
"id": "",
"timestamp": 0,
"type": "SHAREDPOST",
"initiator": {
"user": {
"userId": 0,
"firstName": "",
"lastName": "",
"displayName": "",
"email": "",
"username": ""
}
},
"payload": {
"sharedPost": {
"message": {
"messageId": "",
"timestamp": 0,
"message": "<div data-format='PresentationML' data-version='2.0'>Sent when sharing the original post</div>",
"data" : "{ }",
"attachments": [],
// This is the user who is sharing the wall post.
"user": {
"userId": 0,
"firstName": "",
"lastName": "",
"displayName": "",
"email": "",
"username": ""
},
"externalRecipients": false,
"stream": {
// This is the ID of the sharing user's wall.
"streamId": "",
// For a shared wall post, the destination stream type will always be POST.
"streamType": "POST"
}
},
// This is the original wall post that is being shared.
"sharedMessage": {
"messageId": "",
"timestamp": 0,
"message": "<div data-format='PresentationML' data-version='2.0'>Original Post</div>",,
"data" : "{}",
"attachments": [],
// This is the author of the original wall post.
"user": {
"userId": 0,
"firstName": "",
"lastName": "",
"displayName": "",
"email": "",
"username": ""
},
"externalRecipients": false,
"stream": {
// This is the ID of the original poster's wall.
"streamId": "",
// For a shared wall post, the originating stream type will always be POST.
"streamType": "POST"
}
}
}
}
}
IM Created
Generated when an IM (1-1 chat) is created with the user in context as a member, initiated either by the user in context or another user:
Generated when a user requests to join a room. Only the user who requested to join the room and the owners of that room will receive this event on their datafeeds.
The affectedUsers attribute represents the owners of the room.
Available in Agent 2.56.0.
[
{
"id": "LSWslw",
"messageId": "lwu0jF0reb7Sbw",
"timestamp": 1574439227693,
"type": "USERREQUESTEDTOJOINROOM",
// This is the user who initiated the action, in this case, the user who has requested to join the room.
"initiator": {
"user": {
"userId": 68719476737,
"firstName": "John",
"lastName": "Doe",
"displayName": "John Doe",
"email": "john_doe@symphony.com",
"username": "john_doe@symphony.com"
}
},
"payload": {
"userRequestedToJoinRoom": {
"stream": {
"streamId": "cVHHJfFJbjyQ4bmHsHJBcdA",
"members": []
},
//These are the users who own the room.
"affectedUsers": [
{
"userId": 68719476759,
"displayName": "owner1",
"email": "owner1@email.com",
"username": "owner1"
},
{
"userId": 68719476760,
"firstName": "owner2",
"lastName": "owner2",
"displayName": "owner2 owner2",
"email": "owner2@mail.com",
"username": "owner2"
}
]
}
}
}
]
User Joined Room
Generated when a new user joins or is added to a room of which the user in context is a member, including when the user himself joins or is added to a room.:
{
"id": "",
"timestamp": 0,
"type": "USERJOINEDROOM",
// This is the user who initiated the action (i.e. added the user to the room). If the initiator and and affected user are the same, the user joined the room of his own accord.
"initiator": {
"user": {
"userId": 0,
"firstName": "",
"lastName": "",
"displayName": "",
"email": "",
"username": ""
}
},
"payload": {
"userJoinedRoom": {
"stream": {
"streamId": "",
"streamType": "ROOM",
"roomName": "",
"external": false
},
// This is the user who was affected by the action (i.e. joined the room).
"affectedUser": {
"userId": 0,
"firstName": "",
"lastName": "",
"displayName": "",
"email": "",
"username": ""
}
}
}
}
User Left Room
Generated when a user leaves or is removed from a room of which the user in context is a member, including when the user himself leaves or is removed from a room:
{
"id": "",
"timestamp": 0,
"type": "USERLEFTROOM",
// This is the user who initiated the action (i.e. removed the user from the room). If the initiator and and affected user are the same, the user left the room of his own accord.
"initiator": {
"user": {
"userId": 0,
"firstName": "",
"lastName": "",
"displayName": "",
"email": "",
"username": ""
}
},
"payload": {
"userLeftRoom": {
"stream": {
"streamId": "",
"streamType": "ROOM",
"roomName": "",
"external": false
},
// This is the user who was affected by the action (i.e. left the room).
"affectedUser": {
"userId": 0,
"firstName": "",
"lastName": "",
"displayName": "",
"email": "",
"username": ""
}
}
}
}
Room Member Promoted to Owner
Generated when a user is promoted from a participant to an owner of a room of which the user in context is a member, including when the user himself is promoted to an owner or promotes another user.:
{
"id": "",
"timestamp": 0,
"type": "ROOMMEMBERPROMOTEDTOOWNER",
// This is the user who performed the promotion.
"initiator": {
"user": {
"userId": 0,
"firstName": "",
"lastName": "",
"displayName": "",
"email": "",
"username": ""
}
},
"payload": {
"roomMemberPromotedToOwner": {
"stream": {
"streamId": "",
"streamType": "ROOM",
"roomName": "",
"external": false
},
// This is the user who was promoted.
"affectedUser": {
"userId": 0,
"firstName": "",
"lastName": "",
"displayName": "",
"email": "",
"username": ""
}
}
}
}
Room Member Demoted from Owner
Generated when a user is demoted from an owner to a participant of a room of which the user in context is a member, including when the user himself is demoted to a participant or demotes another user:
{
"id": "",
"timestamp": 0,
"type": "ROOMMEMBERDEMOTEDFROMOWNER",
// This is the user who performed the demotion.
"initiator": {
"user": {
"userId": 0,
"firstName": "",
"lastName": "",
"displayName": "",
"email": "",
"username": ""
}
},
"payload": {
"roomMemberDemotedFromOwner": {
"stream": {
"streamId": "",
"streamType": "ROOM",
"roomName": "",
"external": false
},
// This is the user who was demoted.
"affectedUser": {
"userId": 0,
"firstName": "",
"lastName": "",
"displayName": "",
"email": "",
"username": ""
}
}
}
}
Connection Requested
Generated when a connection request is sent, either:
Sent by the user in context to another user.
Sent to the user in context by another user.
{
"id": "",
"timestamp": 0,
"type": "CONNECTIONREQUESTED",
// This is the user who sent the request.
"initiator": {
"user": {
"userId": 0,
"firstName": "",
"lastName": "",
"displayName": "",
"email": "",
"username": ""
}
},
"payload": {
"connectionRequested": {
// This is the user to whom the request was sent.
"toUser": {
"userId": 0,
"firstName": "",
"lastName": "",
"displayName": ""
}
}
}
}
Connection Accepted
Generated when a connection request is accepted, either:
Sent by the user in context and accepted by another user.
Sent by another user and accepted by the user in context.
{
"id": "",
"timestamp": 0,
"type": "CONNECTIONACCEPTED",
// This is the user who accepted the request.
"initiator": {
"user": {
"userId": 0,
"firstName": "",
"lastName": "",
"displayName": "",
"email": "",
"username": ""
}
},
"payload": {
"connectionAccepted": {
// This is the user who sent the request.
"fromUser": {
"userId": 0,
"firstName": "",
"lastName": "",
"displayName": "",
"email": ""
}
}
}
}
Generic System Event
Generic System Event is a new category of generic real time event, that is generated in various situations, such as phone calls, events specific to federated chats, and more.
The event is generic, and its structure depends on the event's subtype (genericSystemEvent.eventSubtype).
Most generic events are related to internal processes and are not useful for Bots, so you can just ignore them. When Symphony introduces events that can be relevant to Bots, they will be documented in this page.
The common structure to all Generic System Events is described below. The parameters section will vary depending on the subtype of the event.
Always rely on the eventSubtype to filter the events that are relevant to you, as new subtypes with a different structure may be introduced in the future.
Generated when a user replies to a bot message that contains an interactive form with UX components such as text fields, radio buttons, checkboxes, person selectors and more. Please refer to for more information.
