Instant Messaging Tasks

Patriot 6 has many tasks available which can be configured to trigger automatically when certain signals are received into the system. When the task is triggered, it will send a message to a recipient containing information about the received signal.

Available Tasks (Optional Modules)

The following are a list of tasks that can be assigned for instant messaging:

Paging PET Protocol: Sends Paging message via PET protocol paging provider

GSM: Sends SMS txt message via GSM network

SMS Gateway: Sends SMS via Clickatell SMS gateway. No hardware required.

Email: Sends email message via SMTP mail server

Telephony: Calls User and starts an outbound call chain

Smart Phone: Sends a notification direct to the phone. Also supports First Response Messaging.

Patriot 6 has a number of methods for assigning these tasks. The method or methods you use will depend on your requirements. The rest of this section will explain more about how tasks can be assigned and assist with the selection of the best method for your application.

Action Plans and Response Plans

The assigning of tasks revolves around action plans and response plans. So a clear understanding of how these work in Patriot 6 is essential before progressing.

Before proceeding, you should be able to assign an action plan at type level, client level, and global level. Although it is possible to assign action plans at zone or user level, this is usually only done in advanced situations.

You should also be able to assign a response plan to an action plan, and understand how users can be assigned to a response plan at client level and global level.

How to Trigger a Task

When a signal is received into the system, an action plan is assigned to the signal. The response plan associated with that action plan for this client is then used by the systems. Each user in the response plan can have one or more tasks assigned to them. As many users as you wish can be assigned tasks in the response plan. Each task that is assigned to a user in this response plan will trigger, sending a message to the user that the task is assigned to.

Messaging Queue

For each task assigned to each user, a message will be placed into the messaging queue, and remain there until it has been successfully sent, or reaches it number of maximum retires. The messaging queue can be used to monitor instant messaging, and manually delete messages you want to cancel.

So if User A has GSM and email assigned, and User B has GSM assigned. When triggered, 3 entries will be placed in the messaging queue. GSM to User A, Email to User A, and GSM to User B.

Note: Dependant on the speed of each task, some messages may be sent and cleared from the messaging queue quicker than the operator can view them.

Tasks are assigned to Users in the Response Plan area of the Response Tab of a client.

See ASSIGNABLE TASKS for how to do this.

Who receives the message?

The message is sent to the user who has the task assigned. The task will send the message to the address specified by the No. to Use field in the Task Settings Window.

no to use

No. to Use field

So if the GSM task has its Use field set to Mobile No, and our email task has its Use field set to Email 1, User A gets a GSM txt message sent to User A's mobile no, User A gets an email sent to User A's email address 1, User B gets a GSM message sent to User B's mobile no.

Configuring the message

The contents of the message can be customized to meet the needs of the of the task its performing. Certain task allow for several message formats to be configured, so a particular format can be used to suit a particular task.

To configure the message format, open the task settings window, and then click on the Edit Message Formats Button.

Message Formats
Message Formats

The Default message format will already exist. If the task allows it, additional message formats can be added using the plus button. Each message format can have:

Header Text that is added at the start of a message.
Footer Text that is added at the end of a message.
Field Separator Text that is used to separate each part of the message. Default is space.
Default Message Details If this option is selected, the message will contain:
  1. The signal date and time
  2. The client's external reference number
  3. Client's name
  4. Signal type number
  5. Module number
  6. Zone number
  7. Signal description
Customized message details If the Default Message Details option is unchecked, you can choose what information to include in the message.

The labels for default message fields can be edited by changing the Tasks section of the Translation Resources. Some of these labels may be blank by default.

For instructions on how to modify these labels, see Language Translation.

If additional message formats are defined, you are able to select which format is used when you assign a user into the response plan, see Additional Settings section of Assignable Tasks.

Choosing the right setup

The best way of setting up assignable tasks depends on how your action plans and response plans have been setup.

Read the Suggestions and hints for settings up Response Plans section from the response plans document. Note that the After Hours Callout option will not work here, because it does not support assignable tasks. To trigger a task, a user must be assigned to a response plan.

Common ways of setting up assignable tasks:

One cell phone handed around to the guard on patrol

This situation is very easy to setup. If you don't already have one, create a global services template (the system comes with a standard global services template with a client id of GLOB). Create a user to represent the guard on duty (enter the cell phone number into the guards contact details), and assign this user to the global services template. Now go to Maintenance -> General -> Action Plans. For each action plan that you want paged to the guard, select the action plan, click change, Under Global Response Plan, select the Global Services Template using the folder button. Then click on Assign Response Plan, and assign the Guard to the response plan, also assign the task to the guard.

This will add the guard to all response plans (for each action plan setup by above procedure) for all clients in the database.

Client requests certain events sent directly to them

Firstly, make sure that a user record representing the client exists, and has been assigned to the client record. Go into the client, click on the Update Response Plans button, and assign the user to each of the desired action plans, also assigning the relevant task as required. Note that if you have setup a response plan for this client at client level, doing this will override the client level response plan, so you will also need to assign any other users required in the new response plan at the same time.

Receiving Messages Back

Patriot's instant messaging tasks all support inbound messages of various types. Each messaging task can will support a single received message type - if you need to receive different types of messages (e.g. Identicom and First Response) you will need to setup multiple messaging tasks. Recv. Message Type is selected on the instant messaging task setup screen. Some received message types are hardware specific (e.g. Identicom, Minor Planet etc.) but most common are the three generic message types: Standard, First Response & Log To Device.

Recevied Message Types
Received messages types as supported by the GSM task

Standard

The Standard received message type is support by the GSM and Email tasks. When the Standard message type is selected, received messages must be sent in one of the formats specified here. This message type supports receiving alarm & alarm acknowledgment messages and can be used in combination with escalated messaging.

Log To Device

The Log To Device received message type is support by the GSM and Email tasks. When the Log To Device message type is selected, all received messages are simply logged to the client account with matching caller ID no. set on the client maintenance tab, in the Device Ref. No. field.

Received Log To Device messages are logged to the client as regular signals with the system generated type no. 65,080.

First Response

This feature requires the First Response module, and can be used with either the GSM, Email, or Smartphone Tasks.

This can allow a user the chance to respond to the activation before it is shown to the operator. The user first receives a message via SMS, Email, or the Plink App. Usually the action plan for the alarm must have the 'put to sleep' special option, to give the user a chance to respond before the activation is shown to operators. The User can then decide whether to respond to the alarm themselves, which will acknowledge and clear the activation, or in the case of Late To Close alarms they can also make temporary schedule changes that extend the closing time.

Message Reply format for First Response:

For Email and SMS notifications, the user needs to reply to messages using a specific format. There 2 options on the Task that relate to First Response.

First Response Task Options
First Response Task Options

Related Pages