Create your Custom Parameters

✅ Before we can do anything automated, we need to have our parameters set up as placeholders for content input and output.

1. Head to Parameters by opening "Configuration" > "Service" > "Parameters".
2. Click on “Create”
3. Specify details for your parameter, 
4. Store the parameter either on tenant-wide or service a specific Organization Units (your service)

Notes on tenant-wide parameters

When using your own parameters for routing, consider if you want to share them on tenant-level Organization Unit. While separate call sessions - also accross multiple services - allow usage of the same parameter without data storage "interference", a user with same or higher access permissions (e.g. a Tenant Admin) might unknowingly rename, move delete a parameter.

 

What happens when a "used" parameter is deleted? 

Deleting a parameter will have the following effects:  Deleted parameters used in the system (e.g. in Power Automate or as part of workflow activities) remain usable and addressable by their name. They are shown with a N/A prefix in the selection. In workflow activities the parameter remains visible and operation until deselected to another parameter. ☝ After deselection the parameter cannot be selected anymore. Related flows might not trigger anymore or not save their values correctly. → In order to avoid future issues in your workflows:  Agree on "shared" general parameter naming conventions e.g. "global_routing_input" to be used for external systems or Power Automate Flows. Keep critical parameters on service level OU, so they cannot be removed by other service owners on accident. Make sure to handle all cases (exit nodes) on your workflow activities.  If no custom parameter is required for your scenario, opt to use default Nimbus system parameters instead, as they are less prone to manipulation and change.

 

 

 

 

5. Repeat the steps for both an input and output (value) parameter.
   

💡 Keep their ID in mind for later usage in Microsoft Power Automate flows.

Adapt your workflow

✅ With our in- and output parameters defined it's time to create a workflow that uses these parameters.

1. Head to Workflows by opening "Configuration" > "Workflows".
2. Create or adapt an existing workflow to include a "Collect Information" step. 
    
   

   GOOD TO KNOW WHEN INVOLVING EXTERNAL SYSTEMS

   Ensure to handle both exit nodes, e.g. with an announcement. This is recommended in both activity exit cases because we're using the Microsoft Power Automate Connector to connect to external systems in the next steps.
   The Trigger Events caused by the "Collect Information" activity will start this external flow, which will require some time to process. Since Nimbus has no way of "checking" on that flow's status, time-contingencies or workflow steps to handle "no valid / timeout results" should be considered.
   In case you do not fully trust the output of your CRM, you can perform a → RegEX safety check of your (un)expected flow output. Add a "Check Parameter" activity after your "Collect Information" to ensure that potentially erroneous outputs are handled.

   

    
3. At the end your workflow could look like this: 
   
   1. Collect Information > Input Received - This point will start an external flow trigger.
   2. Announcement: The announcement generates an artificial “delay” for the external flow to process. Add further steps as needed if your flow is time-intensive.
   3. Check Parameter > Parameter Name - Here, the flow output value is checked.
4. ✅ At this point you can continue building your workflow as you need. We will handle the external flow in the next step.

Create your Flow and Trigger

✅ With your workflow in place, it's now time to connect to your own databases and look up the information, then store the output back into the custom Nimbus parameter you created earlier.

1. Visit the Flow landing page: https://make.powerautomate.com/ 
2. Log in with an account that has both access to your Nimbus services and the external system you want to connect to. 💡 For brevity we just refer to this external system as "CRM" from here on out.
3. Head to "My Flows"
4. Click on "+ New Flow" and create a blank "Automated Cloud Flow"
5. Give your new flow a speaking name, e.g. "Get User Info from CRM"
6. In the text box underneath, search for “Nimbus” and choose the “When a task changes state” trigger
7. Click the Create button

8. Select the “When a task changes state” trigger.
9. In the “Services Item” dropdown select the Nimbus service's UPN.
   💡 You can also get the data of multiple services at this point, but for the sake of simplicity we keep it to one service in this example.
10.  In the “Task Events” dropdown select “Parameter Updated”.
11. In the “Advanced parameters” dropdown enable “Modalities” and "Directions".
12. In the “Modalities Item” dropdown select “Audio”.
13. In the “Directions Item” dropdown select “Inbound”.
     
14. Recommended Step: Initialize two variables in your flow right after the trigger and map them to the parameters you created in step 1 above. 
     

🤔 Why is this necessary? A variable init ensures that the variables (living only inside the Flow) have the right data storage format for your flow output in the later steps.

Parse Data

✅ The next step highly depends on your external system of choice, so we just show some general pointers: 

1. Chances are that your CRM might not deliver a granular enough output or the format is not fitting for your scenario. We therefore recommend to do some test and data validation runs with your flow to see which kind of output you get so you can grab the values you need:
    
2.  Replace the Get items action with the action of the CRM of your choice.
3.  With Set variable then you can store the first object returned by the previous step in your User_CRM variable.
4. With the Condition then you can check if the User_CRM variable contains an object.
5. If the User_CRM variable is null (because your CRM did not return any objects), then you simply writhe “Nothing” into the User_CRM_value variable to indicate that nothing was found. 
   
6.  If the User_CRM variable is not null (because your CRM did return an object), then you can parse the object to get its fields.
7. Once satisfied with your output, you can store it in output variable.  
    

Return Value

✅ Once the data from your CRM is satisfactory, it's time to return the output back to your Nimbus custom parameter used within your workflow in the Adapt your workflow section:

1. At the end of your Flow, add the "Update task" action of the “Luware Nimbus” connector.
2. Ensure that "Task ID" is filled in so it's correctly matched to your current call.

8. In the “Advanced parameters” dropdown enable “Custom Context Parameters”.
9. In the “Custom Context Parameters” section click “Add new item” and add the following information:
   1. Name: User_CRM
   2. Value: User_CRM_value variable
10. Save your flow.
    

🌟 Congratulations, you are now done with the CRM integration.

✅ Make further adjustments to your Nimbus workflow (→ Step 2) to parse the output and route the caller accordingly. 

✅ Ensure to test your flow thoroughly with test calls to account for potential CRM or Power Automate flow delays.