Skip to main content

Workflows Manual - Knowledgebase / Blyott Manuals - Blyott Support & Assistance

Workflows Manual

Authors list

This page will provide step by step instructions on how to use Workflos feature for the Smart Healthcare platform. Additionaly, you can find third party implementations instruction.


I. How to setup Workflows on Blyott Portal 3

1. Workflows/Webhooks3

Workflow type „Instantly“ 4

Workflow type „Every X second(s)“ 4

Workflow type „Location changed“ 4

Workflow type „Alert offline“ 4

Workflow type „Button pressed“ 5

Workflow type „Movement detected“ 5

Workflow type „Outside designated Zone“ 5

Workflow type „Floor changed“ 5

Workflow type „Zone changed“ 5

II. How to assign Assets to Workflows5

III. IMPLEMENTATION EXAMPLES7

1. Integromat 7

„Scenario“ configuration guide7

„Email module“ alerts guide10

IV. Additional details13

1. Blyott Support & Assistance13



I. How to setup Workflows on Blyott Portal


1. Workflows/Webhooks


If enabled by our side (you can request enabling by contacting the Support Team), you will see it in the“Workflows” section in the “Configuration” panel.

Before you start to use it, you need to create and configure the "Workflow" and specify a URL on where to forward data to e.g. a "Webhook" which is created on a 3rd party application or site. Take kindly note that you can find all relevant information under the "Workflow specific operations:" headline in the API documentation.

Click “+” to add your Workflow and fill in the following data:



Workflow“ would be the name of your Workflow.

URL“ is the Webhook link that is created on the 3rd party site and this is the URL where we forward payload to.

Authentication method“ – as for now we offer only “Secret” which is a simple method to protect the webhook endpoint. Every webhook request will have a header ‘Token’ and the value of that header will be the value from the Secret field. This way you can check if the Token header exists and if it corrects for each request you receive.

Forward frequency (seconds)“ is the timeframe in which the payload is registered and forwarded to the webhook URL.

Workflow type“ is where you choose the type of information that is sent. We are currently sending the following data to Webhooks (Workflows):

  • EventType
  • Tenant
  • WorkflowName
  • AssetName
  • AssetCode
  • TagMAC
  • LocatorMAC
  • CurrentLocationID
  • CurrentLocationCode
  • CurrentLocationName
  • MlLocation
  • RSSI
  • TimeSeen
  • Payload


After you fill „Workflow“ name, „URL“ of the endpoint, „Authentication method“ and „Secret“, you will need to choose the „Workflow type“ and the „Forward frequency“ counted in seconds. Currently, we offer eight different Workflows explained in further documentation.


Workflow type „Instantly“

If you choose to use this workflow it will enable you to send every TagUpdate payload in real-time.


Workflow type „Every X second(s)“

If you choose to use this workflow it will enable you to send TagUpdate payload every X seconds you entered in „Forward frequency (seconds)“.


Workflow type „Location changed“

If you choose to use this workflow it will enable you to send a payload whenever the location is changed from the „Location of interest“ you picked. For example, if you picked the location of interest to be „Location 1“ and this Asset has been moved and detected on „Location 2“ workflow will send the payload to your webhook URL. If „Location of interest“ is not picked, it will send the payload if the Location is changed regardless.


Workflow type „Alert offline“

If you choose to use this workflow it will enable you to send payload whenever Asset is offline. For example, if you entered the 20s in „Forward frequency (seconds)“ this workflow will send the payload to your webhook URL when it detects this Asset is offline during that time.

Take note, if you set <7s, there is a possibility to get a lot of alerts since the broadcasting rule for Tags is every 4-7s, which means that workflow could potentially detect that Asset is offline during that interval (4-7s). Recommended minimal frequency is 300s or 5min.


Workflow type „Button pressed“

If you choose to use this workflow it will enable you to send payload whenever the Asset/Tag button has been pressed. For example, if you entered the 20s in „Forward frequency (seconds)“, this workflow will send the payload to your webhook URL when it detects that the Asset/Tag button has been pressed in this time frame.

Take note, if you set <7s, there is the possibility to not get the alerts since the broadcasting rule for Tags is every 4-7s, which means that workflow could miss the detection of pressing the button on the Asset/Tag. Recommended minimal frequency is 10s.


Workflow type „Movement detected“

If you choose to use this workflow it will enable you to send payload whenever Asset has been moved. For example, if you entered the 20s in „Forward frequency (seconds)“ this workflow will send the payload to your webhook URL when it detects this Asset has been moved in this time frame.

