Set up IWD
- 1 Define agents and agent groups
- 2 Enable work item channel
- 3 Configure Agent Workspace
- 4 Create a routing application
- 5 Create an application to submit workitems to IWD
- 6 Configure Engage cloud mailboxes
- 7 Set up notifications back to the source system
- 8 Configure the IWD application
- 9 Start/update/stop a work item
- 10 Monitor and manage the Universal Queue
- 11 Report on contact center activity
Learn how to set up IWD, integrate it with third-party source systems and/or email providers, and use the IWD API to submit work items, emails and leads ("work items") to IWD.
Define agents and agent groups
Use Agent Setup to define agents and agent groups who will handle work items from your external systems.
Enable work item channel
Add the following configuration option in Agent Setup to enable the work item channel for your agents or agent groups:
- Select an agent from the Users tab or an agent group from the Agent Groups tab.
- Navigate to Annex and find the interaction-workspace section.
- If the interaction-workspace section does not exist, click Add Section and create it; otherwise, click the interaction-workspace section.
- Click + to create a key called openmedia.workitem-channels.
- Assign workitem as the value and click Save.
Configure Agent Workspace
Configure Agent Workspace for the agents in your contact center.
Create a routing application
Define a routing application in Designer to route work items, leads and email to agents based on skill, agent group, and so on.
Create an application to submit workitems to IWD
Create a third-party system adapter to handle work items that come from your external source and submit them to Genesys. A third-party application such as Salesforce or Netsuite can interact with IWD through the iWD API.
Configure Engage cloud mailboxes
When your Engage cloud email is provisioned (by Genesys), create Mailboxes to process incoming and outgoing email as work items.
Set up notifications back to the source system
Ask your Genesys team to configure other global IWD settings, including setting up notifications back to the source system by configuring a webhook integration. Click here for more detail on webhooks.
You must configure one webhook URL per source system to be configured so that your source system can receive messages about work items back from IWD. Work with your Genesys representative to configure this.
Configure the IWD application
Use Workload Manager to:
- Create Endpoints that correspond to the target endpoints created in your Designer routing application.
- Create Categories that correspond to specific departments or business processes and their hierarchies (business context). Associate each category with an Endpoint. Create a set of Service Level Agreement-based rules for how work items in each Category are to be handled.
- Create Prioritization schemas that control the logic and speed with which work items are (re-)prioritized both before and after their Service Level Agreement. Associate the schemas to Categories.
- Create Engage cloud Email mailboxes for your IWD solution.
- Provision or create Standard Response Library content to use in auto-acknowledgement emails.
Start/update/stop a work item
The typical workflow is as follows:
- The application creates a work item through the IWD API.
- The application updates the work item through the IWD API (if needed).
- The application stops the work item.
There are two ways for the application to stop an interaction:
- Implicit (recommended)—stop by invoking Mark Done. For this method, complete the following steps:
- Set up Agent Workspace to use the Service Client API.
- Disable the Mark Done button in Agent Workspace (as mentioned earlier in Configuring Agent Workspace and instead invoke the markdone method.
- Set the disposition code by invoking the setUserData method.
- Explicit—stop by using the IWD API. This requires additional configuration from your Genesys representative.
A sample application that demonstrates using the IWD API is also available through your Genesys representative.