Twilio Node

The Twilio Node allows a workflow to send SMS messages using the configured Twilio account.

Twilio Node

Configuration

The Twilio Node has a large number of configuration properties - everything needed to configure use of a Twilio account and the sending of SMS messages.

Twilio Account Configuration

Twilio Node Account Config

The most important part of the configuration is the Account SID and Auth Token for the Twilio account that should be used to send the SMS messages. In the example above, the node is configured to use the the Account SID YOUR_TWILIO_ACCOUNT_SID_HERE and the Auth Token YOUR_TWILIO_AUTH_TOKEN_HERE.

Optionally, the maximum allowed price of an SMS message can be configured (see Twilio's API Docs for more information on this field).

All of the account configuration inputs, except for the maximum price, support string templates.

Message Configuration

Twilio Node Message Config

When configuring the actually SMS message, a "From Number" or "From SID" (MessagingServiceSid) must be provided to be the source of the SMS message. The field supports string templates, but in the common case this will be set to a static value.

Next is the actual message to send - this can include a message, a media URL, or both. At least one of the two must be provided. Both fields support string templates. In the above example, only the message is being set, to the value Power level exceeded error threshold at {{ data.power }}!

Recipient Numbers

Twilio Node Recipient Numbers

Multiple phone numbers can be provided to the Twilio Node. The recipient phone number fields support string templates, so the phone numbers can potentially be pulled off of the payload. As a note, when multiple phone numbers are defined, multiple individual SMS messages will be sent - one to each recipient phone number (it does not create a group SMS message). In the above example, the SMS message is only sent to a single phone number, (212) 867-5309.

Result information

Twilio Node Result

Optionally, a payload path can be provided to store the results of the SMS message sends. If one is provided, the Twilio Node will place an array at this path, with one entry per recipient number (it will be in the same order as the recipient numbers as well). In the case of a successful send to a number, the value will be the object { success: true }. In the case of an error, the value will be an object of the form { error: true, message: 'A message describing the error' }. In the case of the node configured in this example, the payload after the node runs might look like the following:

{
  "data": {
    "power": 73,
    "smsResults": [
      { "success": true }
    ]
  },
  ...
}