Web Service Connector
Web services is a powerful tool that enables workspace users to connect a workflow to any REST API-enabled database or service via the web service connector workflow object.
1. An Example Scenario
Feed information from ipSCAPE to an external database and then return the response from that database to the ipSCAPE IVR to:
determine how the call is routed, using the 'Branch on Value' workflow object, or
confirm details to the caller using the 'Say Text' workflow object
display returned information to the agent within the script area of the agent toolbar
Connect to ipSCAPE APIs to check real-time queue information such as:
expected wait time (EWT) for a specific campaign, and based on the result determine how the call is routed, using the 'Branch on Value' workflow object. For example, if EWT is less than 3 minutes allow the call to queue but if the EWT is greater than 3 minutes to an IVR that allows the caller to leave a voicemail or request a call-back
if there are agents currently available for a specific campaign and based on the result decide how and where the call is routed.
2. Add Workflow Object
Open the Workspace.
Select Workflows from the Resources menu.
Select a workflow from the list displayed (you can also create a new one).
Click the Preview icon next to your selected workflow. A schematic representation of the workflow is displayed.
Click the Add New Object icon The New Workflow Object dialog opens.
Select Web Service Connector from the drop-down selection list.
Here is an overview of the process:
The steps involved in creating a web service connector are as follows:
Create an API key to connect to the appropriate REST API enabled database or CRM
Create API authentication
Create a web service connector
Use web service connector workflow object in the workflow
As every API authentication, and the data you wish to extract, is different, we have used connecting to ipSCAPE APIs to check real-time queue status as an example of how to build and use a web service connector.
Copy your API Key
Select Integration – API Keys & highlight & copy the default API key
Note: There is no limit to the number of API keys that you can create that connect to different applications
Create API Authentication
Select Integration – Authentication Applications – Select the + key to add new
Name your API & add a description – Select ipSCAPE API from the drop-down list
Enter your workspace user name & password
Paste in the API key for your ipSCAPE instance copied earlier
3. To Clone a Web Service Connector
Navigate to Integration – Web Services
Edit the web service you wish to clone
Select the Clone icon (top right)
Name your new Web Service – select Clone to create
Modify parameters as required