Nimbus treats all incoming calls, chat requests, and other modalities as Tasks. The Power Automate connector primarily listens to Events related to changes in a task's status.
INC Power Automate Preconditions
PRECONDITIONS
☝External licensing costs
A Microsoft Power Automate subscription with "Premium Tier" license is required to set up the necessary connectors in your Flows. Note that the pricing for these accounts is determined by Microsoft and outside of your Luware subscription.
☝Nimbus Licensing
Licensing: To use the Power Automate integration, at least one of your Nimbus services must be Enterprise Routing or Contact Center licensed. Additional licenses can be assigned via License Management in the Administration UI.
Configuration: Flow interaction requires an existing Nimbus service already provisioned on your tenant. Power Automate Trigger Events react to Workflow Activities in your currently running Nimbus Workflows – as defined in your Modality Service Settings. If your service has no (valid) workflow defined, trigger events will not be recognized.
☝User Roles
You need either Team Owner or Administrator in Nimbus to set up Power Automate Flows. Check that your currently logged-in user account has one of the required Nimbus Power Automate Roles.
💡Tip: To keep impacts and licensing cost to a minimum we recommend setting up flows as a Tenant Administrator as you have full access to all services and their configuration items located within their respective Organization Units. This also reduces the risk that Flow Actions and related Trigger Events suddenly stop working, as Nimbus Configuration entities, permissions or related user roles change.
Learn more about this…
The same user account UPN you use in Microsoft Flow is matched with the according User Role granted via Nimbus User Administration. Nimbus data is filtered via the Organization Unit placement of your logged-in user account. In effect, Services and Users outside of this OU placement are (not) shown in Flow Actions and Trigger Events to prevent accidental manipulation.
The following table will give you a brief overview on which Nimbus User Role can manage Power Automate flows:
Nimbus User Role | Notes on Flow access |
---|---|
Partner Admin | ❌ Cannot use triggers for services in the customer tenant with his own account. Also have limited visibility on live-data. |
OU Admin |
☝ Can access the connector, but is not recommended to manage live call-data with, as the view on services and user data is restricted by Organization Units. If the Admin role is moved or deprecated, flows may cease to function correctly.
💡This role is primarily meant for assisting on configuration tasks, e.g. managing flow-related Address Books and Workflows. |
Tenant Admin |
✅ Recommended!
|
Team / Service Owner |
☝ Usable, but limited access to data entities within Organization Unit rules of user account (reading up the path rule):
|
Supervisor / User | ❌ Have no access to the connector itself or any related configuration items and service settings. |
🔎 Refer to Power Automate Roles for more details.
During an active task, Nimbus will send trigger events according to the steps configured in the respective service Workflow. These Events can then be followed up upon using Flow Actions. All triggers are available for selection within the Power Automate Connector and described in the following.
💡 With the connector, you can leverage these events and react to activities in your Nimbus service Workflows. The diagram at the right showcases when such Trigger Events occur during a inbound call workflow.
INC Power Automate Connector Deprecation Notice
☝ Deprecation notice: With the new (store-certified) Nimbus Power Automate Connector there are changes on Flow Actions, Triggers as well as Field and Event descriptors which require a Connector Migration.
✅ If you are using a deprecated (manually installed) connector you should perform a Connector Migration as soon as possible.
Learn more…
🤔 Why are contents on the Knowledge Base still showing old connector info? As Microsoft still changes the design / naming on Power Automate rather frequently and without notice, we shift our approach to be more “In-App” centric. This means that future connector updates will include guidance and in-app help as far as the Flow UI allows. Legacy Connector Knowledge Base contents will remain online for future reference, e.g. to perform a Connector Migration and comparison.
🤔 Why is the new verified Connector still shown as “Preview”? The Luware Nimbus certified connector and related Flow Actions are ready for productive use. Microsoft will remove this tag once the connector has seen frequent use on Microsoft official clusters, primarily after meeting their “General Availability” criteria.
🤔Why is Use Case XY is not covered in the new Connector (yet)? Our Knowledge Base will gradually move existing Power Automate Use Cases over to the new certified connector. If you require assistance on our existing Power Automate Use Cases, first check the Connector Migration page for hints. You can also contact Customer Success to request updates to Knowledge Base pages.
☝ Please Note: Trigger event reaction times rely on Microsoft Power Automate and Azure infrastructure. Account for delays (e.g. with announcement workflow activities while connecting to external systems) or while relying on user input, as each action in your flow can cause additional delays.
→ Workflows also allow for a Wait for Parameter activity which specifically waits for changes in your Parameters (e.g. updated by a flow).
→ Either way: We strongly recommend making test calls and plan for monitoring periods to check your Flow performance in large call / task volume scenarios.
Trigger: When a task change state
This trigger is raised “When a Nimbus task changes state”. The table below describes the different event details:
Task Events | Supported Modality Direction | Description | Related Workflow Activities |
Legacy Connector “Session” Event (deprecated) |
---|---|---|---|---|
Workflow Started | Inbound ↙ | Triggered during an incoming task to a service line. ☝ Will only be triggered once for the initial incoming task arriving at the first service. |
None, right after the "Start" node in a workflow. |
Created |
Outbound ↗ | Triggered when outbound service task is started. | None | ||
System Accepted | Inbound ↙ | Triggered when incoming task was accepted by the service. | "Accept" | Accepted by System |
Parameter Updated | Inbound ↙ | Triggered whenever a parameter is set or updated by a Workflow Activity. |
"Collect Information", "Save to Parameter", "Get Available Users", “Get Queue Position”, |
Parameter Updated |
In Queue | Inbound ↙ | Triggered when the task was put into the queue. |
"Queue", "Queue Task" |
Queued |
Outbound ↗ | None | |||
Connected to User | Inbound ↙ | Triggered when the task was connected to a user. | As part of: "Queue", "Queue Task" |
Connected to User |
Outbound ↗ | None | |||
Destination Reached | Outbound ↗ |
Triggered when connected to the destination. 💡Applies to Outbound Calls and Call On Behalf. |
None | Outbound Connected to Destination |
Queue Left | Inbound ↙ | Triggered once the task leaves the queue (either when the caller left while waiting in the queue or when the maximum queue timeout was reached). | During or right after: "Queue" |
Queue Left |
Outbound ↗ | None | |||
Terminated | Inbound ↙ | Triggered once the task is terminated (caller left, Nimbus user left, or task was cancelled by the workflow). |
"Disconnect" | Terminated |
Outbound ↗ | None |
Related Pages:
- Each Trigger Event can update System Fields and Parameters which are available as data fields within the Nimbus Power Automate Connector and the Nimbus UI itself.
- You can follow Triggers with additional Flow Actions, e.g. to manipulate entries in Nimbus-internal Address Books, or change task details.
- Of course, you can combine any Trigger Event or Flow Action with your own flow actions, e.g. reading info from external directories, triggering a MS Teams message, etc. Refer to Power Automate Use Cases for more inspiration.
- The User Role (RBAC) Matrix determines which Nimbus Services and related Triggers / Actions are available to the user.
Roles with Power Automate Access
Power Automate Roles
Revoked Role Limitation
🔎 Roles described table below have access to the Nimbus Power Automate Connector.
☝If a User configures a Power Automate Flow for a service, but then loses permissions to configure such a flow (e.g. removed as Service Owner), the previously configured Power Automate Flows will still be triggered.
✅When changing service ownership we recommend you to check for leftover flows or use a global administrator to manage all your flow needs in a centralized fashion.
Table: Nimbus Power Automate Permissions
🔎Legend: Create, Read, Update, Delete, Execute
Certified Connector Custom Connector Tenant Admin OU Admin Team/Service Owner Team Owner Limited Conversations Triggers - GetOnNewTasks E E When a task changes state GetOnUpdatedTasks E E When the virtual task assistant has an update E E Actions Update task UpdateTask E E Add a new external task AddExternalTask E E Remove an external task RemoveExternalTask E E Get Data from Virtual Task Assistant E E Address Books Actions Add a contact to an address book AddOrUpdateContact E E Update a contact in an address book - E E Empty an address book ClearContacts E E Get contact(s) from ana address book GetContacts E E Remove contact(s) from an address book RemoveContacts E E Outbound Service Calls Triggers When a scheduler entry changes state GetOnUpdatedOutboundTask E E Actions Schedule a new outbound call AddOrUpdateOutboundTask E E E Get all scheduler entries GetOutboundTasks E E Update a scheduler entry - E E Remove a scheduler entry RemoveOutboundTask E E
Trigger: Scheduler entry changes state
Scheduler Entry Events are used as wrapper for Outbound Calls to cover the lifecycle before the outbound call becomes a task (queued and looking for a Nimbus user).
Scheduler Entry Events | Description | Legacy Connector “Session” Events (deprecated) |
---|---|---|
Scheduled | Triggers when outbound task gets successfully scheduled or new attempt is re-scheduled. | Scheduled |
Due date reached | Triggers when distribution attempt is started (queued and looking for a Nimbus user). | InProgress |
Handled | Triggers when outbound task completes after destination (customer) is reached. | DestinationAccepted |
Limit reached | Triggers when the maximum amount of retries for the outbound task has been reached (all attempts were unsuccessful). | MaxRetriesReached |
Removed | Triggers when a supervisor manually removes the task from the Personal Dashboards via Outbound Tasks-type Widgets, or if the task is removed via Power Automate action. | Removed |
Failed | Triggers when task either fails by system error or when e.g., killed by admins in the backend. | Failed |
Related Info: Outbound Tasks
- Certain Flow Actions (e.g. Schedule a new Outbound Call, Get all scheduler entries, Update a scheduler entry, Remove a scheduler entry) can create, remove, and manipulate outbound task properties such as: Retry Count, Target Service, Priority, etc. Note that this overrides the defaults specified in the respective Workflows.
- During a Scheduler Entry Event System Fields and (custom) Parameters can be updated e.g. by using “Update a scheduler entry” or other Flow Actions and made visible in the My Sessions → Session Details widget. The actual parameters shown to users can be configured via Extension Service Settings.
Trigger: When the virtual user assistant has an update
This event is related to the Voice Transcription feature and triggers right after a user-customer transcription is saved after a finished conversation.
INC Beta Feature
This feature is in BETA status. Functionality, design and scope may still change significantly over time.
INC Upcoming Connector Feature
Upcoming Features / Ongoing Certification
🔜This feature is not yet part of the certified Nimbus Power Automate Connector. To test this functionality, you can manually download and install the latest upcoming (V1) connector as Custom Connector. However – once the functionality becomes officially available – you need to perform a manual Connector Migration of your flows.
Preconditions
- Virtual Assistant requires Voice Transcription to be enabled in the respective service's Virtual Assistants Service Settings.
- The use of this feature requires prior setup. Refer to Use Case - Setting Up Transcription.
INC Azure Billing Transcription
AZURE BILLING
The usage of the Transcription feature will cause additional monthly ACS costs. The costs are determined by Microsoft. Also see https://azure.microsoft.com/en-us/pricing/details/cognitive-services/speech-services/.
- Before enabling the Transcription feature, get in touch with your Luware Customer Success specialist to discuss terms, usage scenarios and necessary setup procedures.
- Please note that Nimbus and Transcription support does not cover pricing discussions or make recommendations based on Microsoft Azure infrastructure.
Scheduler Entry Event | Description |
---|---|
Voice Transcription Ready |
From selected “Service” parameter: Triggered when the Nimbus User Virtual Assistant has been active during the session and reaches “when the call ends” event.
Event Data sent is:
|
🔎 Related Action: You can follow up this trigger with the Flow Action “Get Data from Virtual User Assistant” e.g. to store the data into a Teams Message or Email. Refer to Use Case - Analyzing a Transcript to see an example.