Webhooks

webhook trigger the webhook trigger allows one app to automatically notify engini through a predefined http callback that an event has occurred it allows real time communication and data exchange between different apps to engini to use this activity, follow these steps when adding your workflow choose for the trigger “webhook” software follow the next steps to learn how to define this activity url the url is automatically created by engini it’s not possible to edit it click on the icon to the right of the url to copy it each webhook url is unique to the specific workflow you created method specifies the type of request that should be sent by the external application the method’s default value is “post” to define a method, follow the next steps click on the empty field choose from the tooltip the method you want to use learn more about the method types in http requests guide relative url (optional) specifies the endpoint url that the trigger will listen to for incoming http requests to learn more about relative url click here generate output schema to load the sample, there are two options using documentation obtain the json/xml payload sample from the documentation of the system that sends the webhook click on the blue sentence to enter a sample of the incoming request payload and engini will try to parse it and create the structure of the incoming request for you to use in the following activities to extract data from the incoming request using the running log wait to receive a webhook enter the run history log in engini expand the webhook output block and scroll to the end of it copy the entire “responsebody” value as seen selected in the image below switch back to edit mode and click on the blue sentnce and paste the copied json as seen in the image below response body the fields and array of the json will be displayed to you, click on the small arrows to "open" the objects array and see the inner fields you can now add fields on your own! add field customize your output schema and add your own fields and be more precise with your goal and result follow the steps to build the field name choose a unique name display name the name that will be shown to users inside the workflow and dynamic mapping fields description additional context for the ai tool about the purpose of the field and the expected value helps the ai understand how and when to use this field dynamically during workflow execution type defines the data type of the field required determines whether the field is mandatory if enabled, users must provide a value for this field before the workflow can run apply saves and applies the current field repeat 1 6 to populate more fields output structure is exactly where you can see the structure of your json it visually displays the "skeleton" of your data showing the hierarchy and data types (like string, number, or collection) confirming that the system understands the json so you can use its data in the next steps important the webhook default response is 200 status code send webhook response a workflow that is triggered with a webhook will normally send a 200 status code response upon receiving the request adding the “send webhook response” activity to a workflow that is triggered with a webhook allows you to customize the response the workflow will return you can place this activity in different places inside the workflow, depending on the response you want to send back and when to send it choose the core software and click on the “send webhook response” action to define the webhook response follow the next steps status code – click on the field and choose from the tooltip the status code you want to return body type click on the right arrow and choose from the tooltip the body type the activity supports 4 body type file used to send a file as the request body this is typically used for file uploads, such as sending a pdf, image, csv, or other file types when the api expects a file in the request application/json indicates that the request body contains data in json format text/html indicates that the request body contains html text data text/plain indicates that the request body contains plain text data text/xml indicates that the request body contains xml text data body – click on the empty field to enter the response body you want to return add headers additional metadata about the request, such as the type of data the engini can accept, the length of the request body, and authentication information each header consists of a key value pair, where the key is the name of the parameter, and the value is the data associated with that parameter key click on the key field to enter the additional header name value click on the value field to enter the value of the header repeat 1 3 for more headers redirect example to set up a webhook response redirect, configure the webhook response module as outlined below status code define a 3xx redirection http status code, such as 303, in the ‘status code’ field click on the field and choose from the tooltip the status code you want to return you can select one of these redirect status codes 301 – moved permanently 301 indicates a permanent url redirection the requested resource has been permanently moved to a new url subsequent requests should use the new url 302 – found/temporary redirect 302 signifies a temporary redirection it tells the client to temporarily visit a different url future requests should still use the original url 303 – see other 303 advises the client to visit another url it is typically used in response to a post request, redirecting the user to another page to retrieve the response 307 – temporary redirect 307 indicates a temporary redirection similar to 302 but preserves the method (get, post, etc ) used in the original request for future requests 308 – permanent redirect 308 is similar to 301 but preserves the method (get, post, etc ) used in the original request for future requests it signifies a permanent url redirection headers add the following custom header details key location value the url you intend to redirect to for example, “https //www enginiexample com” this configuration directs the response to a specified url upon trigger relative url in the context of webhooks, a relative url is a way to specify a resource’s link relative to the webhook’s endpoint instead of providing the full and absolute url, a relative url allows you to insert dynamic parameters or variables into the link when the webhook is triggered, you can utilize the values received in the properties for further processing within your workflow using a relative url example, let’s consider the following scenario suppose you have the following webhook endpoint url https //workflowapi engini io/webhook/v2/123engini456example/{itemid} when you want to utilize this link and replace the value of “itemid,” you specify the desired value in the appropriate place within the url for instance, if you want to trigger the workflow with an “itemid” of 123, use the following url https //workflowapi engini io/webhook/v2/123engini456example/123 customization the “itemid” is just an example and can be named and used as per your preferences you can also include multiple properties separated by commas in the url to pass and process various data as needed for example, you can format your url like this https //workflowapi engini io/webhook/v2/{property1}/{property2}/{property3}