Business Process Designer > Business process modeling > Graphical elements / Webhook

Webhook

The Webhook element automatically sends information from a process instance in QuickBPM to an external system.

As an example, let's consider a company that sells and ships equipment. A sales rep receives an order from a customer and sends it to the warehouse where the order is processed. After invoicing, the order is shipped, and the webhook automatically sends the order's details to the inventory management software.

clip0020

This way the company saves time on entering data and avoids human mistakes, such as specifying a wrong serial number.

начало внимание

Only users included in the Administrators group can manage webhook settings.

конец внимание

How to add a webhook to the process

On the right pane, go to the Integrations tab and drag the Webhook element to the process diagram. Place the webhook in the part of the diagram where QuickBPM must send data to the external system.

00.PNG

Double-click on the webhook shape in the diagram to open its settings.

clip0022

General tab

This tab is for creating the http-request. Fill out the form:

  • URL - specify the request URL for addressing an API method of the external system, for example, http://example.com/api/create-order/. In this field, you can use process context variables and the DateTime function. To add a variable, click {+} on the right-hand side of the field. To use the DateTime function, click the function symbol {f }.  You can read more about using the DateTime function in the Item Name article.
  • Method - select either GET or POST. If POST is selected, the additional Request Type field appears.
  • Request Type - for the POST method the JSON, FORM and TEXT types are available.
  • Data - here you can link the process properties and request parameters. Click +Parameter and select a field in the Process field column, for example, Serial Number. The Request parameter field will be filled in automatically.

clip0023

If you have selected TEXT in the Request type field, then in the Data field you will need to enter a text template that will be passed in the request. To create the template you can use text, process context variables, and the DateTime function.

clip0024

To add a context variable, click the {+} sign on the right-hand side of the field. To use the DateTime function, click the function symbol {f }. You can read more about using the DateTime function in templates in the Item Name article.

Error handling tab

In this tab, you can define the behavior of QuickBPM in case the external system returns an error.

clip0025

If you want the system to resend the request, check the Retry box. Then select the number of retries and specify the delay in seconds between them.

clip0026

If you want the system to send a notification about the error, check the Notification box. The Add button will appear. Click on it in order to select the users who must receive the notification.

clip0027

If you want QuickBPM to interrupt this operation in case of an error, check the Interrupt box. Then select the connector that stands for the path that the process must take, for example, End process.

7.PNG

After having configured all the settings, click Save.