Symphony URI
This works both on desktop and mobile, as well as on the web version of Symphony.
Symphony now supports universal URIs (https links starting with
open.symphony.com
), but still supports the previous symphony://
URIs. See the section Compatibility with symphony:// URIs below for more info.When a user clicks on a universal URI, a webpage opens and proposes several options relevant to the user, such as opening the link in the Symphony Desktop Application or in the mobile app, depending on the current context, but also opening in the browser (web version).

Universal URI landing page
https://open.symphony.com/?
- If the Symphony desktop client is not running, it starts up and focuses on the Symphony desktop client.
- If the Symphony desktop client is already running, it switches focus to the Symphony desktop client. If the client is minimized, it brings the client to the foreground.
- If the Symphony desktop client is already running and in focus, it has no effect (the Symphony desktop client remains in focus).
- If the Symphony desktop client is not installed, the Windows operating system will handle the request with its default behavior.
- If the Symphony desktop client is not running, it starts up and focuses on the Symphony desktop client with a chat with the specified user IDs in focus.
- If the Symphony desktop client is already running, it switches focus to the Symphony desktop client. If the client is minimized, it brings the client to the foreground and loads the chat with the specified user IDs in focus.
- If the Symphony desktop client is already running and in focus, it opens the chat with the specified user IDs.
- If the Symphony desktop client is not installed, the Windows operating system will handle the request with its default behavior.
Error HandlingIf all provided user IDs are invalid, Symphony will open but no chat will be displayed. For a group chat, if at least one of the user IDs is valid, a group chat with the valid users will open.
1 to 1 chat
https://open.symphony.com/?startChat=71811853189751
Group chat
https://open.symphony.com/?startChat=71811853187751,3563645678951
The room creator's
userID
or userEmail
must be included in the list of users alongside the other room members. If the current user is not included, the user will receive an error message: 'Please ensure your own email address is included in room creation URL'The room name is mandatory. If it is not provided, nothing will happen.
It is possible to either directly create the room, or show a room creation modal where the user will be able to configure and confirm the room creation, see example below.
Note: The room name can contain spaces only if the link is opened in Google Chrome.
https://open.symphony.com/?startRoom=RoomName=Example&userIds=4378106230763,5478106410145,7078106304564
Protocol example with userEmails
https://open.symphony.com/?startRoom=RoomName=AroomWith2people&[email protected],[email protected]
Note: This feature is available starting with Client 23.8, August 2023.
By default, the create room URI silently creates the room. It is possible instead to show a room creation dialog, where the user will be able to configure settings, add members if needed, and initiate connection requests if some of the prepopulated members where not connected.
To do that, set the
silent
flag to false (default:true
).https://open.symphony.com/?startRoom=RoomName=AroomWith2people&silent=false&[email protected],[email protected]
Starts Symphony and displays the chat conversation identified by its
streamId
.https://open.symphony.com/?streamId=STREAM_ID&streamType=STREAM_TYPE
- If no modules are open, it opens the specified stream in the grid.
- If an unpinned module is open in the grid, it replaces the unpinned module with the specified stream.
- If there are existing pinned modules, it opens a new module with the specified stream, while retaining the existing modules.
- If the user is not logged in to Symphony when the client is launched, the user will be required to log in first. Once logged in, the specified stream will be displayed.
- You must specify the
streamType
, which can be eitherim
(for direct messages or group chats) orchatroom
. If thestreamType
is not specified, nothing will happen.
Error Handling
If the wrong stream type is specified, nothing will happen. If no such stream exists andstreamType=chatroom
, nothing will happen. If no such stream exists andstreamType=im
, a rendering error message is displayed. If a stream where the user is not a participant is specified, nothing will happen.
Starts Symphony and displays the user profile of the Symphony user identified by its
userID
.https://open.symphony.com/?userId=USER_ID
- If no modules are open, it opens the specified profile in the grid.
- If an unpinned module is open in the grid, it replaces the unpinned module with the specified profile.
- If there are existing pinned modules, it opens a new module with the specified profile, while retaining the existing modules.
- If the user is not logged in to Symphony when the client is launched, the user will be required to log in first. Once logged in, the specified profile will be displayed.
Error handling
If no such user exists but theuserId
is of a valid format (integer), a blank user profile is opened. If auserId
of invalid format is specified, nothing happens. If an externaluserId
of a user who is not entitled to external communications is specified, a blank user profile is opened.
Previous URI links (
symphony://
) continue to work.
In certain cases they may still be the best option for you, for example, when you integrate Symphony with a native app and don't want the universal URI webpage to open.To create legacy links, simply replace
open.symphony.com
with symphony://
in the links above.Last modified 1mo ago