Send SMS

Use this node to send an SMS to one or more phone numbers via a configured SMS provider — for example, alerting on-call staff when a sensor threshold is exceeded, or sending a confirmation code to a user’s mobile.

• Phone Numbers To Template — required. Comma-separated list of target phone numbers. Supports templatization.
• SMS Message Template — required. Content of the SMS. Supports templatization.
• Use System SMS Provider Settings — when enabled, uses the SMS provider configured at the system/tenant level. When disabled, configure the provider directly in this node.

1. Resolve phone numbers from the template using message data and metadata.
2. Resolve the SMS message content from the template.
3. Send the SMS asynchronously via the system or custom SMS provider.
4. Route via Success on delivery, or Failure on error. Message data and metadata are not modified.

Data: { "temperature": 85.3 } | Metadata: { "deviceName": "Sensor 01", "userPhone": "+15551234567" }.

{
  "numbersToTemplate": "${userPhone}",
  "smsMessageTemplate": "Device ${deviceName} has high temperature $[temperature]",
  "useSystemSmsSettings": true
}

Result: SMS "Device Sensor 01 has high temperature 85.3" sent to +15551234567. Routes via Success.

{
  "$schema": "https://json-schema.org/draft/2020-12/schema",
  "title": "TbSendSmsNodeConfiguration",
  "type": "object",
  "required": ["numbersToTemplate", "smsMessageTemplate", "useSystemSmsSettings"],
  "additionalProperties": false,
  "properties": {
    "numbersToTemplate": { "type": "string" },
    "smsMessageTemplate": { "type": "string" },
    "useSystemSmsSettings": { "type": "boolean" },
    "smsProviderConfiguration": { "description": "Required when useSystemSmsSettings is false." }
  }
}