Skype for Business - Mobile URIs

Skype for Business Mobile URIs provide a simple way for you to initiate calls and chats using the Skype for Business mobile clients from websites and other apps.

For a Mobile URI to work, the Skype for Business mobile app must be installed on the user’s device, and the user must have an active account. The most recent versions of Skype for Business iOS and Android support Mobile URIs. All interaction initiated by these Mobile URIs happens through the Skype for Business app.

Currently two-party chat, and audio calls can be initiated by Mobile URIs on Skype for Business iOS and Android. There is also a URI to launch the app. Skype for Business Android additionally supports Mobile URI initiating video calls.

General Syntax

A ms-sfb URI has the following general form: "ms-sfb://" [operation] ["?" query ]

The components are:

  • operation = call / chat
  • query = [ "?" *(term "=" condition ) ]
    • term = 1*ALPHA
    • condition = 1*ALPHA

Note

If required parameters are missing or have invalid values, a 400 (bad request error) will be returned. Any additional/unknown parameters will be ignored.

Operations

Operation Syntax Parameters Supported Apps
Launch app ms-sfb://start None iOS, Android
Start call ms-sfb://call?id=(sip address) [&video= false or true ] id - required parameter, can be an email address or PSTN ("+" (DIGIT) *(DIGIT / "-" )). video - optional Boolean parameter with default of false, used to indicate that the user prefers the call as a video call, will be audio only if video not possible iOS (audio only), Android
Start chat ms-sfb://chat?id=(sip address) URLEncoded(url) id - required parameter, can be an email address or a URL encoded SIP URI iOS, Android

URI Examples

Start a chat:

  • "ms-sfb://chat?url=user%40contoso.com"
  • "ms-sfb://chat?id=user@contoso.com"

Start a call:

  • "ms-sfb://call?id=+1425-555-1234"
  • "ms-sfb://call?id=user@contoso.com"

Start a video call (Android only):

  • "ms-sfb://call?id=user@contoso.com&video=true"

Mobile platform examples

Read the following topics for examples of how to implement the Skype for Business Mobile URIs in Java for Android and Swift for iOS.

Mobile URI SDK Samples

You can find Android samples for this SDK in our GitHub repository today. Check back later for iOS samples.