Difference between revisions of "PEC-IWD/Current/Administrator/IWDSetup"

From Genesys Documentation
Jump to: navigation, search
m (Text replacement - "\|Platform=([^\|]*)GenesysEngage-onpremises([\|]*)" to "|Platform=$1GenesysEngage-cloud$2")
(Published)
Line 3: Line 3:
 
|DisplayName=Set up iWD
 
|DisplayName=Set up iWD
 
|TocName=Set up iWD
 
|TocName=Set up iWD
|Context=A high-level view of the steps you need to take to set up Cloud iWD, integrate it with third-party source systems and use the Cloud iWD API to submit workitems to iWD.
+
|Context=A high-level view of the steps to take to set up Cloud iWD, integrate it with third-party source systems and use the Cloud iWD API to submit workitems to iWD.
 
|Dimension=Journey
 
|Dimension=Journey
 
|ComingSoon=No
 
|ComingSoon=No
 
|Platform=GenesysEngage-cloud
 
|Platform=GenesysEngage-cloud
|Prereq=
 
 
|Section={{Section
 
|Section={{Section
 
|sectionHeading=High-level process
 
|sectionHeading=High-level process
 
|anchor=High-levelprocess
 
|anchor=High-levelprocess
 
|alignment=Vertical
 
|alignment=Vertical
|Media=
+
|structuredtext=To implement Cloud iWD, complete the following steps:
|image=
 
|structuredtext=At a high level, you'll need to complete the following steps to implement Cloud iWD:
 
  
 
#Define {{Link-AnywhereElse|product=PEC-AS|version=Current|manual=ManageCC|topic=Create_agents|display text=agents}} and {{Link-AnywhereElse|product=PEC-AS|version=Current|manual=ManageCC|topic=Create_agent_groups|display text=agent groups}}.
 
#Define {{Link-AnywhereElse|product=PEC-AS|version=Current|manual=ManageCC|topic=Create_agents|display text=agents}} and {{Link-AnywhereElse|product=PEC-AS|version=Current|manual=ManageCC|topic=Create_agent_groups|display text=agent groups}}.
 
#Configure {{Link-AnywhereElse|product=PEC-AS|version=Current|manual=ManageCC|topic=CC_options_overview|display text=agent desktop}} options for your contact center.
 
#Configure {{Link-AnywhereElse|product=PEC-AS|version=Current|manual=ManageCC|topic=CC_options_overview|display text=agent desktop}} options for your contact center.
#Configure {{Link-SomewhereInThisManual|topic=IWDRBAC|anchor=top|display text=Role-Based Access Control (RBAC)}} for all users of iWD Manager.
+
#Configure {{Link-SomewhereInThisManual|topic=IWDRBAC|anchor=|display text=Role-Based Access Control (RBAC)}} for all users of iWD Manager.
 
#Define a {{Link-AnywhereElse|product=PEC-ROU|version=Current|manual=Designer|display text=routing application in Designer}} to handle incoming workitems to iWD.
 
#Define a {{Link-AnywhereElse|product=PEC-ROU|version=Current|manual=Designer|display text=routing application in Designer}} to handle incoming workitems to iWD.
 
#Use iWD Manager to:
 
#Use iWD Manager to:
##Create {{Link-SomewhereInThisManual|topic=IWDEndpoints|anchor=top|display text=Endpoints}} that correspond to the target endpoints created in your Designer routing application.
+
##Create {{Link-SomewhereInThisManual|topic=IWDEndpoints|anchor=|display text=Endpoints}} that correspond to the target endpoints created in your Designer routing application.
##Create {{Link-SomewhereInThisManual|topic=IWDCategories|anchor=top|display text=Categories}} that correspond to specific departments or business processes and their hierarchies (business context), associate each with an Endpoint and create a set of Service Level Agreement-based rules for how workitems in each Category are to be handled.
+
##Create {{Link-SomewhereInThisManual|topic=IWDCategories|anchor=|display text=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 workitems in each Category are to be handled.
##Create {{Link-SomewhereInThisManual|topic=IWDPrioritization|anchor=top|display text=Prioritization schemas}} that control the logic and speed with which workitems are (re-)prioritized both before and after their Service Level Agreement, and associate the schemas to Categories.
+
##Create {{Link-SomewhereInThisManual|topic=IWDPrioritization|anchor=|display text=Prioritization schemas}} that control the logic and speed with which workitems are (re-)prioritized both before and after their Service Level Agreement. Associate the schemas to Categories.
 
##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 [https://en.wikipedia.org/wiki/Webhook here] for more detail on webhooks.
 
##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 [https://en.wikipedia.org/wiki/Webhook here] for more detail on webhooks.
#Integrate your source systems to use the {{#Widget:ExtLink|link=https://developer.genesyscloud.com/reference/iwd/|displaytext=Cloud iWD API}} to submit workitems to Genesys (see {{Link-SomewhereInThisManual|topic=IWDSetup|anchor=Integrate|display text=Integrating source systems}} below).
+
#Integrate your source systems to use the {{#Widget:ExtLink|link=https://developer.genesyscloud.com/reference/iwd/|displaytext=Cloud iWD API}} to submit workitems to Genesys (see {{Link-SomewhereInThisManual|topic=IWDSetup|anchor=|display text=Integrating source systems}} below).
#{{Link-SomewhereInThisManual|topic=IWDMonitor|anchor=top|display text=Monitor}} the activity of your contact center as iWD manages the global queue of workitems.
+
#{{Link-SomewhereInThisManual|topic=IWDMonitor|anchor=|display text=Monitor}} the activity of your contact center as iWD manages the global queue of workitems.
#{{Link-SomewhereInThisManual|topic=IWDGTL|anchor=top|display text=Manage}} individual workitems or groups of them while they are being queued and distributed by iWD.
+
#{{Link-SomewhereInThisManual|topic=IWDGTL|anchor=|display text=Manage}} individual workitems or groups of them while iWD queues and distributes them.
#Report on historical contact center activity using {{Link-AnywhereElse|product=PEC-REP|version=Current|manual=RPRT|display text=Genesys CX Insights}}. Report on realtime activity through the iWD Manager {{Link-SomewhereInThisManual|topic=IWDMonitor|anchor=top|display text=Monitoring features}} on the '''Summary''' tab and through {{Link-AnywhereElse|product=PEC-REP|version=Current|manual=RT|display text=Pulse}}.
+
#Report on historical contact center activity using {{Link-AnywhereElse|product=PEC-REP|version=Current|manual=RPRT|display text=Genesys CX Insights}}. Report on real-time activity through the iWD Manager {{Link-SomewhereInThisManual|topic=IWDMonitor|anchor=|display text=Monitoring features}} on the '''Summary''' tab and through {{Link-AnywhereElse|product=PEC-REP|version=Current|manual=RT|display text=Pulse}}.
|structuredtextwide=
 
|FAQHeading=
 
 
|Status=No
 
|Status=No
 
}}{{Section
 
}}{{Section
Line 36: Line 31:
 
|anchor=Integratingsourcesystems
 
|anchor=Integratingsourcesystems
 
|alignment=Vertical
 
|alignment=Vertical
|Media=
 
|image=
 
 
|structuredtext====Create an application to submit workitems to Cloud IWD===
 
|structuredtext====Create an application to submit workitems to Cloud IWD===
 
A third-party application such as Salesforce or Netsuite can interact with Genesys Cloud IWD through the {{#Widget:ExtLink|link=https://developer.genesyscloud.com/reference/iwd|displaytext=Cloud IWD API}}.
 
A third-party application such as Salesforce or Netsuite can interact with Genesys Cloud IWD through the {{#Widget:ExtLink|link=https://developer.genesyscloud.com/reference/iwd|displaytext=Cloud IWD API}}.
  
You'll need to develop an adapter for your third-party application that can create and stop workitems by using the Cloud IWD API. It should also update information about a workitem, if needed, and be capable of retrieving it, or receiving messages about it if webhooks are configured to communicate back to source systems. (Webhooks must be configured by Genesys.)
+
You must develop an adapter for your third-party application that can create and stop workitems by using the Cloud IWD API. It must be able to:
 +
 
 +
*Update information about a workitem, if needed;
 +
*Retrieve it;
 +
*Receive messages about it if webhooks are configured to communicate back to source systems.
 +
 
 +
(Webhooks must be configured by Genesys.)
  
 
<!--{{AnchorDiv|Configure3rdParty}}
 
<!--{{AnchorDiv|Configure3rdParty}}
Line 49: Line 48:
  
 
===Add a webhook URL for each source system in IWD Manager===
 
===Add a webhook URL for each source system in IWD Manager===
You'll need one webhook URL per source system to be configured so that your source system can receive messages about workitems back from Cloud IWD. You'll need to work with your Genesys representative to configure this.
+
You must configure one webhook URL per source system to be configured so that your source system can receive messages about workitems back from Cloud IWD. Work with your Genesys representative to configure this.
|structuredtextwide=
 
|FAQHeading=
 
 
|Status=No
 
|Status=No
 
}}{{Section
 
}}{{Section
Line 57: Line 54:
 
|anchor=Starting/updating/stoppingaworkitem/interaction
 
|anchor=Starting/updating/stoppingaworkitem/interaction
 
|alignment=Vertical
 
|alignment=Vertical
|Media=
 
|image=
 
 
|structuredtext=The typical workflow is as follows:
 
|structuredtext=The typical workflow is as follows:
  
Line 69: Line 64:
 
*Implicit (recommended)&mdash;stop by invoking Mark Done. For this method, complete the following steps:
 
*Implicit (recommended)&mdash;stop by invoking Mark Done. For this method, complete the following steps:
 
*#{{Link-AnywhereElse|product=PEC-AS|version=Current|manual=ManageCC|topic=Service_Client_options|display text=Set up Agent Desktop to use the Service Client API.}}
 
*#{{Link-AnywhereElse|product=PEC-AS|version=Current|manual=ManageCC|topic=Service_Client_options|display text=Set up Agent Desktop to use the Service Client API.}}
*#Disable the Mark Done button in Agent Desktop (as mentioned earlier in {{Link-AnywhereElse|product=PEC-AS|version=Current|manual=ManageCC|topic=CC_options_overview|display text=Configuring Agent Desktop}}  and instead invoke the '''markdone''' method.
+
*#Disable the '''Mark Done''' button in Agent Desktop (as mentioned earlier in {{Link-AnywhereElse|product=PEC-AS|version=Current|manual=ManageCC|topic=CC_options_overview|display text=Configuring Agent Desktop}}  and instead invoke the '''markdone''' method.
 
*#Set the disposition code by invoking the '''setUserData''' method.
 
*#Set the disposition code by invoking the '''setUserData''' method.
 
*Explicit&mdash;stop by using the IWD API. This requires additional configuration from your Genesys representative.
 
*Explicit&mdash;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.
 
A sample application that demonstrates using the IWD API is also available through your Genesys representative.
|structuredtextwide=
+
|Status=No
|FAQHeading=
+
}}{{Section
 +
|alignment=Vertical
 
|Status=No
 
|Status=No
 
}}
 
}}
 
}}
 
}}

