Prerequisite

• An active Bridge agent. Refer here to install and configure Bridge. 

• Create necessary Credentials for the applications to be connected by Task Engine.

For more details about  the Task Engine module in Bridge, the keys, and its description, click here.

Let us see how to configure Task Engine in Builder View and Code View.

Builder View

For associating a Task Engine state to a circuit:

1. In Builder View, drag and drop the Task Engine state from the left pane into your circuit or click the required Task Engine state in your circuit.

2. Under the Configuration tab, update the common state field attributes.

3. The Bridge ID field should capture the details of the Bridge to be used for this task. Click and select the appropriate bridge from the drop-down list.  
   

4. Under Add Configuration section, fill in the following fields:
   
1. Credential ID - Click and select the credential from the dropdown list. The Credential IDs of all the credentials created for the Task Engine module type will be displayed in the list.
   
2. Request Method - Field select the method (GET/POST). 
   
3. Request URL - Enter the API URL. 
   
5. In Error Handling, you can optionally select and configure error handling options. Refer to Error Handling in circuit states for further information.          

      

• Enter the required Input Path, Output Path, Result Path, and Result selector. To learn more about I/O paths, click here.
• Parameters: Click Add Parameter and specify the parameter name and parameter value. These parameters will be sent to the third-party application while triggering the webhook.
• Headers: Click Add Header and specify the header name and header value. The configured headers will be appended to the API request while triggering the Webhook.               

      

Code view

In Code View, the JSON to configure the Task Engine state to retrieve data using an API is given below:

"Update Onboarding Status": {
      "type": "task_engine",
      "next": "End",
      "payload": {
            "credential_id": "api_cred_1",
            "method": "POST",
            "url": "https://recruitapp.com/update_status",
            "parameters": {
                  "employee_name": "John Mathew",
                  "employee_email": "john_mathew@sweriomail.com",
                  "onboarding_status": "onboarded"
            },
            "headers": {
                  "AuthorizationKey": "$.APIKey"
            }
      },
      "bridge_id": "bridge-employee onboarding"
}