Action: add-approval-group

When the action add-approval-group is used in the trigger message, Myndbend™ Process Manager provides the ability to automatically add approvers from approval groups to tickets (when certain conditions are met). Adding approvers using approval groups functionality has its advantages, as it makes it easier to include the right groups of people (Legal approvers, HR approvers, etc.) In addition, you can "line up" approvers in sequence within each group, and even put all specified approver groups in the order you wish to have them added, one after the other. 

How do I use this action?

Create a Zendesk trigger with conditions that match the moment when you want to add in the approver groups. 

Then set the action in MPM. For the action, select Notify Webhook - MPM Webhook. You will be presented with the option to paste in the message that will be sent to our servers. 

The message for this action is: 

{
    "action": "add-approval-group", 
    "data": ...
} 

Where can I find the ID of the groups I want to add? 

Navigate to Myndbend Process Manager™ app in the left navigation bar / menu, and click on the Approval Group tab. Next to each of the approval groups in the list, you'll see the corresponding ID: 

How to provide the ID of groups I want to add? 

Action add-approval-group expects the group IDs to be listed in an array, in the format of [GROUP_ID, GROUP_ID, GROUP-ID]

Example: 

{
    "action": "add-approval-group",
    "data": {
        "groupId": [1,2,3]
    }
}

This approval group functionality also supports sequencing groups one after another. For example, let's say that you had Group 1 and Group 2, and want to add Group 2 only after the approval has been granted from Group 1. 

To achieve this, in the message that is sent to the webhook, surround the sequenced groups in additional brackets - Like this: [[1, 2]]: 

{
    "action": "add-approval-group",
    "data": {
       "groupId": [[1,2]]
    }
} 

This will first add the group ID 1. Only when approvers from that group approve will our app add in the next group - Group ID 2. 

You can also mix these, to get something like: 

{
    "action": "add-approval-group",
    "data": {
       "groupId": [ [1,2], [3,4], 5]
    }
} 

This will add groups with IDs 1, 3, and 5 at the same time. After group 1 approves the ticket, group 2 will be added in. After group 3 approves the ticket, group 4 will be added in. 

Just like with all of our webhook actions, you can use Liquid Script to conditionally determine which approval groups you want to add based on form data.

If you decide to use the liquid script, be sure to read our quick Liquid guide, which covers some of the most common questions.