Customizing the Connector widget
The Connector widget offers another way to connect with third-party APIs, alongside the HTTP Call and Script widgets. Key benefits include:
- Stronger authentication: Supports OAuth and other methods not available in HTTP Call or easily implemented in Script.
- Seamless integration: Works across multiple Zoom products through the Zoom App Marketplace.
While the Connector widget simplifies custom development with a low/no-code approach, it still requires a deep understanding of your use case, the third-party system you’re integrating with, and its API capabilities.
Learn more about using the connector widget for Zoom Virtual Agent.
Requirements for customizing the Connector widget
How to add or edit the Connector widget
- Sign in to the Zoom web portal.
- In the navigation menu, click Contact Center Management then Flows.
- Click a flow's display name to edit it.
- In the left-side widgets panel, click and drag Connector onto the preferred location in the flow.
- Select the Connector widget.
- (Optional) Click Rename to change the display name of the widget.
- In the Settings tab, select the custom connector to use from the Connector Name dropdown.
- Alternatively, click Create Connector to create a new marketplace connector in the Zoom App Marketplace.
After selecting the marketplace app, the system will display the available endpoints based on those configured for your app.
- In the Route dropdown, select the appropriate endpoint to use within the selected custom connector.
- Customize the associated settings and exits.
Connector widget settings
Once you've selected an endpoint, configure the required input and response parameters. Use global, custom, or local variables to define these parameters. You can capture values dynamically, such as:
- Using the consumer’s ANI (Automatic Number Identification) in a voice flow.
- Collecting user input to set variable values.
Mapping Input & Output
Input Mapping: Under Map input to, select a variable to pass data to the connector. This allows the connector to receive and process the data you pass into it.
When using a custom API endpoint where the marketplace connector can handle the response, the connector widget will automatically break down the response into separate fields. These fields can then be mapped to variables without needing a script module.
Output Mapping: Under Map output to, select a variable to store the response from the connector. This variable will hold the processed data and can be used later in the flow.
Connector widget exits
Customize how the flow handles different outcomes by clicking the Exits tab and configuring the following:
- Timeout: Select the destination widget if the call exceeded the Timeout in seconds set in the widget’s settings.
- No Match: Select the destination widget if the exit condition isn’t met.
- Success: Select the destination widget if the connection is successfully established.
- Fail: Select the destination widget if the connection attempt fails or encounters an error.