Use Case - Creating an External Task

Setup your service, and create and manage external tasks.

In this Use Case we're going to showcase how you can create and manage External Tasks.

PRECONDITIONS

You require tenant administrator or service owner rights to manage power automate flows and services.

 

INC Icon Legend Accordion

Show Icon Legend

💡 = A hint to signal learnings, improvements or useful information in context. 🔍 = Info points out essential notes or related page in context.
☝ = Notifies you about fallacies and tricky parts that help avoid problems. 🤔 = Asks and answers common questions and troubleshooting points.
❌ = Warns you of actions with irreversible / data-destructive consequence. ✅ = Intructs you to perform a certain (prerequired) action to complete a related step.
 
 

Prepare your Workflow

External Tasks are handled in separate Workflows. The first step therefore is to create one.

  1. Head to the Configuration > Workflows and create a new Workflow
  2. Select "External Task" as your workflow type.
  3. Define Name and Organization Unit for your workflow. 
    💡 Keep in mind that the workflow needs to be placed in an Organization Unit same or higher as your service in order to be visible later.
    💡 We also recommend using a base workflow template like “Queue Disconnect” as a solid starting point. 
  4. Finally, click "Create" → You are now brought to the workflow editor. You can start adding Workflow Activities
    1. 💡 If you are used to editing workflows, you may note some differences. For example there is a new "Delay" activity which can be used to react to Trigger Events and give Flow Actions time to retrieve data in the background. This will come in useful later as you → prepare your flow (see below) and test its runtime performance.
  5. Add workflow activities as needed.
    1. 💡 Our workflow below is an example. It uses a System Fields  "Customer Identifier" to react to specific words, prioritizing the task higher accordingly. 
    2. The task itself would be created by the Microsoft Power Automate Connector, which we will address further below. 
  6. Don't forget to "Save" and finish your new workflow.

Adjust your Service Settings

💡Note that we're starting at the point where your service is already licensed and the "External Task" modality is enabled for your users
→ See Preconditions above on this page.

 
  1. Head to your Service Settings and head to the Modalities tab. 
    1. Note the new "External Task" section therein.
    2. Activate "External Task"  and…
    3. assign the new workflow you created in the previous step. 
  2. Finally, don't forget to "Save & Apply" your settings

Prepare your Flow

💡 Next up we use the Microsoft Power Automate Connector to actually create the External Task. If you are new to the Nimbus Power Automate Connector  we recommend you check on your Power Automate Roles page to see if you are capable of setting up the necessary Flow Actions. Generally we recommend to do this with Tenant Admin rights to avoid your flows suddenly becoming inoperable due to changes in your Organization Units or service structure.

 
  1. Head to Power Automate, log in with service owner or administrator rights. 
    🔍 Reminder: Note that the selection of services within the Microsoft Power Automate Connector depends on bother user permissions AND Contact Center licensed services. → See Precondition.
  2. Create a new empty Cloud Flow.
  3. The next step depends on which Trigger you want to use to create a new External Task.
    1.  A very simple example – also useful to test External Tasks – is to use a manual flow trigger. 
      Using a manual trigger to test external task creation 
  4. 💡 Tip: You can also use Nimbus Trigger Events to follow up with an external task even between services. 
    An example:
    1. A customer calls Service A, which is configured to handle only Audio/Video calls as a first response IVR.
    2. Via "Collect Information" Workflow Activities the customer can request an on-site repair → This is caught via "GetOnUpdated Task" trigger as a "ParameterUpdated" session event, with the trigger still listening to Service A.
    3. Service A can now ensure that Service B (e.g. consisting of field-service agents) gets external tasks scheduled, by following up with an "AddExternalTasks" Flow Action
Flow Action Example: Adding an External Task 

INC External Task Limitations

External Task - KNOWN LIMITATIONS

Flow "RequestID" limitation - When a new External Task (ET) is created via Power Automate Flow Action, the "RequestId" value will not be returned. This means that you can't create and update an ET within the same flow. → You need configure an additional flow – based on one of the Nimbus Trigger Events – and update the ET via "UpdateTask" action.

 

LEARNINGS

  • By using flows, External Tasks can come from one (or multiple) source services and "funneled" into one target Contact Center service.
  • External Tasks are handled by the receiving service via their "External Task" workflow set in the Modality Service Settings. To ensure the external tasks will actually be handled, only Contact Center licensed services with the modality enabled are selectable within the Flow Actions.
  • External Tasks are not limited to via Nimbus Trigger Events. You can use any kind of Flow event (e.g. a webhook, a button, an Email, a MS Teams message) or a combination of events to gather the necessary inputs from multiple involved parties, then schedule the task.
  • Past their creation via "AddExternalTasks" Flow Action, External Tasks are treated like any other task in Nimbus and can be updated via "UpdateTask" action accordingly, using the "RequestID" field as task identifier.
 

Handling External Tasks in Nimbus

External Tasks are handled similar to any other tasks in Nimbus. They appear in the queue alongside with other (e.g. audio / video call tasks). Receiving users will get also a notification in their My Sessions view and can "Accept" or "Decline" . 

An incoming external task, identified by its icon

Tasks are also shown in Attendant Console and in Personal Dashboards within the "External Task Tabular" widget, where a service owner or supervisor can also remove the task if needed.

External Task in Attendant Console

Personal Dashboards can showcase external task within the "External Task Tabular" widget. 💡 Via Dashboard Supervision users with the corresponding permissions can cancel the task.

External Tasks in a Dashboard Widget

Good to know:

 

Table of Contents