# 11 SMS sender

### General

SMS sender is a service that lets users configure WCC Lite to send SMS on a set tag triggers.

<p class="callout success">SMS sender functionality is available since firmware version v1.5.4, of WCC Lite.</p>

### Configuring SMS sender

To configure WCC Lite to use SMS sender and user must fill in the needed parameters in Excel configuration. These parameters are shown in the tables below.

*SMS sender parameters for Devices tab:*

<table border="1" id="bkmrk-parameter-type-descr" style="border-collapse: collapse; width: 100%; height: 228px;"><tbody><tr style="height: 44px;"><td class="align-center" rowspan="2" style="width: 16.4814%; height: 54px;">**Parameter**  
  
</td><td class="align-center" rowspan="2" style="width: 9.07411%; height: 54px;">**Type**  
  
</td><td class="align-center" rowspan="2" style="width: 25.8644%; height: 54px;">**Description**  
  
</td><td class="align-center" rowspan="2" style="width: 10.2777%; height: 54px;">**Required  
</td><td class="align-center" rowspan="2" style="width: 18.9044%; height: 54px;">**Default value**

(when not specified)

</td><td class="align-center" colspan="2" style="height: 44px; width: 19.3827%;">**Range**

</td></tr><tr style="height: 10px;"><td class="align-center" style="height: 10px; width: 9.62963%;">Min

</td><td class="align-center" style="width: 9.75309%; height: 10px;">Max

</td></tr><tr style="height: 29px;"><td style="width: 16.4814%; height: 29px;">name</td><td style="width: 9.07411%; height: 29px;">string</td><td style="width: 25.8644%; height: 29px;">User-friendly device name</td><td style="width: 10.2777%; height: 29px;">Yes</td><td style="width: 18.9044%; height: 29px;">  
</td><td style="width: 9.62963%; height: 29px;">  
</td><td style="width: 9.75309%; height: 29px;">  
</td></tr><tr style="height: 29px;"><td style="width: 16.4814%; height: 29px;">description</td><td style="width: 9.07411%; height: 29px;">string</td><td style="width: 25.8644%; height: 29px;">Description of the device</td><td style="width: 10.2777%; height: 29px;">No</td><td style="width: 18.9044%; height: 29px;">  
</td><td style="width: 9.62963%; height: 29px;">  
</td><td style="width: 9.75309%; height: 29px;">  
</td></tr><tr style="height: 29px;"><td style="width: 16.4814%; height: 29px;">device\_alias</td><td style="width: 9.07411%; height: 29px;">string</td><td style="width: 25.8644%; height: 29px;">Device alias to be used in configuration</td><td style="width: 10.2777%; height: 29px;">Yes</td><td style="width: 18.9044%; height: 29px;">  
</td><td style="width: 9.62963%; height: 29px;">  
</td><td style="width: 9.75309%; height: 29px;">  
</td></tr><tr style="height: 29px;"><td style="width: 16.4814%; height: 29px;">enable</td><td style="width: 9.07411%; height: 29px;">boolean</td><td style="width: 25.8644%; height: 29px;">Enabling/disabling of a device</td><td style="width: 10.2777%; height: 29px;">No</td><td style="width: 18.9044%; height: 29px;">1</td><td style="width: 9.62963%; height: 29px;">0</td><td style="width: 9.75309%; height: 29px;">1</td></tr><tr style="height: 29px;"><td style="width: 16.4814%; height: 29px;">protocol</td><td style="width: 9.07411%; height: 29px;">string</td><td style="width: 25.8644%; height: 29px;">Selection of protocol</td><td style="width: 10.2777%; height: 29px;">Yes</td><td style="width: 18.9044%; height: 29px;">  
</td><td colspan="2" style="width: 9.62963%; height: 29px;">**SMS sender**</td></tr><tr style="height: 29px;"><td style="width: 16.4814%; height: 29px;">host</td><td style="width: 9.07411%; height: 29px;"><div><div>array</div></div></td><td style="width: 25.8644%; height: 29px;">List of phone numbers to send SMS to, separated by space.</td><td style="width: 10.2777%; height: 29px;">Yes</td><td style="width: 18.9044%; height: 29px;">  
</td><td style="width: 9.62963%; height: 29px;">  
</td><td style="width: 9.75309%; height: 29px;">  
</td></tr></tbody></table>

