Notes
- Actions can be executed after Nimbus Trigger Events occurred within your Flow.
- Parameters and Fields described below are written for the “Legacy” connector which will slowly be phased out. The new certified connector requires a change described on Legacy and Certified Connector differences.
Add/Update Task
Connector / Action Name | Parameters and Fields | Description / Notes |
---|---|---|
Certified:
Legacy: AddorUpdateTask |
Parameters:
Task Object
PreferredUsers (list, n-tuple) (2►)
|
Updates the Caller Information of a Task.
Contact Center - These feature requires Contact Center users and service licensing. (1) External Task NotesOnce created via → "AddExternalTask" action, "Add or UpdateTask" can update External Tasks details using the "RequestID" field as task identifier. 🔎 Also refer to: Use Case - Creating an External Task (2) Preferred User NotesUsed to pool users for the "Preferred User Routing" option, enabled within Distribution Policies.
🔎 Also refer to: Use Case - Set Preferred Agent from CRM |
Outbound Tasks
Connector / Action Name | Parameters and Fields | Description / Notes |
---|---|---|
Certified:
Legacy: AddOrUpdateOutboundTask |
Destination
DueDateTimeUTC
ServiceUpn
DistributionPriority
MaxAttempts
AttemptTimeoutInSeconds
MaxQueueTimeInSec
RONATimeoutInSec
OutboundTaskId
CustomContextParameters
Customer.CustomFields
|
Adds a new Outbound Task or updates an existing one. Contact Center - This action will be limited to Contact Center services with "Outbound Conversations" option enabled in their Modality Service Settings. Limitations
Outbound Task Update RulesOutbound Task parameters can be updated according to the following ruleset:
Outbound Task Data Visibility
🔎 Also refer to: Use Case - Creating Nimbus Outbound Calls from a List of Scheduled Tasks |
Certified: Get all outbound tasks
Legacy: GetOutboundTasks |
ServiceUpn - dropdown filtered by User Roles and Organization Units , |
Get all outbound Tasks filtered by service specified. Returns task object and state.
Returned task state can be:
|
Certified: Remove an outbound task
Legacy: RemoveOutboundTask |
OutboundTaskId
|
Removes an existing (= has Id) Outbound Task.
Note: Does only remove a task when not "In Progress". |
External Task
Connector / Action Name | Parameters and Fields | Description / Notes |
---|---|---|
Certified:
Legacy: AddExternalTask |
PreferredUsers (list, n-tuple)(1►)
ServiceUPN DistributionPriority
Customer Identifier (System Parameter)
|
Allows to add External Tasks and configure Preferred Users for this task.
Contact Center - This action is only available for Contact Center licensed services and users with the External Task modality activated. (1) Last / Preferred User NotesUsed to pool users for the "Preferred User Routing" option, enabled within Distribution Policies.
External Task visibilityExternal Tasks are currently visible in Assistant, My Sessions and Attendant Console. EXTERNAL TASK LIMITATIONSLegacy Connector: Flow "RequestID" limitation - When a new External Task 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.
Certified Connector: In the certified Nimbus Power Automate Connector this limitation does not apply. |
Certified:
Legacy: RemoveExternalTask |
Parameters:
|
Removes External Tasks (with specified ID)
Can only remove a task before the "Connected" state. "Ongoing" tasks are not removable anymore. |
Address Book Contacts
Connector / Action Name | Parameters and Fields | Description / Notes |
---|---|---|
Certified:
Legacy: AddOrUpdateContact |
Parameters:
Fields of contact to add or update:
|
Add or update a contact in an Address Book
☝ Note that address book fields have length limitations that result in errors when exceeded → see Address Book limitations below.
|
Legacy: RemoveContacts
Certified: Empty an Address Book |
Address Book External IDs of Users to remove |
Remove selected contacts from an Address Books by providing their external IDs
Removes contacts within Address Books.
|
Legacy: ClearContacts
Certified: Empty an Address Book |
Parameter: Address Book |
Clears all contacts from an Address Book. 💡 To remove a single contact, use "RemoveContacts" action.
|
Legacy: GetContacts
Certified: Get all exisitng contacts in an Address Book |
Parameter: Address Book | Get all existing contacts in an Address Book.
Retrieves contacts within Address Books.
|
Address Book Limitations
INC Address Book Limitations
Address Book Field Size Limitations
Please note that Address Books fields underly size limitations. When exceeded, the Nimbus Power Automate Connector will return a 400 Bad Request.
Learn more…
Area | Field | Limitation |
---|---|---|
Contact | ExternalId | 128 characters |
Firstname | 64 characters | |
Lastname | 64 characters | |
Displayname | 256 characters | |
Initials | 16 characters | |
Company | 64 characters | |
Department | 64 characters | |
JobTitle | 128 characters | |
UPN | 128 characters | |
IMAddresses | IMAddress |
Maximum of 10 addresses 128 characters per address |
Emails | EmailAddresses |
maximum of 10 addresses 128 characters per address |
PhoneNumbers |
Businessphones Mobilephones Homephones |
Maximum of 10 phone numbers (per type). 32 characters per phone number |
Address | Adresses | Not more than 10 addresses |
Street: | 1024 characters | |
City: | 128 characters | |
Country | 128 characters | |
State | 128 characters | |
Postal code | 40 characters | |
CustomFields | External.CustomField | Maximum of 20 custom fields |
name | 64 characters | |
value | 1024 characters |