Installation Prerequisites

All you need to know before you start with Nimbus installation

Before you start

The Nimbus installation requires prior setup for your Tenant. Get in touch with your Customer Success contact. To prepare: 

  • Read the following page carefully as technical details (User Roles, Licensing, Permissions) need to be discussed and set up accordingly.
  • ☝Please note that Nimbus Installation and follow-up Service Provisioning is not possible until your Tenant is configured on Luware side.
 

How Nimbus structures User Roles

Within the MS Teams Client Nimbus will use your existing structures to authenticate any team members as users of Nimbus.

Role Installation-related tasks Related links
TENANT ADMIN

Tenant Admin is required to execute the Nimbus Installation in your company tenant.

The tenant admin

Tenant admins or users with similar roles in your company start with the prerequisites on this page and related pages such as Nimbus Installation and Service Provisioning.

 

After the Installation, you might want to learn about the Administration UI. It is accessible via the following admin panel URLs:

INC Nimbus Admin URLs

Switzerland 01 https://admin.luware.cloud/
Germany 01 https://admin.dewe-01.luware.cloud/
Germany 02 https://admin.dewe-02.luware.cloud/
UK 01 https://admin.ukso-01.luware.cloud/
Nimbus Admin Panel URL

✅ Make sure to configure your web proxies to allow access to these domains or whitelist the complete *.luware.cloud domain.

TEAM OWNER

Team Owner is a service administrator in Nimbus. A team owner

  • can add the Nimbus application to the Teams Client when the Nimbus Installation is complete.
  • can execute Service Provisioning (may require tenant administrator assistance where highlighted).
  • can change Service Settings. Certain settings need to be approved by the tenant admin.

Team owners will mainly interact with Configuration and Service Settings on their related services.

 

Being involved with building new Nimbus service teams, it's important for team owners to know about the different Service types and how users are assigned. Nimbus currently syncs your Tenant users in the following ways.

TEAM MEMBERS

Team Member is a service user (or agent) in Nimbus.

A team member

Team members are primarily involved in the Usage of Nimbus. In the same way as team owners, they access the UI via the following portal URLs:

INC Nimbus Portal URLs

Switzerland 01 https://portal.luware.cloud/
Germany 01 https://portal.dewe-01.luware.cloud/
Germany 02 https://portal.dewe-02.luware.cloud/
UK 01 https://portal.ukso-01.luware.cloud/
Nimbus Portal URLs

✅ Make sure to configure your web proxies to allow access to these domains or whitelist the complete *.luware.cloud domain.

GUEST MEMBERS

Do not exist in Nimbus. None – Unauthenticated guest members have no access to Nimbus features.

Nimbus Licensing Structure

Nimbus Services, Users and Addons are individually licensed. During your onboarding – or whenever you decide to change your license count – your Customer Success contact will discuss License Management details with you.

Service Types

☝ Depending on your service type chosen the set of Nimbus Features varies. Before you continue with your first Service Provisioning we strongly recommend to inform yourself about the available types of services, as it ties directly into both your licensing, related configuration effort and how (future) users are onboarded into your service.

A comparison Nimbus service types

INC Nimbus Service Types

  Advanced Routing Enterprise Routing Contact Center
Description By default, Nimbus is provisioned as an "Advanced Routing" service. Enterprise Routing offers more workflow flexibility and additional call context support. Contact Center offers skill-based routing outside of single-service constraints with high user flexibility. Prioritize your calls to create VIP- and Emergency hotlines.
Target audience Collaborative teams and customer services requiring flexibility with minimal setup effort. Extended teams with dedicated support and sales capabilities, tied into external CRM / Service Desk systems. Contact Centers or Priority Services with "Agents" that are capable of handling specialized tasks regardless of customer time zone or service called.
Configurable Nimbus Features
  • User groups and service users are directly tied into the channel system of MS Teams and sync automatically.
  • For each of your services, you can freely configure Opening Hours and Workflows.
  • Each user gets easy access to the Nimbus Personal App and Nimbus Teams Tab, seamlessly integrated into the MS Teams client experience.
  • Enables customizable agents with indivdiual Responsibility Profiles.
  • Define dynamic teams based on skills and advanced User Roles instead of relying on fixed MS Teams / Member / Owner structures.
  • Access to customizable Dashboards with individual widgets and filters for KPI monitoring.
  • Allows for After-Call-Work (ACW) to shield users from further tasks, configured individually in the Distribution Service Settings.
  • Enables User States tracking for extended Reporting capabilities.
Call distribution
  • Based on the "QueueWorkflow settings and user presence status.
  • Tasks are distributed to all users equally (round-robin, longest-idle first).
  • Workflows allow flexible routing between services, each with their own distribution type, IVR, and set of opening hours.
  • Adds dynamic task handling to workflows. Allows checking and reacting to a caller's queue status, e.g. to re-distribute long-waiting tasks to backup services.
  • Optionally, tasks can be handled on a "first-to-pick-up" basis for higher throughput.
  • Enables skill-based user routing. Freely allows you to define your Skills and Responsibilities as criteria for call distribution.
  • Calls are distributed based on Distribution Policies in your services which ensure that users with the matching skills are pooled dynamically.
 
 
 

