Introduction

Twilio is a web service that can be used to send SMS.

Prerequisites

• A Twilio account is required.

• From your Twilio account console, note Account SID, Auth Token, and Phone number.
  
  

  Open

  

Configure Twilio within the NETx Core Studio

• In the Core Studio menu, open Modules → Messenger → [Live] Twilio SMS.

• Right-click to open the context menu and select Insert new definition to add a new profile.

• Fill the following fields:

  Open

  

  • Profile: profile name

  • AccountSid: Account SID as in your Twilio console

  • AuthToken: Auth Token as in your Twilio console

  • SenderPhoneNumer: the Phone number as in your Twilio console

• Save the definition table. Changes are immediately applied.

Send a message via XLogic

Use a Twilio SMS messenger profile in combination with the MESSENGER.SENDSMS XCommand.

Testing

To test the profile from the Core Studio,

• Go to Menu → Tools → Run XCommand…

• Select XCommand MESSENGER.SENDSMS and fill out the required fields:
  
  

  • Profile: the name of the configured profile (note: if the profile name does not exist or if this parameter is blank, the first found Twilio SMS definition will be used)

  • Recipient: recipient phone number

  • Message: message text as string

• Click Execute to send the message.

You will receive the message on the device with the provided phone number, shortly.

Send a message from an action

In order to send an SMS triggered by an alarm or a conditional event,

• Set up an action that uses the MESSENGER.SENDSMS XCommand.

• Select the configured Twilio profile and provide Recipient and Message.

• Save the action.

• Use this action in the desired alarm or conditional event.

Send a message via LUA

To send an SMS within LUA scripts, use the XMessage LUA function.

XMessage is a general LUA function that can be used to send notification and visualization message via LUA. For sending an SMS, use the following parameter values:

• Device: not used for sending SMS. Leave empty.

• UserOrGroup: not used for sending SMS. Leave empty.

• MessageType: "TwilioSms"

• Parameter1: name of the Twilio SMS messenger profile

• Parameter2: recipient phone number

• Parameter3: message text as string

The following example uses the Twilio SMS messenger profile "tw" to send an SMS: