Native Call Control Integration
Requirements
Imagicle UCX Cloud Suite, with activated subscription licenses
Imagicle Attendant Console client ver. 2021.Summer.2 or above
A Full Admin user belonging to Webex Calling customer organization, with a Webex Professional license and a phone number associated.
Webex Calling Presence already enabled, as described Cisco Webex Calling Presence .
Limitations
Only the primary line of a user can be controlled by Imagicle UCX Console. If same user is also associated to Virtual Lines, those are ignored.
OAuth2 token for UCX Suite integration with Webex Calling Call Control
Customer must authorize Imagicle Webex Calling Integration application called UCX Console Call Control Connector to access own Webex organization data. The following permissions are granted to the Imagicle Webex Calling Integration application:
spark-admin:people_read
spark-admin:organizations_read
spark-admin:xsi
These are the minimum permissions required to retrieve basic user information, read organizations information and to invoke the XSI API to perform the call control actions. Without granting such permission, Imagicle can't provide the feature.
Procedure
Please connect to the Imagicle Onboarding Web Portal for Webex Calling MT and enter customer's data, including above mentioned customer's Full Admin Webex user.
Once customer data has been entered, please proceed to next page and authorize Imagicle to access customer's Webex Org:
Once AUTHORIZE button is hit, you are prompted to login to Webex with same Full Admin account and confirm the authorization, as shown in below screenshot:
Once "Accept" button is clicked, you are redirected to the actual authorization page, showing different buttons for different authorizations. See below:
Please click on the third AUTHORIZE button in the list, to turn the button to green.
If the procedure hasn't been correctly accomplished or if the Full Admin account is missing some permissions, you might get the error message” The authorization check for your Organization failed. Please try again and make sure you follow the procedure thoroughly”:
You can safely repeat the procedure and eventually click on REAUTHORIZE to solve the issue. See below sample:
Same REAUTHORIZE button can be used to authorize the Imagicle app once the token is expired.
Please note that other tokens might be required for users' synch from Webex Control Hub and to retrieve presence status from Webex Control Hub. Please consult relevant KB articles.
Once you have authorized all required tokens, please click on "COMPLETE REQUEST" to trigger the Imagicle internal process to enable the tokens.
Remarks
Imagicle apps authorization requires Webex apps integrations to be enabled by default. If not, you might get the following error message: "Your administrator denied access to the integration you selected. We captured your request and will let them know.". See below sample:
Please consult this troubleshooting article for further details.