Script Execution and Impersonation Permissions

Nimbus is deployed and (re)configured using PowerShell scripts. Please note:

  • You need tenant admin permissions to use PowerShell for Nimbus deployment.  
    🔍 For more information, see Provisioning via Microsoft PowerShell
  • On first script run, we highly recommend starting the PowerShell session as administrator to ensure that necessary dependencies are installed. Our scripts will retrieve dependencies automatically and install them on your running PC if necessary.
  • A re-execution is needed for every service team deployment or service update as the changes need to be pushed to Azure.

External Communication and MS Teams Presence

INC Nimbus External Access Requirement

EXTERNAL ACCESS REQUIRED

TENANT ADMIN You need your tenant to allow external communications with the "luware.com" domain.

 Learn more about managing external access

🔍 The necessary configuration steps are described in the Microsoft Teams Documentation: Manage external Access.

 
 

You will also need to disable the "Enhanced Presence Privacy Mode" policy which prevents visibility of the Teams Presence.

About the "Enhanced Presence Privacy Mode"

The "Enhanced Presence Privacy Mode" is a global configuration which, if enabled, prevents all external organizations from viewing the Teams Presence status of your users via Teams Federation.

If this mode is enabled, Nimbus will see all users as permanently Offline, and thus won't be able to distribute calls to them.

☝ This is a legacy configuration option used in Lync / Skype for Business which is not available anymore in the Microsoft Teams Admin Center. It can only be viewed and configured via PowerShell. As  a global setting it applies to all users and cannot be deactivated or bypassed for individual users.

✅ To check whether this is enabled in your tenant by running the following PowerShell command:

Get-CsPrivacyConfiguration | Select EnablePrivacyMode

The command will return "True" if the Enhance Presence Privacy Mode is enabled, or "False" (default value) if it is disabled.

✅ To deactivate it, run the following PowerShell command:

Set-CsPrivacyConfiguration -EnablePrivacyMode $false

🤔 Why are these steps necessary? Without being able to read the Teams presence data of your users, Nimbus will consider them as Offline and thus not available for call distribution. They will not be able to receive any inbound calls or place any outbound calls via Nimbus.

 
 
 

Nimbus SignalR WebProxy Requirement

WEBPROXY: ALLOW SIGNALR FOR STATUS UPDATES

❌ Blocking SignalR has direct impact on call information, user experience and reporting.

Luware Nimbus and related Apps use Microsoft SignalR to communicate content updates to connected clients immediately, rather than having the server wait for a client to request new data.

→ To allow your Nimbus UI to correctly reflect data updates, ensure that your WebProxy does not block connections to the following destination:

wss://*.signalr.net 

If you do not like to whitelist entire domains with wildcards and know your Nimbus cluster location, you can allow the following destinations instead:

lu-sigr-prod-nimbus-chno-01.service.signalr.net
lu-sigr-prod-nimbus-dewe-01.service.signalr.net
lu-sigr-prod-nimbus-dewe-02.service.signalr.net
lu-sigr-prod-nimbus-ukso-01.service.signalr.net

🤔 What are the effects of a blocked SignaIR path? There will be 30-45s update delays on the Nimbus frontend until a workaround method to receive the data is found. 

 

 

PSTN Licensing

Transfer to PSTN limitation

TRANSFER TO PSTN LIMITATION

Out of the box, Nimbus and related addons can only perform PSTN transfers according to Microsoft's licensing and constraints.

Which PSTN license do I need to acquire?

As of 2023, "Microsoft Teams Phone Standard" licenses are no longer supported by Microsoft. Previously, those licenses were viable for Nimbus. Regardless if you are using Direct Routing, Calling Plans, Operator Connect, the "Microsoft Teams Phone Resource Account" license is now always required. 

Your Setup Required License
Direct Routing "Microsoft Teams Phone Resource Account"
 
