Launching an app or URL during inbound calls

You can set up the Zoom desktop client to automatically launch an external app or URL when you receive an external call. You can also insert parameters to pass details about the inbound caller like their caller ID. For example, you could use this feature to pass customer information to a CRM system.

This article covers:

• How to specify the parameters for launching an app or URL
• Parameters
• Examples

Prerequisites for launching an external app or URL for inbound calls

• Zoom desktop client for Windows, macOS, or Linux, 5.4.7 or higher
• The external app or URL must be able to receive parameters if specified.
  Note: Some apps or URLs may not be able to receive parameters. Contact the third-party app or website for help.
• This feature only works on external inbound calls. Internal inbound calls are not supported.

How to specify the parameters for launching an app or URL

1. Sign in to the Zoom desktop client.
2. Click your profile picture then click Settings.
3. Click the Phone tab.
4. Make sure to enable Launch an external app or a URL for incoming calls.
5. Enter the the file path of the application or the URL in the text box. Alternatively, click Browse to locate an app.
6. Enter parameters to pass certain information about the inbound call to the app or URL as plain text.
   Note:
   • Make sure to encase the app path / URL and parameters in double quotes.
   • If specify an app, make sure you specific the full path to the app's executable file, not a shortcut.
7. (Optional) Click Test to run the command and pass example parameters.
8. Close the settings window.
   • When you receive a call, Zoom Phone will launch the specified app or URL when the inbound call notification shows, and pass the parameters.
   • Calls from internal Zoom phone users will not launch the app or URL.

Parameters

Parameter	Description
%N	The full caller ID name of the inbound caller (if available).
%F	The caller ID name (first name only) of the inbound caller (if available).
%L	The caller ID name (last name only) of the inbound caller (if available).
%C	The caller ID number of the inbound caller (if available. The caller ID number is passed without the country/region code; for example, (123) 123-1234
%E	The caller ID number of the inbound caller (if available. The caller ID number is passed in E.164 format; for example, +1 (123) 123-1234

 

Examples

• https://google.com/search?q=%C
  Opens your default browser and visits https://google.com/search?q= followed by the caller ID of the inbound caller; for example, (123) 123-1234.
• C:\Program Files\Microsoft Office\root\Office16\WINWORD.EXE %F
  Opens Microsoft Word (WORD.EXE) and passes the caller's full name.