Remote action configuration

This document provides comprehensive information about the introduction and concepts around Nexthink Chatbot SDK, its API and use cases. The information contained herein is subject to change without notice and is not guaranteed to be error-free. If you find any errors, please report them to us via Nexthink Support Portal. This document is intended for readers with a detailed understanding of Nexthink technology.

This software and related documentation are provided under a license agreement containing restrictions on use and disclosure and are protected by intellectual property laws. Except as expressly permitted in your license agreement or allowed by law, you may not use, copy, reproduce, translate, broadcast, modify, license, transmit, distribute, exhibit, perform, publish, or display any part, in any form, or by any means. Reverse engineering, disassembly, or decompilation of this software, unless required by law for interoperability, is prohibited.

Overview

Remote actions can be used for both diagnoses to detect issues and remediations to fix issues.

Required content library for out-of-the-box topics

You can use the out-of-the-box topics catalog that includes a list of remote actions, campaigns, scores and categories from the Chatbot Content Pack available in Nexthink Library. The content pack includes official remote actions that are a part of other library packs described in the Other content libraries documentation.

Remote action settings

Once the content pack has been imported, the additional configuration must be done in Finder.

Manual triggering

You must enable the remote actions used for diagnosis and remediation in Finder for manual triggering. This can be done by checking the box and saving the remote action.

For out-of-the-box topics, the list of remote actions that require manual triggering is as follows:

Automatically triggered remote actions

One important aspect of the remote actions used in diagnosis is that the values can be cached internally by Chatbot SDK to speed up the conversation with the chatbot user. In order for this cache to be populated, the remote action must be scheduled in Finder to run automatically on a number of devices.

For out-of-the-box topics, the list of remote actions which require scheduling for automatic execution is the following:

Campaign configuration

Depending on the desired employee experience, the campaigns which are available for each remote action can be disabled. Please note that they are enabled by default.

There are three possibilities when dealing with two campaigns:

  1. Remove all the campaigns, all the information is exchanged in the chat channel or other mechanisms.

  2. Leave the notification campaign to get confirmation from the user to apply a change and another one after the change is applied.

  3. Remove the initial campaign, since the confirmation has been given in the chat channel and leave the notification after the change is applied.

To remove a campaign, write zeros in the related CampaignID parameter in Finder.

Adding remote actions

When adding new remote actions as part of a topic configuration, follow these steps:

  • Configure the new remote actions in Finder. Define if they need to be executed manually or automatically, as explained in the Remote actions settings.

  • If they are diagnosis remote actions or remediation remote actions that will be launched online and configured to be launched manually in Finder, add them to the /var/nexthink/nexthink-chatbot-adapter/config/topics/remote_actions.yaml file.

Code
$ vi /var/nexthink/nexthink-chatbot-adapter/config/topics/remote_actions.yaml 

Remote_action_name_in_topic: 
  name: Name in Finder   
  uid: UID from Finder 

Note that both the Remote_action_name_in_topic and remote action name in Finder are case-sensitive.

  • You must restart the containers to apply the changes in Chatbot SDK:

$ ./scripts/nexthink-chatbot-adapter-restart.sh

Limitations

The limitations of the Act module are described in the online documentation and are applicable to Chatbot SDK.

Last updated