GAMD/Current/Admin/ConfigCIF2 - Revision history

WikiSysop at 00:00, July 31, 2022

2022-07-31T00:00:51Z

Margarethe.nitzsche@softphone.it: Published

2021-08-02T15:13:57Z

Published

Margarethe.nitzsche@softphone.it: Published

2021-05-25T13:55:15Z

Published

Margarethe.nitzsche@softphone.it: Published

2021-04-06T07:35:08Z

Published

New page

{{Article
|Standalone=No
|DisplayName=Configuration with Channel Integration Framework (CIF) version 2.0
|TocName=Configuration with CIF V2.0
|Context=Procedure to configure the Adapter with CIF V2.0.
|ComingSoon=No
|Section={{Section
|alignment=Vertical
|structuredtext=If you have already {{Link-SomewhereInThisVersion|manual=Admin|topic=Install365|display text=installed the Gplus Adapter}}, the following procedure explains how to configure the Microsoft Dynamics 365 Channel Integration Framework (CIF) application version 2.0.

{{NoteFormat|Before proceeding with the following steps, make sure your Microsoft Dynamics 365 has been configured with '''Channel Integration Framework (CIF) version 2.0'''. If it has not, comply with the following external page's indications: [https://docs.microsoft.com/it-it/dynamics365/customer-service/channel-integration-framework/get-channel-integration-framework/ How to get Dynamics 365 Channel Integration Framework].}}

#Open the CIF application by clicking the Microsoft Dynamics 365 '''list menu''' and selecting '''Channel Integration Framework'''.
#Create a new channel provider by clicking '''+ New'''.
#Provide the following parameters:
#*'''Name:''' any name
#*'''Label:''' Gplus Adapter for MS Dynamics 365
#*'''Channel URL:''' <nowiki>https://<DynamicsDomain>/softphon_index_wwe.html</nowiki>
#*'''Enable Outbound Communication:''' Yes/No
#*'''Channel Order:''' 1
#*'''API Version:''' 1.0
#*'''Trusted Domain:'''
#*'''Custom Parameters:''' {"CustomFlow": true, "CustomerPrefix": "softphon", "MakeCall": true, "InstanceURL": <nowiki>"https://localhost7777"</nowiki>, "Logo": "/webresources/softphon_microsoft.png", "Width": 450, "JustMe": true, "Language": "en-En"}
{{NoteFormat|When filling out the '''Channel URL''' field, you have to replace <DynamicsDomain> with your own Microsoft Dynamics 365 domain.}}
{{NoteFormat|When filling out the '''Custom Parameters''' field:
*Set the "CustomFlow" value to true to allow customization; if this value is set to false, the Adapter will use the out-of-the-box use cases.
*Replace the "CustomerPrefix" value with your own.
*Set the "JustMe" value to true for the Adapter to be displayed; if this value is set to false, the Adapter will only be displayed in the case of a new interaction.
*Choose any "Language" supported by the Genesys Toolkit: replace the string value with one of those listed on the [https://developer.genesyscloud.com/reference/workspace-toolkit/api-reference/#a-idauthanamespace-auth/ Workspace Toolkit API] page.|}}
The following procedure explains how to configure the '''softphon_iwsconfigCIFWWEv2.js JavaScript file''':

#Select the Web Resources Zip File ('''GplusD365forCIF.zip''').
#Open '''softphon_iwsconfigCIFWWEv2.js''':

<br /><syntaxhighlight lang="javascript" line="1">
var params = {
context: this,
integrationType: "wwe",
layoutType: "widget",
stylePath: "/webresources/softphon_wwe_mainstyle.css",
instance: window.Softphone.InstanceURL,
layoutPath: "/webresources/softphon_wwe_mainui.html",
branding: window.Softphone.Logo,
plugins: [
{ path: "/webresources/softphon_wwe_mainui.js",
className: "mainui",
objectName: "mainui",
parameters: { "topView": "CommunicatorView"}
},
{ path: "/webresources/softphon_wwe_interactionbar.js",
className: "interactionbar",
objectName: "interactionbar",
parameters: { "TOOLTIP": { "voice": "callType,direction,call.state,call.phoneNumber"} }
}
]
};log.setLogLevel(enumloglevel.debug);
$(document).ready(function(){
iwscore.initCTI(params);
iwscore.enableCTI();
});
</syntaxhighlight>
{{{!}} class="wikitable"
{{!}}+
!Key
!Value
!Description
{{!}}-
{{!}}branding
{{!}}default: window.Softphone.Logo
possible value: any valid logo web resources (for example "/webresources/softphone_microsoft.png")
{{!}}default: logo is retrieved from CIF configuration
possible value: path where the file name is stored
{{!}}-
{{!}}topView
{{!}}default: CommunicatorView
possible value: CommunicatorView, PerformanceTrackerView
{{!}}possibility to visualize menu buttons outside the list menu
{{!}}}
If you are interested in screen pop configuration, check {{Link-SomewhereInThisVersion|manual=Admin|topic=ConfigSP}}.
|Status=No
}}
}}

@@ Line 6: / Line 6: @@
 |ComingSoon=No
 |Section={{Section
 |alignment=Vertical
 |structuredtext=If you have already {{Link-SomewhereInThisVersion|manual=Admin|topic=Install365|display text=installed the Gplus Adapter}}, the following procedure explains how to configure the Microsoft Dynamics 365 Channel Integration Framework (CIF) application version 2.0.
@@ Line 46: / Line 47: @@
 {{NoteFormat|&lt;prefix&gt; is an example of how the profile can be named. When filling out the '''Unique name''' field, you have to replace &lt;prefix&gt; with your organization name.}}
 {{NoteFormat|When filling out the '''Channel URL''' field, you have to replace &lt;DynamicsDomain&gt; with your own Microsoft Dynamics 365 domain.}}
+{{NoteFormat|When filling out the '''Custom Parameters''' field, you have to replace &lt;EngageCloudinstanceURL&gt; with your own (for example <nowiki>"https://gwa-usw4.genesyscloud.com/ui/wwe/api.js"</nowiki>). Please not that it is important to include the full path to api.js toolkit api javascript library.|}}
 *'''Save''' and go back to '''App Profiles''' in Power Apps.
 *Click again '''+ Add channel providers''' in the '''Voice channel''' providers box, then start typing your provider's name and it will be displayed. Click it and it will automatically be saved.

@@ Line 8: / Line 8: @@
 |alignment=Vertical
 |structuredtext=If you have already {{Link-SomewhereInThisVersion|manual=Admin|topic=Install365|display text=installed the Gplus Adapter}}, the following procedure explains how to configure the Microsoft Dynamics 365 Channel Integration Framework (CIF) application version 2.0.
-{{NoteFormat|Before proceeding with the following steps, make sure your Microsoft Dynamics 365 has been configured with '''Channel Integration Framework (CIF) version 2.0'''. If it has not, comply with the following external page's indications: [https://docs.microsoft.com/it-it/dynamics365/customer-service/channel-integration-framework/get-channel-integration-framework/ How to get Dynamics 365 Channel Integration Framework].}}
+*Navigate to the [https://make.powerapps.com/ Make Power Apps] website and log in with the same system administrator’s credentials.
-#Open the CIF application by clicking the Microsoft Dynamics 365 '''list menu''' and selecting '''Channel Integration Framework'''.
+*Provide the following parameters:
-#Create a new channel provider by clicking '''+ New'''.
+**'''Name:''' any name
-#Provide the following parameters:
+**'''Unique Name:''' &lt;prefix&gt;_anyname
-#*'''Name:''' any name
+**'''Label:''' Gplus Adapter for MS Dynamics 365
-#*'''Label:''' Gplus Adapter for MS Dynamics 365
+**'''Channel URL:''' <nowiki>https://&lt;DynamicsDomain&gt;/webresources/softphon_CIFWWEv2.html</nowiki>
-#*'''Channel URL:''' <nowiki>https://&lt;DynamicsDomain&gt;/webresources/softphon_CIFWWEv2.html</nowiki>
+**'''Enable Outbound Communication:''' Yes/No
-#*'''Enable Outbound Communication:''' Yes/No
+**'''Channel Order:''' 1
-#*'''Channel Order:''' 1
+**'''API Version:''' 2.0
-#*'''API Version:''' 1.0
+**'''Trusted Domain:'''
-#*'''Trusted Domain:'''
+**'''Custom Parameters:''' {"InstanceURL": &lt;Engage Cloud Instance URL&gt;, "Logo": "/webresources/softphon_microsoft.png", "Width": 470}
-#*'''Custom Parameters:''' {"CustomFlow": true, "CustomerPrefix": "softphon", "MakeCall": true, "InstanceURL": <nowiki>"https://localhost7777"</nowiki>, "Logo": "/webresources/softphon_microsoft.png", "Width": 450, "JustMe": true, "Language": "en-En"}
+**'''Enable Analytics:''' Yes/No
 {{NoteFormat|When filling out the '''Channel URL''' field, you have to replace &lt;DynamicsDomain&gt; with your own Microsoft Dynamics 365 domain.}}
-#Select the Web Resources Zip File ('''GplusD365forCIF.zip''').
+*'''Save''' and go back to '''App Profiles''' in Power Apps.
-#Open '''softphon_iwsconfigCIFWWEv2.js''':
+*Click again '''+ Add channel providers''' in the '''Voice channel''' providers box, then start typing your provider's name and it will be displayed. Click it and it will automatically be saved.
 <br /><syntaxhighlight lang="javascript" line="1">
@@ Line 78: / Line 116: @@
 {{!}}}
 If you are interested in screen pop configuration, check {{Link-SomewhereInThisVersion|manual=Admin|topic=ConfigSP}}.
 |Status=No
 }}
 }}