Install Custom Sessions plugin

Note

Please note that this plugin can only be utilized for AnywhereNow related products.

Warning

Please note that the Custom Session plugin has been replaced by the API plugin and EventForwarder plugin since DC2023.04. To remove any unused settings, please refer to Uninstall Custom Sessions plugin for instructions.

Installation of the plugin per UCC

  1. Log in on the server on which the service is running.
  2. Go to the plug ins folder (‘DRIVE:\program files\core\anywhere365\plugins\'). If it doesn't exist, create it.
  3. Create a folder "CustomSessionPlugin" for the plugins folder.
  4. Copy the dlls and included config files from the plug in package to this folder.

Note

In case the folder is already created and the plug in is in use by the UCC, the UCC will have to be stopped (check if stopping of the UCC is allowed).

Warning

Please note that it is necessary to restart the UCC service in order for the UCC service to use the plugin.

Add Plugin to config

Per UCC

  1. Open file ‘Config.xml’ for editing purposes.

    Tip

    First make a backup of the file to prevent problems!

    The default path of this file is:

    C:\ProgramData\Anywhere365\Core\Service\UnifiedContactCenterService\Config.xml

  2. Add "Plugin" value below ‘SettingsURL’ of the UCC.

    XML
    <Plugin name="CustomSessionPlugin" path="C:\Program Files\Core\Anywhere365\Plugins\CustomSessionPlugin\" file="Wsp.Anywhere365.CustomSessionPlugin.dll" isIdentityPlugin="false" />

For UCC Service

  1. Open file ‘Config.xml’ for editing purposes.

    Tip

    First make a backup of the file to prevent problems!

    The default path of this file is:

    C:\ProgramData\Anywhere365\Core\Service\UnifiedContactCenterService\Config.xml

  2. Add "Plugins" value below ‘Presence Provider’.

    XML
    <Plugins>
    <Plugin name="CustomSessionPlugin" path="C:\Program Files\Core\Anywhere365\Plugins\CustomSessionPlugin\" file="Wsp.Anywhere365.CustomSessionPlugin.dll" isIdentityPlugin="false" />
    </Plugins>

Configure UCC Settings

Note

The settings need to be configured for each UCC using the Custom Sessions Plugin.

PluginSettings list

  1. Open the UCC Config page on SharePoint
  2. Open the PluginSettings list
  3. Add the following settings:
Setting Value Scope
Enabled TRUE CustomSessionPlugin
Uri http://:port CustomSessionPlugin

Note

FQDN = Can be internal facing address (WebAgent Service to UCC Service);

Port = Can be any free port.

Warning

The first UCC to start sets the port number. All subsequent UCCs in the same service must use this port.

Warning

Make sure to leave the fqdn to this service configured as a ".local" URL, especially when using multiple UCC services in the same region. If this is not done, the UCC cannot reach the right webserver internally leading to undesired or non-functional WebAgent behavior.

Restart UCC and validate

  1. Login to the AnywhereNow Application Server

  2. Start Services

  3. Restart "Unified Contact Center"

  4. See the UCC logs if Custom Session Plugin is successfully loaded

    C:\ProgramData\Anywhere365\Core\Service\UnifiedContactCenterService\logs

    Log
    2020-04-28 12:44:09,585 [5] xa DEBUG - CustomSessionPlugin - InitAsync() starting
    2020-04-28 12:44:09,585 [5] xa INFO  - CustomSessionPlugin.InitAsyncInternal
    2020-04-28 12:44:09,601 [5] xa DEBUG - CustomSessionPlugin - InitAsync() completed with result PluginInitializationResult(IsSuccessful=True, RequiredLists=ListConfiguration(ListName=PluginSettings, FieldNames=ID, Title, wsp_ucc_ps_value, wsp_ucc_ps_scope, wsp_ucc_ps_prompt_LookupValue, wsp_ucc_ps_prompt))
    2020-04-28 12:44:09,601 [5] xa INFO  - PluginManager::StartAsync initialized [CustomSessionPlugin]. Will attempt to provide with lists [PluginSettings]