Links

Symphony URI for Mobile (deprecated)

Following the introduction of universal URIs that work both on desktop and mobile, mobile-specific URIs are deprecated. URIs defined below will continue to work, but for any new integration, please use the universal URIs defined here.

The symphony: URI can be used to launch the Symphony iOS application from another iOS app.

Launch the Symphony iOS app with a chat from another app

symphony://chat_with?username=USERNAME&name=USER_FULL_NAME
  • username is the Symphony username of the person with whom the user wants to start/continue a 1-1 chat.
  • name is an optional parameter used to specify the first and last name of the person with whom the user wants to start/continue a 1-1 chat. This will be used for a fallback option if no user with the provided username can be found.
symphony://chat_with?username=<john.smith>&name=John%20Smith
When the app is launched with the above URL, the UI should pop to the root view controller (if necessary) and then automatically go to a 1-1 chat with the user John Smith.
  • If a 1-1 with the user john.smith already exists, all the conversation history is expected to be present.
  • If a 1-1 conversation with the user john.smith doesn't exist yet, a new 1-1 conversation is created.
  • If there is no such user with the username john.smith, the user is directed to a global search on the People tab with the search text field pre-populated with the user's full name.
Note: The Symphony URI only supports internal use cases, as the search by username is only possible within the same company.