(Created page with "<translate>= Configuring Screen Pop for Preview Campaigns = When you have successfully integrated your Dynamics instance with your contact center, note that it is possible to...") |
(Updated via BpDeleteTranslateTags script) |
||
| (8 intermediate revisions by 2 users not shown) | |||
| Line 1: | Line 1: | ||
| − | + | = Configuring Screen Pop for Preview Campaigns = | |
When you have successfully integrated your Dynamics instance with your contact center, note that it is possible to pop specific [[#How_do_I_locate_the_object_ID?|objects]] in your instance. Popping objects is made possible by including Dynamics object IDs in a [[#1._Create_a list_with_a_column_for_Dynamics_object_IDs|list]]. The following tutorial will outline the steps required to make this possible. | When you have successfully integrated your Dynamics instance with your contact center, note that it is possible to pop specific [[#How_do_I_locate_the_object_ID?|objects]] in your instance. Popping objects is made possible by including Dynamics object IDs in a [[#1._Create_a list_with_a_column_for_Dynamics_object_IDs|list]]. The following tutorial will outline the steps required to make this possible. | ||
| − | == | + | == Workflow == |
| − | If you have not already done so, you will need to take the steps required to configure a Dynamics instance in your Bright Pattern contact center. To do this, see the following articles: | + | If you have not already done so, you will need to take the steps required to configure a Dynamics instance in your Bright Pattern contact center. |
| + | |||
| + | To do this, see the following articles: | ||
| + | |||
* [[microsoft-dynamics-365-integration-guide/Configuration/Prerequisites | Prerequisites]] | * [[microsoft-dynamics-365-integration-guide/Configuration/Prerequisites | Prerequisites]] | ||
* [[Microsoft-dynamics-365-integration-guide/Configuration/EnableScenariosAccessDynamics365 | Configuration Section A: Enable Scenarios and Access to Dynamics 365]] | * [[Microsoft-dynamics-365-integration-guide/Configuration/EnableScenariosAccessDynamics365 | Configuration Section A: Enable Scenarios and Access to Dynamics 365]] | ||
| Line 11: | Line 14: | ||
Additionally, your outbound campaign will require a configured [[Contact-center-administrator-guide/Directory/Dial-outEntries|dial-out entry]]. | Additionally, your outbound campaign will require a configured [[Contact-center-administrator-guide/Directory/Dial-outEntries|dial-out entry]]. | ||
| − | == 1. Create a list with a column for Dynamics object IDs == | + | == Prerequisite == |
| − | + | This section, in specific, is required to complete the following tutorial: | |
| + | |||
| + | * [[Microsoft-dynamics-365-integration-guide/Configuration/EnableAgentDesktopIntegration | Configuration Section B: Enable Agent Desktop Integration]] | ||
| + | |||
| + | == 1. Create a list with a column for Dynamics object IDs == | ||
| + | The only required parameter for the ''Dynamics preview pop'' is the ''object id''. The ''object id'' must come from the list. | ||
| + | |||
| + | Build and configure a [[Contact-center-administrator-guide/Lists|list]] with a column that contains the object IDs you want to pop in your Dynamics instance. These objects will pop when the corresponding preview record is sent to a logged-in agent. Note that you can pop any object [[Scenario-builder-reference-guide/ScenarioBlocks/MicrosoftDynamicsScreenPop#Object_type|supported by Bright Pattern]] (e.g., account, contact, invoice, order, etc.) For more information about configuring lists, see the ''Contact Center Administrator Guide'', section [[Contact-center-administrator-guide/Lists|Lists]]. | ||
| Line 18: | Line 28: | ||
| − | === How do I locate the object ID? === | + | === How do I locate the object ID? === |
Each object in your Dynamics instance has a unique identifier; object IDs are included in the object's URL. For example, if you want to find the unique ID for a '''contact''' object, you can find the ID at the end of the URL. | Each object in your Dynamics instance has a unique identifier; object IDs are included in the object's URL. For example, if you want to find the unique ID for a '''contact''' object, you can find the ID at the end of the URL. | ||
| Line 30: | Line 40: | ||
| − | == 2. Configure an outbound Preview campaign == | + | == 2. Configure an outbound Preview campaign == |
| − | Next, | + | Next, create an [[Contact-center-administrator-guide/ServicesandCampaigns/ServicesandCampaignsOverview#Outbound_Voice|outbound voice]] service and configure the [[Contact-center-administrator-guide/ServicesandCampaigns/Outbound-General#Preview_Options|Preview]] [[Tutorials-for-admins/Services/OutboundPreviewCampaign/Overview | campaign]]. |
| − | When configuring your outbound Preview campaign, make sure to do the following: | + | <!--When configuring your outbound Preview campaign, make sure to do the following: |
* Add teams in [[Contact-center-administrator-guide/ServicesandCampaigns/AssignmentsTab#Teams|Assignments]] | * Add teams in [[Contact-center-administrator-guide/ServicesandCampaigns/AssignmentsTab#Teams|Assignments]] | ||
* Attach the uploaded list with the Dynamics object IDs in [[Contact-center-administrator-guide/ServicesandCampaigns/ListsTab|Lists]] and [[Contact-center-administrator-guide/ServicesandCampaigns/ListsTab#Enabled|enable]] it | * Attach the uploaded list with the Dynamics object IDs in [[Contact-center-administrator-guide/ServicesandCampaigns/ListsTab|Lists]] and [[Contact-center-administrator-guide/ServicesandCampaigns/ListsTab#Enabled|enable]] it | ||
| Line 40: | Line 50: | ||
* In ''Outbound > Calling Hours'', configure [[Contact-center-administrator-guide/ServicesandCampaigns/Outbound-CallingHours#To_define_a_schedule|calling hours]] and [[Contact-center-administrator-guide/ServicesandCampaigns/Outbound-CallingHours#To_apply_the_schedule_to_a_particular_phone_type|Phones to call, by preference]] | * In ''Outbound > Calling Hours'', configure [[Contact-center-administrator-guide/ServicesandCampaigns/Outbound-CallingHours#To_define_a_schedule|calling hours]] and [[Contact-center-administrator-guide/ServicesandCampaigns/Outbound-CallingHours#To_apply_the_schedule_to_a_particular_phone_type|Phones to call, by preference]] | ||
* In ''Outbound > DNC'', configure your [[Contact-center-administrator-guide/ServicesandCampaigns/Outbound-DNC|Do Not Call lists]] | * In ''Outbound > DNC'', configure your [[Contact-center-administrator-guide/ServicesandCampaigns/Outbound-DNC|Do Not Call lists]] | ||
| + | --> | ||
If you have issues configuring your campaign, make sure to resolve any configuration checks listed in [[Contact-center-administrator-guide/ServicesandCampaigns/Outbound-Diagnostics|Outbound > Diagnostics]]. | If you have issues configuring your campaign, make sure to resolve any configuration checks listed in [[Contact-center-administrator-guide/ServicesandCampaigns/Outbound-Diagnostics|Outbound > Diagnostics]]. | ||
| Line 47: | Line 58: | ||
| − | == 2a. Configure the Screenpop URL == | + | == 2a. Configure the Screenpop URL == |
In ''Outbound > General'', configure the [[Contact-center-administrator-guide/ServicesandCampaigns/Outbound-General#Screenpop_URL|Screenpop URL]] using the following format: | In ''Outbound > General'', configure the [[Contact-center-administrator-guide/ServicesandCampaigns/Outbound-General#Screenpop_URL|Screenpop URL]] using the following format: | ||
| − | SHOW_OBJECT:$(workitem.otherInfo.XXX):object | + | |
| + | SHOW_OBJECT:$(workitem.otherInfo.XXX):object | ||
Note that ''SHOW_OBJECT'' must be included. The variable [[Scenario-builder-reference-guide/VariablesandExpressions/Variables#.24.28workitem.otherInfo.29|$(workitem.otherInfo)]] must append the name of the column that contains the Dynamics object IDs (i.e., ''.XXX'') to the end of the variable. The ''object'' is the type of object that is being popped (e.g., account, case, lead, etc.). | Note that ''SHOW_OBJECT'' must be included. The variable [[Scenario-builder-reference-guide/VariablesandExpressions/Variables#.24.28workitem.otherInfo.29|$(workitem.otherInfo)]] must append the name of the column that contains the Dynamics object IDs (i.e., ''.XXX'') to the end of the variable. The ''object'' is the type of object that is being popped (e.g., account, case, lead, etc.). | ||
| Line 57: | Line 69: | ||
For example, if you want to pop a '''contact''' object, your Screenpop URL will look like this: | For example, if you want to pop a '''contact''' object, your Screenpop URL will look like this: | ||
| − | SHOW_OBJECT:$(workitem.otherInfo.dyn_id):contact | + | |
| + | SHOW_OBJECT:$(workitem.otherInfo.dyn_id):contact | ||
In our example, the list column containing the Dynamics contact object IDs is named ''dyn_id'', and ''contact'' is the object type. | In our example, the list column containing the Dynamics contact object IDs is named ''dyn_id'', and ''contact'' is the object type. | ||
| Line 65: | Line 78: | ||
| − | == 3. Start the campaign == | + | == 3. Start the campaign == |
In ''Outbound > General'', [[Contact-center-administrator-guide/ServicesandCampaigns/Outbound-General#Start_.2F_Stop_Automation|start the campaign]]. When your agents are logged into the Agent Desktop widget in your Dynamics instance, when a contact record is sent to them, the corresponding object in Dynamics should pop as well. | In ''Outbound > General'', [[Contact-center-administrator-guide/ServicesandCampaigns/Outbound-General#Start_.2F_Stop_Automation|start the campaign]]. When your agents are logged into the Agent Desktop widget in your Dynamics instance, when a contact record is sent to them, the corresponding object in Dynamics should pop as well. | ||
| Line 72: | Line 85: | ||
| − | == Troubleshooting == | + | == Troubleshooting == |
If you are having trouble getting your objects to pop, you can hardcode an object ID in place of the variable in the Screenpop URL. Hardcoding the object ID allows you to ensure the feature is functioning properly. For example, if you want to test pop a '''contact''' object, enter the unique contact ID in the following way: | If you are having trouble getting your objects to pop, you can hardcode an object ID in place of the variable in the Screenpop URL. Hardcoding the object ID allows you to ensure the feature is functioning properly. For example, if you want to test pop a '''contact''' object, enter the unique contact ID in the following way: | ||
| − | SHOW_OBJECT:00aa0000-a0a0-a000-a00a-000a0a000a00:contact | + | |
| − | + | SHOW_OBJECT:00aa0000-a0a0-a000-a00a-000a0a000a00:contact | |
| − | |||
| − | |||
| − | |||
Latest revision as of 04:02, 29 May 2024
Configuring Screen Pop for Preview Campaigns
When you have successfully integrated your Dynamics instance with your contact center, note that it is possible to pop specific objects in your instance. Popping objects is made possible by including Dynamics object IDs in a list. The following tutorial will outline the steps required to make this possible.
Workflow
If you have not already done so, you will need to take the steps required to configure a Dynamics instance in your Bright Pattern contact center.
To do this, see the following articles:
- Prerequisites
- Configuration Section A: Enable Scenarios and Access to Dynamics 365
- Configuration Section B: Enable Agent Desktop Integration
- Reference: How to Add an Integration Account in Bright Pattern
Additionally, your outbound campaign will require a configured dial-out entry.
Prerequisite
This section, in specific, is required to complete the following tutorial:
1. Create a list with a column for Dynamics object IDs
The only required parameter for the Dynamics preview pop is the object id. The object id must come from the list.
Build and configure a list with a column that contains the object IDs you want to pop in your Dynamics instance. These objects will pop when the corresponding preview record is sent to a logged-in agent. Note that you can pop any object supported by Bright Pattern (e.g., account, contact, invoice, order, etc.) For more information about configuring lists, see the Contact Center Administrator Guide, section Lists.
How do I locate the object ID?
Each object in your Dynamics instance has a unique identifier; object IDs are included in the object's URL. For example, if you want to find the unique ID for a contact object, you can find the ID at the end of the URL.
Should you wish to access the IDs of all existing contacts, export your contacts to an Excel document. Open the document, then Unhide columns A through C; the unique IDs will be in column A.
2. Configure an outbound Preview campaign
Next, create an outbound voice service and configure the Preview campaign.
If you have issues configuring your campaign, make sure to resolve any configuration checks listed in Outbound > Diagnostics.
2a. Configure the Screenpop URL
In Outbound > General, configure the Screenpop URL using the following format:
SHOW_OBJECT:$(workitem.otherInfo.XXX):object
Note that SHOW_OBJECT must be included. The variable $(workitem.otherInfo) must append the name of the column that contains the Dynamics object IDs (i.e., .XXX) to the end of the variable. The object is the type of object that is being popped (e.g., account, case, lead, etc.).
For example, if you want to pop a contact object, your Screenpop URL will look like this:
SHOW_OBJECT:$(workitem.otherInfo.dyn_id):contact
In our example, the list column containing the Dynamics contact object IDs is named dyn_id, and contact is the object type.
3. Start the campaign
In Outbound > General, start the campaign. When your agents are logged into the Agent Desktop widget in your Dynamics instance, when a contact record is sent to them, the corresponding object in Dynamics should pop as well.
Troubleshooting
If you are having trouble getting your objects to pop, you can hardcode an object ID in place of the variable in the Screenpop URL. Hardcoding the object ID allows you to ensure the feature is functioning properly. For example, if you want to test pop a contact object, enter the unique contact ID in the following way:
SHOW_OBJECT:00aa0000-a0a0-a000-a00a-000a0a000a00:contact