Message action

Send an email or SMS

Use the Message action to send a customisable email or SMS message to one or more recipients.

The message can include links to the input item(s) and emails can include attachments. All fields can be populated dynamically, based on the output of other nodes in the workflow.

All messages begin with a default template:

We are messaging you because the workflow: X was triggered

This is followed by the contents of the action's Message Text attribute. However, if Message type is set to Email, you can override this by populating the Template attribute.

Details

Icon	Action	Description	Availability	Input	Output
	Message	Send a email or SMS to one or more recipients	Always	None	None

Configuration

To configure a Message action node when building a workflow:

1. Add a new action. Alternatively, select an existing action, and then select Edit in the action bar.

2. In the right panel, set the Message type, and then fill in the following fields as needed:

   Email

   The following fields will appear:

   • Email to - specify the email address(es) to send to. If you supply a Constant value, you can enter multiple email addresses separated by a comma with no spaces.

   • Subject - specify a distinctive subject line for easy identification.

   • Attachments - optionally select one or more files stored in Alloy.

   • Template - override the default message template with custom text. Enter {{message}} to include the contents of the action's Message Text.

   
   Sms

   The following field will appear:

   • Mobile Number - the phone number to send to. Include the country code and no spaces!

   

3. Fill in the following fields as needed:

   • Message Text - specify the message's text content.

   • Recipient Name - specify the name of the recipient.

   • Linked Items - the message will include hyperlinks to the specified items.

   • Single Instance - if enabled, the action will always be performed once, no matter how many input items there are. If any fields are configured with a dynamic value, the values for all input items are combined into one.

     For example, imagine a Message action where Linked Items is dynamically linked to the output of the preceding stage. It receives three input items. If Single Instance is disabled, three emails are sent containing one item. If enabled or undefined, one message is sent containing three items.

4. Select Validate to check if the action can be saved as configured. A notification will appear to indicate success or failure.

5. If successful, select Save to finish.

Dynamic values

Fields marked with can accept a dynamic value:

• Constant - select or enter static values.
• Offset - set a date/time relative to when the workflow triggers.
• Link - link to the corresponding output of any preceding stage in the current branch path (one item).
• Output - reference the total output of any action in the sequence (one or more items).

Caution

If an action attribute displays as <<Computed>>, its value is determined by the output of a workflow computation. If you enter a new value and save, the computation will be overwritten!