Introduction
Us the Twilio is a web service to make a call to a phone and play a voice message.
Prerequisites
- A Twilio account is required.
- From your Twilio account console, note Account SID, Auth Token, and Phone number.
Configure Twilio Voice Message within the NETx Core Studio
- In the Core Studio, open Modules > Messenger > [Live] Twilio Voice Messge.
- Right-click to open the context menu and select Insert new definition to add a new profile.
- Fill the following fields:
- 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.SendVoiceMessage XCommand.
Testing
To test the profile from the Core Studio,
- Go to Tools > Run XCommand.
- Select XCommand MESSENGER.SENDSMS and fill the required fields:
- Profile: the name of the configured profile
- 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.SendVoiceMessage XCommand.
- Select the configured Twilio profile and provide Recipient and Message.
SCREENSHOT - 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 general LUA function that can be used to send notification and visualization message via LUA. For sending telegram messages, 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:
|