Flows
Flows Overview
Our Flows are a function that allows you to map user-defined processes and workflows.
Basics:
Elements of the flow
Create / edit flow
Flow List
Flow Insights (/en/article/flow-insights-23k2wfSome readersHotline
Hotline
With GroupAlarm you can start, manage and monitor a dynamic first responder hotline in a few steps.
How it works
You create a new hotline and automatically get assigned a phone number from your local area network. You now assign any number of agents to this hotline in the form of subscribers from your organization. These agents maintain their phone numbers themselves in theirSome readersELS: iSE-Cobra 4
ELS: iSE-Cobra 4
In addition to the webin.php interface, GroupAlarm can also be used with the mission control system iSE-Cobra 4 via the WDX3 interface.
For this, you have to specify a login server, generate client certificates as well as create corresponding service credentials.
Only then can a secure connection to the ELS be established.
In addition, you must configure several kSome readersPager management
Pager management
This module is an optional extension and must be activated first.
In the pager management you can view statistics about your pagers, manage them as well as register new pagers.
Under "Statistics" the percentage of availabilities and the number of pagers tSome readersSupport
Support
In the support section, you can find all options to contact our customer support.
By default, our support staff does not have access to your organization. We can assist you more efficiently with potential problems if you grant our team full access to your system. To do this, click the "Grant Access." buttonFew readersPermissions
Permissions
In the "Permissions" menu, you can configure access permissions and assign them to participants.
In addition, you can generate API keys that can be used with third-party systems.
Roles
In this section, roles are defined for the organization, which can be assigned to individual participants.
A role assigns specific permissions (read, edit, create, delete) to the different functions of GroupAlarm (e.g. user, alarm, remote trigger).
The default roles "Organization Owner", "Few readersMessanger
Messenger
By default, each organization gets a room with the same name, which contains all users of the organization and is automatically kept in sync with them.
Dedicated rooms
Dedicated rooms are ideal to give subgroups, teams, or committees a simple communication channel.
The overview of all rooms is located in the menu under "Administration" "Messenger" andFew readersRemote Trigger
Remote Trigger
GroupAlarm has the option of triggering an alarm via call or SMS.
For this purpose, a phone number has to be activated in the menu "Remote triggering" and a triggering PIN has to be defined. Only if the triggering number and PIN match the data stored here, an alarm can be triggered.
Call
0used as the alarm text in the generated alarm.
Confirm your entries with the "APFew readersQuotas
Quotas
An organization's quotas limit the number of times a specific service, such as flows, can be executed. This highly set limit prevents accidental overuse of a service, which can lead to unexpectedly high costs in the billing process.
All of your organization's quotas can be found under "AdministratFew readersExtentions
Extensions
GroupAlarm can be further customized with extensions that add additional functionality in the areas of alerting and management within your organization.
Add extension
Select the tab "Extensions" and click on "Add extension".
In the pop-up window, you can now search for the desired extension, learFew readersArrival time at the organization location is not displayed
Arrival time at the organization location is not displayed
In order for an arrival time to be determined and displayed, the following must be true:
The organization has a location set up ("Organization Settings" "Location").
The app is running version 2.0.0 or higher
The app has the necessary permissions to retrieve the locationFew readersAudit
Audit
The audit log lists all important events within your organization. This includes, for example, the creation and editing of elements, the addition, and removal of users and much more.
If available, it displays the responsible trigger, the affected resource, the event itself, and the time.
Possible triggers of an event can be a person user, a flow or a vpnkey API access by an organization token.
(https://storage.crisp.chat/users/helpdesk/website/606406d8d6f6d000/7eb11125-2f6bFew readersBilling
Billing
In the billing interface, you can manage your stored billing address and payment method.
Setup
All organizations need to have a billing method set. As a sub-organization, you can have your parent organization manage the billing, or you can set up your own payment method.
By clicking on the "Set up billing" button, you can store a new payment method. To do this, log in with an existing customer account. Alternatively, you can create a new customer account.Few readersConfigure Flow: XML parser
Configure Flow: XML parser
To use data from an XML document within the flow, you can use the XML parser to specify your own variables, which are searched for and saved in the transferred XML document.
Each variable receives a user-defined name and the path to the desired data in the XML document.
In addition, youFew readersCreate / edit flow
Create / edit flow
The flow builder is used to create a flow. You can open it by either creating a new flow or editing an existing flow.
If you create a new flow, you will land on the following page:
Here you see only a dashed circle at the top, which is a placeholder for a trigger. Triggers are the starting point for every flow. To begin, drag any trigger from the function box at the bottom right ontFew readersConfigure Flow: HTTP trigger
Configure Flow: HTTP trigger
With this trigger, a flow can be triggered by executing an HTTP call to the stored URL.
The URL is generated automatically and can only trigger this flow.
You can use the common HTTP methods 'GET', 'POST', 'PUT', 'PATCH' and 'DELETE'. The following entities are available for the following functions in the flow:
HTTP method used
Header (list)
Query Parameters (List)
Body (Base64 Encoded)
Protocol used
IP and port of the sender
Since you cannot use lisFew readersFlow Triggers
Flow Triggers
Flow triggers are events that can start a flow.
The following flow triggers are available:
Alarm Resolved
This trigger starts a flow when an alarm has been raised in the organization.
Alarm closed
This trigger starts a flow when an alarm in the organization has been closed.
DWD weathFew readersFlow list
Flow list
Within the flow list, you have a direct overview of the configured flows of the organization.
In the left column with the title "Valid" you can see whether the respective flow is valid. Only a valid flow will be executed.
In the column with the trigger icon, you can see the respective trigger of the flow.
On the right, you can use the context menu to edit or delete the flow or access tFew readersConfigure Flow: DWD Weather Warning Trigger
Configure Flow: DWD Weather Warning Trigger
The trigger for DWD weather warnings triggers a flow when there is a new DWD weather warning for the configured area. Using the configurable warning criteria and warning level, you can specify at which DWD weather warnings your flow should be triggered.
In addition, you can specify a time period in which all incoming weather warnings are deduplicated based on the warning cell, warning type and warning level. A flow is only triggered if either tFew readersConfigure Flow: Check for String
Configure Flow: Check for String
With the "Check for String" function, you can check whether a string is contained within an entity of a function that has already run.
For example, you can check whether the alarm message of a triggered alarm contains the string "TESTALARM" or whether the alarm was triggered by a defined tag.Few readersConfigure Flow: Text Parser
Configure Flow: Text Parser
To be able to use values contained in a text as variables in the flow, you need the text parser.
With this, you can search directly for a so-called "key" and save the subsequent text of the same line as a variable.
The basic functioning is explained with the following text:
Hello GroupAlarm,
I would like to trigger an alarm with the following parameters:
Event: TESTALARM
Alarm text: TEST Do not move out!
LONG50.76382
LAT6.0793028
Address: GoethestraßFew readersConfigure Flow: Send e-mail
Configure flow: Send e-mails
To send e-mails through a flow, you can use the "Send e-mail" function.
Here you can use the participants' email addresses or your own addresses as recipients.
For the already existing participants, use the suggested entries when you start typing.
For your own e-mail addresses, enter them completely and confirm the e-mail address with the Enter key.
To add an attachment from a URL to the e-mail, first select the option "Insert attachment".
In the following fiFew readersConfigure Flow: Receive Email Trigger
Configure Flow: Receive Email Trigger
The "Receive Email" trigger initiates a flow when it receives an incoming email to an email address specified by the system.
It is possible to specify a list of permitted senders so that not every participant can trigger flows. If this list is empty, any sender can trigger the flow.
The following entities are available for the following functions in the flow:
Sender
Subject
Message in plain text
Message as HTML
The message in HTMLFew readersInherit Flows
Inherit Flows
If your organization has further sub-organisations, you can inherit configured flows to them. The configuration you have made in the inheriting organization remains intact and cannot be overwritten by an inheriting organization. However, administrators of the inheriting organizations can see a preview of the flow. To inherit a flow to sub-organisations, select the button 'Inherit' within the edit mask on the right and finally click on 'SAVE'.
As the resources - e.g. labelsFew readersConfigure Flow: Search Event
Configure Flow: Search Event
Use the Search Event feature to search for an event in your organization.
Select either a Name to search for or an exact matching External ID of an event.
You can also specify the event state (open, closed, archived) that the event to be searched for should have.
If the event is found, it is located within the result of this function and can be used in the further course of the flow.Few readersIMAP Trigger
Configure flow: IMAP Trigger
With the IMAP Trigger, you trigger a flow when an e-mail is received in the configured mailbox.
The following information is available for the following functions in the flow:
Internal ID
ID of the e-mail message
Timestamp of processing
Subject
Sender
Recipient
Time stamp of the e-mail
Body (text)
Body (HTML)
Configured attachments
In order to use attachments in subsequent functions, you must explicitly provide them with a variable. To do thFew readersConfigure Flow: Check for one or more strings
Configure Flow: Check for one or more strings
This function combines several "Check for string" conditions in an OR operation. The character string is thus checked for different contents.
This way, you can ensure that several wordings trigger the same alarm.Few readersConfigure Flows: Format Alarm
Configure Flows: Format Alarm
Format the details of an alarm with a configured string. In this text, use the given variables to insert the details of the alarm into your text. The following variables are available for this purpose:Few readersConfigure Flow: JSON parser
Configure Flow: JSON parser
To use JSON values within the flow, you can use the JSON parser to specify your own variables that are searched for and stored in the JSON payload passed.
Each variable is given a user-defined name and the path in your JSON payload.
In addition, you can specify whether a variable is mandatory. If this is then not found in the JSON payload, the flow terminates with a corresponding error message and does not exFew readersFlow functions
Flow functions
Currently, the following functions are available within a flow:
Trigger alarm
Triggers an alarm with the configured resources.
Format Alarm
Format the details of an alarm with the configured string.
Load alarm (https://storage.crisp.chat/users/Few readersFlow Insights
Flow Insights
The insights of a flow contain all triggered events of a flow. These are saved with the start and end time and show whether the execution of the flow was successful. Use the right button to access the live view of the entry.
Within the live view, you can see which functions theFew readersElements of the Flow
Trigger
Triggers are events that can start a flow.Few readers