A workspace that chose the former All sessions option shows On handoff: both gave a workitem to every session handed off to Genesys.
What the workitem holds
A session gets at most one workitem, with its title, summary, queue, skills, language and priority. To fill custom attributes, set session attributes namedgenesys_workitem_<attribute> before handoff. Values the worktype rejects are left out. The ID is stored on the session as genesys_workitem_id.
A session that has only a workitem, with no Genesys conversation, carries its summary and link in the workitem’s description only. Its internal notes stay in OpenCX.
Kept in step
Workflows can create and update workitems too: see Create Genesys Workitem and Update Genesys Workitem in Workflow actions.
Workitem statuses and custom statuses
By default only open and closed are kept in step, as above. OpenCX moves the workitem to the nearest Closed or open status your worktype’s transitions allow. Statuses are matched by their Genesys ID, never their name, so a Closed status closes the session even if its name reads as open. Each of your custom session statuses can also be mapped to one workitem status:- Setting that custom status on a session moves its workitem to the mapped status.
- An agent moving the workitem to that status in Genesys sets the custom status on the session, or closes the session with it if it’s a closed status.
- A custom status for open sessions can’t be mapped to a Closed workitem status.
- Saving a mapping fills in the custom status of open sessions that have none, from their workitem’s current status. It never closes or reopens a session.
Related
Handoff settings
Create a workitem when nobody is on the queue.
Permissions
Workitems need the workitem permissions on the role.