Revision as of 15:33, October 28, 2020

A high-level view of the steps to take to set up Cloud iWD, integrate it with third-party source systems and use the Cloud iWD API to submit workitems to iWD.

High-level process

To implement Cloud iWD, complete the following steps:

  1. Define agents and agent groups.
  2. Configure agent desktop options for your contact center.
  3. Configure Role-Based Access Control (RBAC) for all users of iWD Manager.
  4. Define a routing application in Designer to handle incoming workitems to iWD.
  5. Use iWD Manager to:
    1. Create Endpoints that correspond to the target endpoints created in your Designer routing application.
    2. 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 workitems in each Category are to be handled.
    3. Create Prioritization schemas that control the logic and speed with which workitems are (re-)prioritized both before and after their Service Level Agreement. Associate the schemas to Categories.
    4. 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.
  6. Integrate your source systems to use the Cloud iWD API to submit workitems to Genesys (see Integrating source systems below).
  7. Monitor the activity of your contact center as iWD manages the global queue of workitems.
  8. Manage individual workitems or groups of them while iWD queues and distributes them.
  9. Report on historical contact center activity using Genesys CX Insights. Report on real-time activity through the iWD Manager Monitoring features on the Summary tab and through Pulse.

Integrate

Create an application to submit workitems to Cloud IWD

A third-party application such as Salesforce or Netsuite can interact with Genesys Cloud IWD through the Cloud IWD API.

You must develop an adapter for your third-party application that can create and stop workitems by using the Cloud IWD API. It must be able to:

  • Update information about a workitem, if needed;
  • Retrieve it;
  • Receive messages about it if webhooks are configured to communicate back to source systems.

(Webhooks must be configured by Genesys.)


Add a webhook URL for each source system in IWD Manager

You must configure one webhook URL per source system to be configured so that your source system can receive messages about workitems back from Cloud IWD. Work with your Genesys representative to configure this.

Starting/updating/stopping a workitem

The typical workflow is as follows:

  1. The application creates a workitem through the IWD API.
  2. The application updates the workitem through the IWD API (if needed).
  3. The application stops the workitem.

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:
    1. Set up Agent Desktop to use the Service Client API.
    2. Disable the Mark Done button in Agent Desktop (as mentioned earlier in Configuring Agent Desktop and instead invoke the markdone method.
    3. 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.


Comments or questions about this documentation? Contact us for support!