Troubleshooting and validating functionality
The Callback UI includes a number of troubleshooting and validation tools, available as menu options under the Developer and Tools tabs. This page describes those tools and also describes some features for which you might need to investigate the existing configuration as part of your troubleshooting effort.
To view the Developer tab in the Callback UI, you must be assigned to the Callback Administrator or Callback Developer role.
Callback Administrators, Supervisors, or Developers have access to the Tools tab.
Video: Purging callbacks
The video explains these options, provides some tips about how to use the purging feature, and describes how the purging feature works in some common scenarios.
Viewing CORS domains
|Updating the list of CORS domains||If you use Callback from the Genesys Multicloud CX hosted service, contact your Genesys representative to add cross-region resources to the list. If you don't have the Allowed CORS Domains page in your Callback UI, contact Genesys Customer Care to request it.|
If you are a Genesys Multicloud CX private edition customer, see Update CORS settings.
Validating your API key
Copy/paste your API Key into the text box and click Validate API Key.
- If your API Key is incorrect, the UI displays Invalid API Key.
- If your API Key is valid, the UI displays Valid API Key.
Testing credentials and feature functionality
The Developer tab menu includes Credential Management, if you have sufficient permissions to view this part of the interface. Use Credential Management to register, manage, and test credentials for features within your Callback environment and features that work within other supported delivery networks.
To view GWS statistics information through Callback's Statistics API, you must register your credentials on the Credential Management > GWS Credentials tab before you can retrieve the statistics.For additional information about the Callback APIs, see Genesys Multicloud CX REST APIs and tutorials for Callback.
If you use the following features with callbacks, then register, manage, and test the credentials associated with these features on the Credential Management page:
Click the feature name to find information about how to provision these features for use with Callback.
Booking a callback using the callbacks create API
When you book a callback using the Callback UI or the /callbacks/create API, the callback is booked regardless of the specified office hours or whether the virtual queue is enabled for immediate or scheduled callbacks.
If you are booking callbacks directly with the API, not all settings in the CALLBACK_SETTINGS data table are taken into account. The parameters that are included with API callbacks are marked with a checkmark (✓) in the Web Callback column of the CALLBACK_SETTINGS parameters table. For some settings, the API reads them, but only when an associated parameter is set to true. For information about the settings and relevant parameters, see Web Callbacks (API) in the Designer User's Guide.
When you use the Callback UI to book a Scheduled callback, only available timeslots are returned for the hours configured. However, when you use the callbacks/create API to book a Scheduled callback, the slot availability is not checked. Genesys strongly recommends that you use the other Genesys Engagement Services (GES) APIs to check parameters before booking the callback. The following APIs are relevant in this situation:
- To check if the office is open (configured in the Business Hours column in the CALLBACK_SETTINGS data table), use the /callbacks/open-for API.
- To check which Scheduled callback timeslots are available (configured in the Business Hours, Slot Capacity, and Slot Duration columns in the CALLBACK_SETTINGS data table), use the /callbacks/availability API.
- To check the values of Immediate Enabled and Scheduled Enabled for a callback virtual queue, use the /callbacks/queue-status API.
Starting with GES version 100.0.003.0156, you can use the open-for API to find the following additional information, but only when certain input parameters are set to true. The following table provides additional information.
|open-for API input parameter = true||Associated output parameter and values|
The API returns the following values:
NOTE: If you specify a value for the start parameter, then that value is used as the current time for any open-for API calculation. However, because some of the open-for API output parameters depend on estimated wait time, and estimated wait time is a real-time calculation, Genesys recommends that you avoid specifying a start time when using queryImmediateOfferHours or returnWithinImmediateOfferTime.
Indicates whether Immediate callbacks can be offered based on:
The API returns the Immediate Enabled value that's set for the callback virtual queue.
Refreshing your Tenant configuration data
During the process of migrating from an older version of Callback, you can use the Tools > Refetch Tenant Configuration menu option to immediately reflect recent changes to Tenant configuration in your Callback UI or to find out when the Tenant configuration data was last refreshed. The actual Tenant configuration is performed in Platform Administration or Agent Setup.
By default, Callback fetches the Tenant configuration every 30 minutes. When you click Refetch Tenant Configuration, the system refreshes Tenant configuration data wherever it exists throughout the Callback UI.
Once you are fully migrated to the latest version of Callback, there is no data in the UI that will be impacted by selecting this menu option.