Webex App registers the following protocol handlers with the operating system to enable click-to-call functionality from web browsers or other application. The following protocols start an audio or video call in Webex App when it's the default calling application:

  • CLICKTOCALL: or CLICKTOCALL://

  • SIP: or SIP://

  • TEL: or TEL:// (NOT ON IOS)

  • WEBEXTEL: or WEBEXTEL://

These protocol handlers are supported with the following calling services:

  • Unified CM

  • Webex Calling

  • Calling hosted by a Service Provider

Other apps can register for the protocol handlers before the Webex App. The system window asks you to select which app to use to launch the call. Check Always use this app and the app remembers your preference.

You can reset the default calling app settings and choose Webex App:

1

Open the Default app settings in your operating system settings, click Set defaults by app, and then choose Webex App.

2

For each protocol, choose Webex App.

If other apps registered to the calling protocols before Webex App, you must configure Webex App to be the default calling option.

In in the app, you can confirm that Webex App is selected for the Settings > Calling > Start calls with setting.

You can also check Always connect to Microsoft Outlook if you want to make calls in the app when you click a number for an Outlook contact.

webextel

The webextel protocol handler allows you to automatically cross launch Webex App (target app) from your application (source app) to make a call. When you add the x-success parameter, it returns to your application when the call completes on Webex App

Parameters for webextel

  • telephone—provide the telephone number to make a call to.
  • x-source—Optional parameter. This is the user friendly name of source app, can be used in user interface.
  • x-success—Optional parameter. URL to open in source app if action is successful. If this isn't included then remain in target app.
    This is only supported on iOS
  • x-cancel—Optional parameter. URL to open if action is cancelled.

Example of webextel: webextel://login?telephone=123456789&x-success=appb://success_flow&x-cancel=appb://cancel_flow

webexauth

iOS

The webexauth protocol handler allows you to automatically cross launch Webex App (target app) from your application (source app) to sign in using the email you provide and then to make a call. When you add the x-success parameter, it returns you to your application when the call completes on Webex App.

Android

The webexauth protocol handler allows you to automatically cross launch Webex App (target app) from your application (source app) to sign in using the email you provide.

To cross launch to a call, use webextel

Parameters for webexauth

  • email—provide the email address to sign into the target app
  • telephone—provide the telephone number to make a call to.
    This is only supported on iOS
  • x-source—Optional parameter. This is the user friendly name of source app, can be used in user interface.
  • x-success—Optional parameter. URL to open in source app if action is successful. If this isn't included then remain in target app.
    This is only supported on iOS
  • x-cancel—Optional parameter. URL to open if action is canceled.

Example of webexauth: webexauth://login?email=user1@example.com&telephone=123456789&x-success=appb://success_flow&x-cancel=appb://cancel_flow