Good to know before you start
🤔 What does Assistant do? The Assistant App opens an a frontend UI (Assistant view) and subscribes to incoming calls after logging in. Based on configured Service Call Templates and Direct Call Templates different actions are executed, e.g. opening context in the user's browser or triggering a web-request. → All features are explained on the Assistant page.
🤔 Which Operating Systems are supported? Currently this App is officially supported for Windows 7, 10 and 11.
Preconditions .NET 6.0.x
PRECONDITIONS (.NET 6.0.x)
The Assistant application needs to be configured by your Tenant Administrator first before the application can be used by agents.
In the Nimbus Admin UI |
On each client machine where Assistant is installed |
---|---|
|
Before you run Assistant setup, the following prerequisites need to be installed on each client machine:
|
Preconditions .NET 8.0.x
PRECONDITIONS (.NET 8.0.x)
The Assistant application needs to be configured by your Tenant Administrator first before the application can be used by agents.
In the Nimbus Admin UI |
On each client machine where Assistant is installed |
---|---|
|
Before you run Assistant setup, the following prerequisites need to be installed on each client machine:
|
Upgrading from an older Version
If you are currently running a .NET 6 Nimbus Assistant and you want to upgrade to .NET 8 then you should follow these steps:
- Install the preconditions mentioned above (.NET 8)
- Quit/Terminate the current running NA instance and ensure the process is stopped
- Install the NA Setup (.NET 8)
Installation Steps
There are two ways to install Assistant:
- Option A: Manual setup
- Option B: Silent rollout via Installer Package
Option A: Manual setup of Assistant
✅ Contact the Luware Nimbus Customer Success Team and ask for the Assistant Installer.
✅ These setups are meant to be run on the client machines of your Nimbus users (Agents).
-
Run the MSI and click through the setup
- Configure the following options:
- Select the preferred options
- Choose a folder for logging
- Provide the correct view URI depending on your cluster location:
INC Nimbus Assistant View URLs
Switzerland 01 | https://assistant.ch-01.luware.cloud/ |
---|---|
Switzerland 02 | https://assistant.ch-02.luware.cloud/ |
Germany 01 | https://assistant.dewe-01.luware.cloud/ |
Germany 02 | https://assistant.dewe-02.luware.cloud/ |
United Kingdom 01 | https://assistant.ukso-01.luware.cloud/ |
Australia 01 | https://assistant.aue-01.luware.cloud/ |
West Europe 01 | https://assistant.euwe-01.luware.cloud/ |
East United States 01 | https://assistant.use-01.luware.cloud/ |
✅ Make sure to configure your web proxies to allow access to these domains or whitelist the complete *.luware.cloud domain.
- Proceed until ready to install the client.
- When you finish, launch the application
-
Log in with your O365 account acting as Nimbus/Teams call handling user.
🔍 More details can be found on the Assistant page of our Knowledge Base, focusing on daily use.
Option B: Installer packaging and rollout
✅ Contact the Luware Nimbus Customer Success Team and ask for the Assistant Installer.
✅ Follow this method for rollouts in larger IT environments:
1. Make sure all the ✅ preconditions above on this page are fulfilled on the target machines (fitting .NET version installed).
2. To perform a silent installation of the Assistant client, the following example PowerShell command can be used:
NOTE: POWERSHELL SCRIPT BROKEN OVER FOR BETTER READABILITY
msiexec /i "Nimbus.Assistant.Client.msi" /l "install.txt" /quiet
LOGGING_PATH="C:\Nimbus Assistant Logs\"
NIMBUS_VIEW_URI="https://assistant.luware.cloud/"
AUTORUN=false
LANGUAGE=en
SHOW_TOAST_ON_SERVICE_ACCEPTING_CALL=false
OPEN_LOGIN_WINDOW_ON_STARTUP=false
POSITION=BottomRight
3. ✅ Adjust the msiexec command parameters as needed.
🔍 Also see: https://learn.microsoft.com/en-us/windows-server/administration/windows-commands/msiexec
MSIEXEC Switches | Description | Default Value | Possible Values | ||||||||||||||||
---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|
LANGUAGE | Language | en | en, de, nl, it, fr, es, da | ||||||||||||||||
POSITION | Position | BottomRight | BottomRight, TopRight | ||||||||||||||||
AUTORUN | Starting of NA automatically | true | true, false | ||||||||||||||||
SHOW_TOAST_ON_SERVICE_ACCEPTING_CALL | Showing of Call Flow before accepting | false | false, true | ||||||||||||||||
OPEN_LOGIN_WINDOW_ON_STARTUP | Opening of the login window on application start | true | true, false | ||||||||||||||||
LOGGING_PATH | Path for the log folder | none | Any absolute or relative path. | ||||||||||||||||
ZOOM | Zoom-level of the application | 1 | 1, 1.25, 1.5 | ||||||||||||||||
BRING_TO_FOREGROUND | If the app should come the to front upon Nimbus Events (available from 1.90) | true | true, false | ||||||||||||||||
TOPMOST | If the app should be shown always as topmost window on the screen (available from 1.90) | false | false, true | ||||||||||||||||
USE_AUDIO_FOR_EMAILS | Audio notifications for Email (available from 1.90) | false | false, true | ||||||||||||||||
USE_AUDIO_FOR_EXTERNAL_TASKS | Audio notifications for ET (available from 1.90) | false | false, true | ||||||||||||||||
USE_AUDIO_FOR_INSTANT_MESSAGES | Audio notifications for IM (available from 1.90) | false | false, true | ||||||||||||||||
AUDIO_FOR_EMAILS | Sound for Email notifications (available from 1.90) | n/a | alarm1, alarm2, bell1, bell2, gong1, siren1 | ||||||||||||||||
AUDIO_FOR_EXTERNAL_TASKS | Sound for ET notifications (available from 1.90) | n/a | alarm1, alarm2, bell1, bell2, gong1, siren1 | ||||||||||||||||
AUDIO_FOR_INSTANT_MESSAGES | Sound for IM notifications | n/a | alarm1, alarm2, bell1, bell2, gong1, siren1 | ||||||||||||||||
NIMBUS_VIEW_URI | URL for the webview | 🔍 Adjust the NIMBUS_VIEW_URIs according to your Nimbus cluster: INC Nimbus Assistant View URLs
✅ Make sure to configure your web proxies to allow access to these domains or whitelist the complete *.luware.cloud domain. |
Troubleshooting
If you have problems installing Assistant installation, read the following.
Error during installation
✅ Analysis: Check whether the "dotnet" command can find the required .NET versions.
Open a command prompt (Win+R) and run the following command:
dotnet --list-runtimes
⮑ This should list all the available .NET runtimes and their versions, e.g. like so:
🤔Why do this? The Nimbus Assistant installer is specifically looking for the AspNetCore, NETCore and WindowsDesktop entries for version 6.0.x. or 8.0.x. In the screenshot above, these are installed in the regular "C:\Program Files\" folder, which is where Windows will place application binaries for 64-bit apps. That's what we're looking for. You may see the right versions here, but their folders may show up as C:\Program Files (x86)\
- these contain 32-bit apps and can't be used by Nimbus.
✅Workaround: If the abovementioned case applies, then you need to adjust your system environment settings to make sure that the dotnet command from above will look for the 64-bit apps first instead. The dotnet command will go through the list of configured system paths from top to bottom.
You can see which paths have been registered by running this command in PowerShell:
$Env:Path.Split(';')
For example, this may look like this:
If the path "C:\Program Files (x86)\dotnet\
" is listed here before the "C:\Program Files\dotnet\
" path, this will cause the issue. It would be best to move this entry down the line to make sure that the 64-bit path gets searched first.
Other installation issues
Try running the installer from a command prompt, by executing the following command:
msiexec /i "<Full Path to the Nimbus Assistant Client installer MSI file>" /l*v "<Path to a log file>"
The last parameter ensures that log files get generated from the setup. Go through the installation until the error comes up and then review the contents of the generated log file to see where the installer is hanging. If you cannot troubleshoot it yourself, get in touch with support.
INC Luware Support Address
Luware Website | https://luware.com/support/ |
---|---|
Luware Helpdesk | https://helpdesk.luware.cloud |
Cloud Service Status | https://status.luware.cloud/ |