Overview of Streams
A Stream is like a container for messages exchanged between two or more users via a given instant message (IM), multi-party instant message (MIM), or chat room.
Each Stream has a unique ID also known as a Conversation ID, that is returned when the IM, MIM, or chat room is created using the Create Instant Message, Create Non-inclusive Instance Message, and Create Room v3 endpoints respectively. This ID can then be used in subsequent endpoints to perform operations on the IM, MIM, or chat room.
On the Symphony web or desktop client, this ID can be found by clicking on the timestamp of any message in the conversation. This will open the Message Status module, where the Conversation ID can be found, as shown in the following picture.
The Conversation ID in the Symphony Web Client is in Standard Base64 encoding and need to be converted to be URLSafe. Conversation IDs returned in API responses are already URLSafe Base64 encoding.
To obtain the URLSafe Base64 Conversation ID:
- Replace forward slashes / with underscores _
- Replace pluses + with minuses -
- Ignore any trailing equal signs =
For example, the URLSafe Base64 encoding of
The following list shows the existing endpoints: