Call Handling

How to configure and handle incoming calls as a user

Handling calls in Nimbus leverages MS Teams call features in both Inbound Service Calls and Outbound Call direction. The main difference is that Nimbus is establishing a Conference between you as Team Member (also called Nimbus "Users") and the calling Customer. By inviting a Nimbus bot into Teams conferences Reporting metrics can be tracked in the background and additional participants can be managed in a Conference. To achieve this the Nimbus bot uses Nimbus App Permissions which are usually delegated by an Administrator.

Primary views

As a Service User (Team Member) you can focus on your personal call experience in Nimbus. Within the UI you can steer your Service availability, access reporting features and handle tasks, as explained further below on this page. 

Take note: As a Users in a Service you must be set to active (and online in MS Teams) to be considered as "Available" by Nimbus. 

To keep your experience as simple as possible, Nimbus has a reduced set of "daily-driver" views, such as:

Call Monitoring and Distribution

As a Service owner you may be more interested in monitoring your team and adjusting your Service parameters as needed. Therefore, your daily call-handling focus should be on the following areas: 

Learn more about this…

As Service Owner you also want to steer the channels of communication, via specific Workflows that contain Workflow Activities for further customization. Applying these settings is done via the Modalities Service Settings 

Nimbus also considers individual User presence status (as set in MS Teams) prior to distributing calls. This allows to even include Users that are - for example - set to "Away" or "Busy". This can be configured in the Distribution Service Settings

🔍You can also visit and learn more on the User States and Task Queue and Distribution pages.

 
Steering how incoming Conversations are distributed among your Service Users
 
 

Handling Incoming calls

While handling calls in Nimbus:

INC Nimbus and MS Teams native functionality

☝ While handling Nimbus tasks, avoid MS Teams-native call controls

During an ongoing session, Nimbus cannot control any functionality engaged in parallel via MS-Teams
(e.g. putting Callers On-Hold, Transfers, adding participants to a Session, Muting of participants).

✅While handling Nimbus tasks:

  • Instruct all Service Users NOT to mix the approach between Nimbus and MS Teams.
  • Prefer the available Nimbus UI options for any call handling and -transfer scenarios: 
    e.g. Attendant Console (Safe/Blind transfer, Consultation call), Hold and Retrieve, Parking.

🤔What are the effects of using MS-Teams in parallel?

When using MS-Teams functionality in parallel during a Nimbus Session, the User / Customer experience cannot be clearly guided or monitored by Nimbus anymore.

Possible effects are:

  • Customers may not get clear feedback on certain actions (e.g. no On-Hold Music - just silence).
  • Manually added participants in a call conference may not all hear each other as intended.
  • The status in Nimbus UIs may not reflect the actual state of a Session anymore.
  • Call metrics, KPI and Nimbus Reporting results may not be properly recorded.
 
 
 

Nimbus is designed to not obstruct your daily call handling operation with Microsoft Teams. Most interactions rely on basic MS Teams functionality wherever possible, while extending functionality with rich context and call-related work. Let's explore the typical steps in the following chapters:

Call Distribution

  1. The Customer locates and calls your Service (discoverable either via Teams search, configured PSTN Number or known SIP Address as configured in the General Service Settings.
  2. Nimbus handles the call according to your Workflow configuration. The call is added to a task queue and distributed according to the parameters specified in the workflow "Queue" Activities1
    💡In this example we continue with a "Pickup" type distribution2.
    🔍Learn more by reading Distribution Types.
  3. Nimbus now will show the call in its UI, within multiple views wherever relevant to the involved Service Users. For example…
    1. … in the “Tasks Widget” in the Dashboard
    2. … the Live View or …
    3. My Sessions for the Users that actually get the call distributed to them.

1 When enabled in your “Queue” activity, an Adaptive Card chat message will also be sent to your chat channel in MS Teams. All current "Active" Nimbus Users are mentioned individually to be notified of this incoming call. 

2 Even while being set "Active" for the respective Nimbus team, Users might still see inactive "Pickup" controls. This is determined by Service Settings > "Conversations Distribution", which defines that Users in "Away" or "Busy" state are also considered for call distribution.

Call Establishment

💡 In this example below we continue with Adaptive Cards enabled as a better visual example.

  1. Let us assume that a User in your team chooses to accept the call by clicking "Pickup
    🔍 This can be done either in the Dashboard, or the "My Overview" area in the Nimbus Personal App
    💡 The Adaptive Card also offers "Pickup" controls.
     
Adaptive Card with Pickup controls
  1. Once "Pickup" is clicked Nimbus will establish a session between Caller and Agent 
    ⮑ The User will get a regular MS Teams incoming call (in the name of the Service).
    ⮑ Nimbus will remain in control of the session for gathering Reporting KPI metrics.
  2. Eventually, Agent and Caller decide to end the call  
    ⮑ The Nimbus bot remains until both parties have left the call, then concludes the session.
    ⮑ In the background, a Nimbus Reporting session is concluded.

Call Conclusion

At the end, the call information will be gathered and reported, for example as Statistics and within the Sessions List.

Service Statistics: Details and KPI on a single concluded call

The will also be updated with the Live View, as the Status of the User becomes “Available” again after handling the task.

Live view showing currently "available" Service Users (Team Members)

The Adaptive Cards in your team's chat channel will also update with information about who / when / and if the call was handled. 

Example Adaptive Card with call information shown

Duty States & Responsibility Profiles

💡The following content is taken from the Duty States page. 

Duty States

Duty State is Nimbus’ tracked availability status for Contact Center users. Every such user is shown as one of three Duty States — Available, Not Available, or Off Duty — derived from two independent inputs: 

  • which Responsibility Profile the user currently has selected (itself classified as either “On Duty” or “Off Duty” by an Administrator), and the user’s current MS Teams presence.
  • Users with no duty concept at all — Teams-based only, without a Contact Center license — show no Duty State; the field is simply blank rather than “Off Duty”. 

User State tracking includes the Duty State and is part of the Reporting system within Nimbus.

Duty State Meaning
Available An On Duty Responsibility Profile is selected, and the user is currently selectable for tasks.
Not Available An On Duty Responsibility Profile is selected, but the user is currently blocked — busy with a task, at maximum capacity, or their MS Teams presence doesn’t allow distribution.
Off Duty An Off Duty Responsibility Profile is selected.
(blank) Not a state — shown for users with no duty concept (Teams-based only, no Contact Center license). Dashboards and reports show this as an empty value rather than “Off Duty”.

Primary Use Cases

When using Assistant – either as App or within the UI – all Contact Center users can switch between their assigned Responsibility Profiles, which in turn can be On Duty or Off Duty. Using multiple profiles for either duty state can have use cases, such as:

  • Requirements for certain Skills and Responsibilities - e.g. when more experts are needed “on duty” to compensate for unusually large
  • High Workload - e.g. switching to a  ”on duty" profile to take more calls from multiple services.
  • Special situations - e.g. a “off duty” profile e.g. when working abroad, while being online, but unavailable for service calls.
  • Controlled absence -  e.g. an “On Duty” profile for on-call periods, allowing for emergency calls to get through whenever the user has that profile selected.

🔎 Related: The Responsibility Profiles On/Off Duty state are reflected in Nimbus Reporting.

 

PREREQUISITES

✅ Users of this feature must be part of a Contact Center service, also Contact Center licensed themselves. 

Once enabled:

⮑ The Contact Center Assistant becomes visible in your main menu, adding a User Status color indicator → more on this below. 
⮑ By default, Nimbus comes with two predefined “On duty” and “Off Duty” profiles. 💡 The duty profiles also affect the User State.

✅ OPTIONALLY, any Administrator can also create and assign further “On Duty” or “Off Duty” Responsibility Profiles to your user. 

Learn more…

  1. Any Administrator can create Responsibility Profiles. Each Profile can have its individual name – as reflected in the Nimbus UI – be of type “On Duty” or not. Here is an example:
    Defining the Profile Name and duty type
  2. When assigning the profile to a user, this is also indicated next the profile, but also:
Assigning one or several Responsibility Profiles to a user makes them visible in their UI. The “Duty State” behind the profile is also shown.

💡 Good to know: Custom profiles are treated the same way as the system's default On/Off Duty profiles, meaning that

 
 
 
 

Changing your Duty State with Responsibility Profiles

All users with Responsibility Profiles assigned can freely switch between them (and the underlying On/Off Duty state):

  1. Login to the Nimbus Frontend portal.
  2. Open either:
    1. "Contact Center Assistant" in the Nimbus main menu.
    2. Your standalone Nimbus Assistant App.
  3. Click the pulldown to change Responsibility Profiles and underlying duty status at any given time.
    💡 Duty, availability and readiness: Regardless of Duty State, you can remain fully "Available" in MS Teams to handle calls from other services and non-Nimbus calls. → More on this on status dependencies below.
    💡 Status persistence: Your duty status and responsibility profile persists even when restarting your MS Teams client or logging out and back into Nimbus. You keep the last selected status until you either switch to a different one – or until an Admin changes the setting on your user.
Switching between Responsibility Profiles also affects the Duty State. The naming of profiles is determined by the Admin

Duty and your User Status

Changing your Responsibility Profile and MS Teams Presence affects the user status indicator icon next to the Contact Center Assistant menu entry.

User Status indicator

☝️ Note that this icon color does not mirror your MS Teams presence 1:1, but instead aims to convey various User States1. The resulting icon color can be interpreted as follows:

Color  User State Factors
Gray
  • You have an off duty Responsibility Profile selected. You are not be considered for skill-based routing by any Contact Center service.
  • You have no Nimbus service toggled “Active” .
  • Your MS Teams presence cannot be determined by Nimbus.
Green
  • You have an on duty Responsibility Profile selected. You will be selected for tasks when:
  • You have at least one Nimbus service toggled “Active”.
  • You MS Teams presence (e.g. Available, Away, Busy) allows for task distribution, configurable per Distribution Service Settings.
  • 💡 The indicator can also turn green from an immediate, live selectability change — e.g. right after you switch profiles or presence — slightly ahead of the persisted Duty State value catching up.
Red
  • You have an on duty Responsibility Profile selected, BUT:
  • You are still busy with a Nimbus task 
  • You are at maximum task capacity (see Task Parallelization).
  • Your MS Teams presence (e.g. Away, BRB) does not allow for task distribution, configurable per Distribution Service Settings.
Orange
  • Orange is not a Duty State per-se.
  • The indicator also turns orange whenever you're in RONA status — this overrides Gray/Green/Red regardless of your current Duty State, and is tracked independently of it. 

1 🔎Status dependencies

Note that this color indicator is a simplification of the User States tracking system of Nimbus. The most important points to take home:

  • Your Responsibility Profile will not affect your MS Teams presence and vice-versa. As a result you can still remain "Available" in MS Teams – e.g. to take internal calls – but get a red indicator, effectively blocking Contact Center related service-tasks.
    💡Note that the indicator may still remain green, as you are “Active” in one or several MS-Teams based services.
  • Your Active on/off toggle e.g. in Services Overview also affects your readiness for new tasks non-skill-based services.
    💡Note that this toggle is not present when you are only part of skill-based services. In that case you will steer participation exclusively via Responsibility Profiles.
  • Your MS Teams Presence affects the indicator. If no service considers your presence as selectable for new tasks, you will get a “Red” color status.
 

Troubleshooting

🤔 Is your status "Red" although you are ready for new tasks? 

💡 Rule of thumb: Nimbus will distribute calls only when all criteria are met: 

  1. Valid MS Teams Presence 
  2. Not blocked by tasks or calls
  3. Not at maximum capacity
  4. In an On Duty Profile 
  5. Not status-flagged by ACW or RONA

Pickup behavior

INC Pickup behavior

🔎Pickup behavior

If your administrator configures the Pickup Distribution Type in the service Workflow (within the Queue / Queue Task activity), you can instead pick up tasks from the queue yourself, deciding when to take on additional work.

Modality Audio / Video Calls External Task / Email / Instant Messaging
Pickup behavior Pickup & Accept in two steps: selecting Pickup signals the Nimbus bot to invite you to a Conference call. You can choose to Accept or receive RONA on timeout. Pickup & Accept in one step: selecting Pickup assigns the task to you immediately — there is no separate Accept action and no RONA timeout.
Where The Pickup button appears wherever the task is listed — My Overview, Services List, Live View and Attendant Console.
Condition1
  • On Skill-based services: Pickup is only enabled for users whose Skills and Responsibilities match the service's current Distribution Policy level (including preferred / last users during the initial preference phase).
  • On MS Teams-based services: Pickup is only enabled for all “active” and therefore “available” users in the service.
  • If you're already connected to another task: Pickup additionally requires Task Parallelization to be enabled for you, your connected task to be non-blocking (see "(Non-)Blocking Tasks" on the Task Parallelization page), and free capacity within both your overall and per-modality task limits.

1🔎Also see User States for more details on the conditions how Nimbus considers users as selectable for tasks.

Picking up while connected Pressing Pickup while already connected to a non-blocking task automatically parks that connected task, letting you switch straight to the picked-up one. Existing Pickup eligibility rules (skills, responsibility, Distribution Type) and task limits still apply — Pickup remains unavailable once your capacity is used up. → See "Parallel Task Handling" and "Park Task Automatically When Picking Up a Pickup Task" on the Task Parallelization page.
Conflicts

If several users pick up the same task at once, the first request to reach Nimbus wins.

⮑ A small banner will inform else if the task was already taken.

Adaptive Cards Adaptive Cards option supported in MS teams-based services. No Adaptive Card option supported for this these modalities.
Reporting After clicking “Pickup" the user gets the call invitation. The User Session reports the Ring Time and includes it in the Average Ring Time KPIs. Because the task is accepted instantly, it has no ring time — these sessions report a Ring Time of 0 and are excluded from Average Ring Time KPIs.
 

Table of Contents