Escalating Messaging allows a series of escalating steps to be setup.
If an outbound message fails to send, or if the recipient does not acknowledge the message, then follow-up messages can be sent to ensure that the event is correctly responded to.
Optionally, the activation can initially be hidden from the monitoring operator. It can be shown to the operator as one of the escalation steps, if the earlier stages fail.
Advanced Messaging Module
Supported Messaging Task(s) (e.g. GSM, Telephony)
There can be up to 250 steps of Escalation (levels 0 - 249). Messages with escalation level 0 are sent immediately, then each level after that is sent in order. Escalation levels 250 and above are reserved and cannot be used.
Multiple messaging events and users can be assigned at the same level. E.g. you can have the initial event SMS to a user, if they fail to acknowledge, the event can be displayed for the operator, and an email message can also be sent.
Automated Alarm Handling (Delay then alarm if no restore etc) should not be used on the event type that is receive if you wish to use escalation.
Escalation to the next level will only occur if an acknowledgement is not received, or if the message fails to send entirely (e.g. hardware/network failure).
Set up the messaging tasks which will be used. Additionally, check the following task settings and set them appropriately.
Attempts: If the message fails to send entirely, or if the user does not acknowledge the message, it will be resent automatically. This field controls how many times the task will try to message each user before failing and moving to the next escalation level. Typically this will be set to one when using acknowledgement.
Acknowledge Wait time. If the user has not provided the acknowledgement within this time, it will be considered a failed attempt. Be sure to allow the user enough time to acknowledge, to prevent unnecessary escalation (e.g. it might take 1-2 minutes to read and reply to an SMS message).
Complete Activation on Ack: If this option is enabled, the activation will be completed when a successful acknowledgement is received.
If you want to hide the activation from the monitoring staff initially, to allow the messaged user to handle the activation, you will need to set up the Operator Response task and add it to the response at the required escalation level. You will also need to configure the action plan to hide the activation initially. On the advanced tab of the Action Plan, set the special option to Put To Sleep. This will put the activation straight to sleep, which stops the operator from seeing it. If the sleep time elapses or the assigned Operator Response task is triggered, the activation will be shown to the operators.
Go into the assign Response Plan window for the Action Plan which is to be used.
Assign all the users and the tasks required.
Set the escalation level of each assigned task by double clicking on the assigned task. This will show the Update Task Parameters window, which contains the escalation level setting. The default setting is 0, which means the message is sent straight away. A setting above 0 indicates the escalation level of this message.
If the assigned task supports acknowledgements, this window will allow you to require the acknowledgement is received. Typically you will always require acknowledgement for tasks which support it. Acknowledgement should be enabled on at least one task per escalation level, to ensure that higher escalation levels are triggered if the message is not acknowledged correctly. Otherwise, escalation will only occur if the initial sending of the message fails.
Note: Telephony messages always require acknowledgement, and are not removed until the assigned dial plan indicates that the call was completed successfully.
Currently only two tasks support acknowledgements: The GSM Task, and the Telephony task.
The specific method of acknowledging a message depends on the assigned task. For example, GSM acknowledgements require a reply text with a special format. Telephony calls might require the user to input a PIN to verify their identity etc.
Once an acknowledgement is received, any escalation messages are automatically removed. Acknowledgements also cover any other messages sent to the user (e.g. Email + SMS). Messages sent to other users are not removed, and must still be acknowledged.
If an acknowledgement is not received in time, a signal is logged to indicate the failure. This helps to keep account of acknowledgement rates and reply times.
Common Setup
GSM Messaging task settings: Tick on Complete Activation On Ack. Set the Ack Wait Time to 60 seconds.
Setup Operator Response Task.
Create a new action plan called Acknowledge Required. Set the special option to Put To Sleep. Make sure the client is setup so this action plan is used for any alarm events that are to be handled with escalation.
When an alarm event is received from a particular client, a text message will be sent to user A and the activation report will be put straight to sleep so the operator doesn't see it. If user A acknowledges the text message, the activation will be completed, and all other pending messages for this event will be removed. If user A fails to acknowledge the text message within the required time limit, the activation will be displayed to the operator, and an email message will be sent to user B.
On the Response tab of the client, for the Acknowledge Required action plan, assign GSM task to user A with an escalation level set to 0, and Acknowledge required enabled. Assign email task and operator response task to user B, setting the escalation level on both of these to 1.
When an alarm event is received from a particular client, a text message will be sent to user A and the activation report will be put straight to sleep so the operator doesn't see it. If user A acknowledges the text message, the activation will be completed, and all other pending messages for this event will be removed. If user A fails to acknowledge the text message within the required time limit, a text message will be sent to user B. If user B acknowledges the text message, the activation will be completed, and all other pending messages for this event will be removed. If user B fails to acknowledge the text message within the required time limit, the activation will be displayed to the operator, and an email message will be sent to user C.
On the Response tab of the client, for the Acknowledge Required action plan, assign GSM task to user A with an escalation level set to 0. Assign GSM task to user B with an escalation level set to 1. Assign email task and operator response task to user C, setting the escalation level on both of these to 2.
When an alarm event is received for a particular client, a text message will be sent to both users A and B. If the message is not acknowledged by either user, an email and text message are sent to user C. If user A or B acknowledges the text message, nothing is sent to user C. However if either A or B fails to acknowledge, a signal is logged to indicate they did not acknowledge correctly.
On the Response tab of the client, for the Acknowledge Required action plan, assign GSM task to user A with an escalation level set to 0. Assign GSM task to user B with an escalation level set to 0. Assign email task and GSM task to user C, setting the escalation level on both of these to 1.