Take note, if you set <7s, there is the possibility to not get the alerts since the broadcasting rule for Tags is every 4-7s, which means that workflow could miss the detection movement on the Asset/Tag. Recommended minimal frequency is 10s.


Workflow type „Outside designated Zone“

If you choose to use this workflow it will enable you to send payload whenever Asset has been moved outside designated Zone. For example, if you entered the 20s in „Forward frequency (seconds)“ this workflow will send the payload to your webhook URL when it detects this Asset has been moved in this time frame to a different Zone.


Workflow type „Floor changed“

If you choose to use this workflow it will enable you to send payload whenever Asset has been moved to a different Floor. For example, if you entered the 20s in „Forward frequency (seconds)“ this workflow will send the payload to your webhook URL when it detects this Asset has been moved in this time frame to a different Floor.


Workflow type „Zone changed“

If you choose to use this workflow it will enable you to send a payload whenever the zone is changed from the „Zone of interest“ you picked. For example, if you picked the zone of interest to be „Zone 1“ and this Asset has been moved and detected on „Zone 2“, the workflow will send the payload to your webhook URL. If „Zone of interest“ is not picked, it will send the payload if the Zone is changed regardless.

II. How to assign Assets to Workflows


After you filled in all the required information and made sure Workflow is marked as active, we will need to assign the Asset to Workflow which we would like to monitor.

To assign the Asset to your Workflow, please follow the instructions:

  1. Click on „Assets“ in List View on your Blyott Portal page.
  2. Click on the desired Asset you want to monitor.
  3. Click the edit button.
  4. Click on the drop-down menu of „Workflows“.
  5. Select workflows which will be assigned to this Asset.

  1. Click „Save“.

Take note, this step is important, if you do not assign Asset to Workflow, the Webhook URL will not get any payload data and will report the error.

If you followed the instructions above, you should be able to receive the payload information to your webhook URL where you could set triggers to activate further notifications/actions. Of course, that depends on 3rd party application or site you are using for your webhook URL. Please refer to their documentation for more possibilities.


III. IMPLEMENTATION EXAMPLES


1. Integromat


Create an account on www.integromat.com and log in to the Dashboard. Please follow the instructions to set up your Workflow to forward information to Integromat Webhook.

„Scenario“ configuration guide


  1. Click on „Scenarios“.
  2. Click on „Create a new scenario“.
  3. Click „+“ to add your module.
  4. Search for „Webhooks“ in the search section and select it.
  5. Pick „Custom webhook“ from the menu.
  6. Click „Add“ to create your Webhook URL.
  7. Fill in the desired name of your Webhook and click „Save
  8. Copy your newly created Webhook URL from this section.
  9. On Blyott Portal create a new „Workflow“ and enter copied link into „URL“.
  10. On the „Assets“ section edit the desired asset and select the newly created „Workflow“.

    Take note, this step is important, if you do not assign Asset to Workflow, the Webhook URL will not get any payload data and will report the error

  11. To confirm the connection is successful, check the Integromat Webhook module.

If you got the green message, you have successfully connected the Integromat Webhook with Blyott Workflow. Asset payload will be forwarded to this Webhook in Integromat. If you didn't get the green message and the Integromat is still spinning the „Stop“ button, this means that Integromat didn't receive any payload from the Asset (there were no changes on the Workflow). As soon your Asset makes the change and sends the payload, Integromat will connect. From here you can set certain rules and desired notifications, like for example, email alert when a certain state is registered with your Asset.


„Email module“ alerts guide


To trigger the email alerts on specific Workflow events, please follow the instructions below.

  1. Click „+“ to add another module.
  2. Search for „Email“ in the search section and select it.
  3. Select „Send an Email“ from the menu.
  4. Click „Add“ and configure your sending email from which you will send the alert emails to the recipient. Select „Others“ in connection type, „Outlook.com“ in email provider, your sending email address, and fill your „Username“(email) and „Password“. Click Continue.
  5. The next and final step is to add the recipient email, „Subject“ and „Content“ (body) of the email.

    Take note, in this step you can choose the payload parameters. You can customize what you want to send in your email alert. For example, if I added „EventType“, it will show in the mail what triggered this email (LOCATION_CHANGE, BUTTON_PRESSED, etc.)


IV. Additional details


1. Blyott Support & Assistance


Within this Help Center, we aim to provide you with useful information, documentation, and guidance that will enable you to make the most out of your access to the Blyott Platform.

In the Knowledgebase section you can find a video walkthrough guide for the support page, Release Notes, Documentation, Manuals, and “How To” guides.

For everything else do not hesitate to contact us at support@blyott.com.

Thank you for your attention, Blyott Support Team

Helpful Unhelpful

Share