Comment on page
Trigger External API Actions
‘Trigger External API’ Actions allow Enate to call out to an external system, passing a static structure containing information information about a Work Item (i.e. a Case, Action or Ticket). This Action type also includes an optional callbackURL, which allows the external system to update custom data and pass it back into Enate.
The external API will be called as a POST method, and will be sent the following information:
The [ActionPacketJSONIncludingCurlyBraces] will be an Actionpacket, as per the response from the Enate getAction API.
Enate supports this with a 'Trigger External API' Action type that you can add to your Case flows.
You can either create a Trigger External API Action type in the Service Line section of Builder, or directly from your Case flow.
Creating a Trigger External API Action type from the Service Lines section of Builder adds the Action to your menu of available Actions when you're building flows subsequently in Cases.
To do this, in the Service Lines page select which service line you would like to add the Trigger External API Action to and then click on the plus symbol next to the 'process Search' box and then select 'Action.
This will open up a new Action for you to create.
Add a name and description to your Action and then in the 'type' drop down select 'Trigger External API Action'.
You can then choose to add a global checklist to the Action. This contains a standard checklist of activities that will be added any time this Action type is added to a Case flow. See here for more information on checklists.
Once you are happy with your Action, hit save to create it. This Action can now be added to new and existing business processes by selecting it from the dropdown list when adding a new Action to a Case.
Alternatively, you can add a Trigger External API Action type directly from the Case flow itself.
To do this, open your desired Case flow in edit mode, click on an Action's menu and then instead of clicking to add an existing Action, select to create a new Action by clicking the '+' icon.
Give the Action a name, add a description if you wish and for its 'type', select 'Trigger External API Action'. This will add the Action to the Case flow.
You now need to configure the settings for the new Action you have added to your Case. Click on the Action in the flow to highlight it in the info section.
In the Action Info tab, you need to add the usual following information for an Action:
Additionally, once a Trigger External Action has been added to your Case flow, a new 'External API' tab will display in the info grid.
If you set the 'Response Expected' slider to On but no value is entered in the 'Response Expected Within' column, the Action will call the external system and wait either until the Due Date for the Action, or indefinitely.
The decision on whether the Action will wait indefinitely or not is determined based on the 'Autocomplete on Timeout' setting in the General Settings flavour set for the Action.
- If Auto-complete in General settings is set to On, the system will time the Action out when it hits the Due Date / Time.
- If Auto-complete in General settings is set to Off, the Action will wait indefinitely.
If / When the Action DOES time out at the point of reaching the Due Date, the Action will moved to a state of 'Closed' with a reason of 'No response returned'.
Note: If you have both these settings filled (i.e. a 'Response expected minutes' value AND the 'Auto-complete on Timeout' flag set), the system will act on whichever time comes first - most likely after the 'Response expected minutes' time has been reached.
Please note that the Case owner will not be notified in this scenario.
There are a number of possible ways the system will behave, dependant upon how you have configured the various timeout settings AND how the external API actually responds. For detailed information on this, see the following attachment which lays out each combination of settings and behaviour, and the eventual result.
Trigger External API Action - Behaviour.xlsx