Calling Plan "Microsoft Teams Phone Resource Account"
+ "Microsoft Teams Domestic Calling Plan" or "Microsoft Teams Domestic and International Calling Plan" or "Microsoft Teams Calling Plan pay-as-you-go"
+ "Communication Credits" (if these aren't already included as part of your plan)
Operator Connect
 
"Microsoft Teams Phone Resource Account"

Please note that Luware staff cannot give recommendations on which license plan is best suited for your needs. Depending on your scenario, additional Teams App licenses may be required. Exact details are to be discussed with your Microsoft contacts.


Also see: https://learn.microsoft.com/en-us/microsoftteams/teams-add-on-licensing/virtual-user

 
 

How does PSTN licensing affect service and call transfers?

Assuming that Service A has a PSTN license assigned - but further Services don't - the following scenario may unfold:

Scenario A - Service A workflow is configured to transfer the caller to Service B. The license of Service A is used, the PSTN transfer occurs. The PSTN license is re-used throughout further transfers to Services C...D…x…and so on.

Scenario B - Service B is called directly instead. Now the workflow of Service B attempts a redirect to either service A or transfer to C. The PSTN transfer fails due to a missing license on Service B.

🌟Learnings:

  • For one first-level-response service: If you handle first-response calls always via the same service, you need a PSTN license for that particular first-level service.
  • For multiple first-level-response services: If you handle first-response calls always via multiple services, you need a PSTN license for all those first-level services .
  • Nimbus will attempt to use the PSTN license of the first service that responded to a call, regardless of how many further internal service transfers are performed thereafter.
  • If no PSTN license is found on a service that requires it for a transfer, the transfer task will be considered as failed and treated accordingly by the system (e.g. workflow exit announcement, reporting "transfer failed" outcome).
 
 

☝Note that handling and tracking of running cost for PSTN licenses is outside of the Luware support scope. If you require assistance in extending and/or configuring your Nimbus services for PSTN, our support will gladly assist you:

Luware Support Address

 Luware Website https://luware.com/support/
Luware Helpdesk https://helpdesk.luware.cloud 
Cloud Service Status https://status.luware.cloud/
Luware support contact details
 

 

Phone Number Configuration

When managing your phone numbers for the usage with Nimbus services, please note the following:

  • If you're using Direct Routing (numbers managed outside of Teams), you can assign any phone number to a Nimbus service.
  • If you're using calling plans for Microsoft, you can only assign a Service number type. User (subscriber) type numbers will not work.

Further information can be found in the MSFT documentation Types of phone numbers used for Calling Plans.

 

Design Limitations and Limited Support Scenarios

No assistance for unsupported scenarios

These scenarios may work for Nimbus under certain conditions, but are not officially supported by Luware. Note that our support team cannot assist you in these cases.

 
Scenario Rationale
Operating systems other than Windows 10 or 11 Luware is committed to get the best experience possible for a Windows 10/11 user base. However, Luware is committed to address any requests and concerns and will prioritize its future development based on frequent user feedback.
Mobile device support (Android/iOS) Mobile device support for Nimbus (both Android and iOS) is currently not a focus. However, Luware is committed to address any requests and concerns, and will prioritize its future development based on frequent user feedback.
Teams web client

Design limitation on Microsoft Teams web client

The Teams web client currently has a known limitation that sends a lot of incorrect status updates especially when refreshing the page in the browser. This has a noticeable impact on how Nimbus handles Agent presence, availability, and reporting features.  

Causes and workarounds

Microsoft treats web-based Teams clients' presence status changes differently and with seemingly lower priority. The effects include:

  • Users sporadically appearing as offline
  • Spontaneous switch to an erratic presence status which is apparent in logfiles
  • Multiple status updates within only a few seconds, which increases when the user is refreshing the Teams chat window within the browser

 

Until this is resolved by Microsoft, Luware strongly advises you to exclusively use a locally installed Teams client app for all productive users of your organization.

 
 

 

 

 

Auto Attendant and Call Queues (Teams native)

Transfer to Teams-native auto attendants and call queues

Nimbus does currently not support direct transfers via Blind transfer, Safe transfer, or Consultation Call to either UPN or PSTN numbers of Teams-native Auto Attendants and Call Queues. Any such transfer or consultation attempt will lead to the call being aborted.

Causes and workarounds

This is caused by Microsoft Teams limitations with regards to what voice applications (such as Call Queues, Auto Attendants, and Nimbus) are allowed to do, and cannot be circumvented by Nimbus.


💡 A possible workaround would be to force the call over your direct routing SBC by using an internal dummy number that isn't otherwise associated with any other Teams user or service already. This call would then be routed to your SBC, which can then re-direct it towards the actual number of the Call Queue/Auto Attendant on the Teams side again. As this workaround is dependent on voice infrastructure components outside of Luware's control and support scope, please reach out to your SBC provider or skilled personnel for its implementation

 

💡 The above mentioned workaround is not technically feasible if you are using Microsoft Calling Plans or Operator Connect to provision numbers directly through Teams. Forcing an external reroute as a workaround is not possible with these numbers.

 
 

 

 

 

Virtual desktop infrastructure (VDI)

Using a virtual desktop infrastructure (VDI)  with Nimbus

Nimbus does not directly support a Virtual Desktop Infrastructures (VDI). Users will see themselves unable to log in to neither Nimbus portal or admin URLs.

Causes and workarounds

Instead of logging in to Teams itself, VDIs redirect the user to a browser window for logging in to the Nimbus app. This causes a problem with the login because the token flow doesn't come back to the app within the Teams client. In Nimbus, this poses a security risk and is thus considered a non-supported scenario.

The only solution on a VDI is to train your users to log in to portal.luware.cloud directly, using Nimbus in their browser instead.


💡 Please note that the Luware support cannot assist with your VDI configuration. While this scenario may work with an adapted proxy/component configuration on your tenant, Luware cannot safely guarantee that all customer side VDI configurations work in this scenario.

 
 
 

Table of Contents