[![image-1632837719431.png](https://wiki.elseta.com/uploads/images/gallery/2021-09/scaled-1680-/image-1632837719431.png)](https://wiki.elseta.com/uploads/images/gallery/2021-09/image-1632837719431.png)

*SMS sender parameters for the Signals tab:*

<table border="1" id="bkmrk-parameter-type-descr-0" style="border-collapse: collapse; width: 100%; height: 455px;"><tbody><tr style="height: 44px;"><td class="align-center" rowspan="2" style="width: 17.0987%; height: 54px;">**Parameter**  
  
</td><td class="align-center" rowspan="2" style="width: 8.45683%; height: 54px;">**Type**  
  
</td><td class="align-center" rowspan="2" style="width: 32.0373%; height: 54px;">**Description**  
  
</td><td class="align-center" rowspan="2" style="width: 16.5739%; height: 54px;">**Required  
</td><td class="align-center" rowspan="2" style="width: 10.1389%; height: 54px;">**Default value**

(when not specified)

</td><td class="align-center" colspan="2" style="height: 44px; width: 15.8025%;">**Range**

</td></tr><tr style="height: 10px;"><td class="align-center" style="height: 10px; width: 14.5679%;">Min

</td><td class="align-center" style="width: 1.23457%; height: 10px;">Max

</td></tr><tr style="height: 29px;"><td style="width: 17.0987%; height: 29px;">signal\_name</td><td style="width: 8.45683%; height: 29px;">string</td><td style="width: 32.0373%; height: 29px;">User-friendly signal name</td><td style="width: 16.5739%; height: 29px;">Yes</td><td style="width: 10.1389%; height: 29px;"></td><td style="width: 14.5679%; height: 29px;">  
</td><td style="width: 1.23457%; height: 29px;"></td></tr><tr style="height: 29px;"><td style="width: 17.0987%; height: 29px;">device\_alias</td><td style="width: 8.45683%; height: 29px;">string</td><td style="width: 32.0373%; height: 29px;">Device alias from a Devices tab</td><td style="width: 16.5739%; height: 29px;">Yes</td><td style="width: 10.1389%; height: 29px;">  
</td><td style="width: 14.5679%; height: 29px;">  
</td><td style="width: 1.23457%; height: 29px;">  
</td></tr><tr style="height: 29px;"><td style="width: 17.0987%; height: 29px;">signal\_alias</td><td style="width: 8.45683%; height: 29px;">string</td><td style="width: 32.0373%; height: 29px;">Unique signal name to be used</td><td style="width: 16.5739%; height: 29px;">Yes</td><td style="width: 10.1389%; height: 29px;">  
</td><td style="width: 14.5679%; height: 29px;">  
</td><td style="width: 1.23457%; height: 29px;">  
</td></tr><tr style="height: 29px;"><td style="width: 17.0987%; height: 29px;">source\_device\_alias</td><td style="width: 8.45683%; height: 29px;">string</td><td style="width: 32.0373%; height: 29px;">device\_alias of the source device</td><td style="width: 16.5739%; height: 29px;">No</td><td style="width: 10.1389%; height: 29px;">  
</td><td style="width: 14.5679%; height: 29px;">  
</td><td style="width: 1.23457%; height: 29px;">  
</td></tr><tr style="height: 29px;"><td style="width: 17.0987%; height: 29px;">source\_signal\_alias</td><td style="width: 8.45683%; height: 29px;">string</td><td style="width: 32.0373%; height: 29px;">source\_alias of the source signal</td><td style="width: 16.5739%; height: 29px;">No</td><td style="width: 10.1389%; height: 29px;">  
</td><td style="width: 14.5679%; height: 29px;">  
</td><td style="width: 1.23457%; height: 29px;">  
</td></tr><tr style="height: 29px;"><td style="width: 17.0987%; height: 29px;">enable</td><td style="width: 8.45683%; height: 29px;">boolean</td><td style="width: 32.0373%; height: 29px;">Enabling/disabling of a signal</td><td style="width: 16.5739%; height: 29px;">No</td><td style="width: 10.1389%; height: 29px;">1</td><td style="width: 14.5679%; height: 29px;">0</td><td style="width: 1.23457%; height: 29px;">1</td></tr><tr><td style="width: 17.0987%;">log </td><td style="width: 8.45683%;">integer</td><td style="width: 32.0373%;">Enable logging in the event log </td><td style="width: 16.5739%;">No</td><td style="width: 10.1389%;">0</td><td style="width: 14.5679%;">0</td><td style="width: 1.23457%;">  
</td></tr><tr style="height: 29px;"><td style="width: 17.0987%; height: 29px;">job\_todo</td><td style="width: 8.45683%; height: 29px;">string</td><td style="width: 32.0373%; height: 29px;">Specific SMS sender tag type</td><td style="width: 16.5739%; height: 29px;">Yes</td><td style="width: 10.1389%; height: 29px;">  
</td><td colspan="2" style="width: 15.8025%; height: 29px;">send-sms, device-control, device-status</td></tr><tr style="height: 29px;"><td style="width: 17.0987%; height: 61px;">tag\_job\_todo</td><td style="width: 8.45683%; height: 61px;">string</td><td style="width: 32.0373%; height: 61px;">SMS sender tag for **send-sms**:

*text message*

</td><td style="width: 16.5739%; height: 61px;">Yes</td><td style="width: 10.1389%; height: 61px;">  
</td><td colspan="2" style="width: 15.8025%; height: 61px;">  
</td></tr><tr style="height: 29px;"><td style="width: 17.0987%; height: 29px;">trigger</td><td style="width: 8.45683%; height: 29px;">string</td><td style="width: 32.0373%; height: 29px;">Trigger expression for the SMS to be sent</td><td style="width: 16.5739%; height: 29px;">No (Only for send\_sms)</td><td style="width: 10.1389%; height: 29px;">value!=0</td><td style="width: 14.5679%; height: 29px;">  
</td><td style="width: 1.23457%; height: 29px;">  
</td></tr></tbody></table>

To configure the SMS sender, 3 types of signals are mandatory. These values should be written inside the *job\_todo* field for each signal:

- **send-sms** - This signal takes value from the provided *source\_signal\_alias* field and checks if the value evaluates as true against the *trigger* field. If it is true, the SMS sender will send the text from the *tag\_job\_todo* field to the specified phone numbers.
- **device-control** - This signal controls if the SMS sender is enabled or disabled. Its *tag\_job\_todo* parameter should be set to enable. It takes value from the *source\_signal\_alias* field and evaluates it against the *trigger* field. If the *trigger* is evaluated as true, the SMS sender will be enabled, otherwise, it will disable the SMS sender.
- **device-status** - This signal indicates if the service is enabled or not. Its *tag\_job\_todo* parameter should be set to *enabled.*

Trigger expressions can be configured with basic comparison operators:

- Less than **&lt;**
- Greater than **&gt;**
- Less than or equal to **&lt;=**
- Greater than or equal to **&gt;=**
- Equal **==**
- Not equal **!=**

*Example configuration of SMS sender (Signals tab):*

[![image-1689241823615.png](https://wiki.elseta.com/uploads/images/gallery/2023-07/scaled-1680-/image-1689241823615.png)](https://wiki.elseta.com/uploads/images/gallery/2023-07/image-1689241823615.png)

Configuration --&gt; [Download](https://wiki.elseta.com/attachments/109)