Text Message

The Text Message output in ArcGIS Velocity allows you to send a text message using an externally accessible SMTP server. You can configure the subject and message body of the text message to use attribute values. A text message is sent for each output feature sent to the output.


  • An analyst configures a real-time analytic to filter events ingested by a feed and sends a text message for any features that meet the filter criteria.
  • After performing analysis in a big data analytic, a researcher wants to summarize attributes of the results and send the resulting information in a text message.

Usage notes

  • The SMTP server must be externally accessible on the internet.
  • When using the Text Message output, it is important to understand the velocity of the data. Each record sent to the output will generate a separate text message. This could quickly overload the capacity or rate limiting settings of an SMTP server. As a best practice, do not configure the Text message output to send more messages than your SMTP server can handle.
  • Text messages can be sent to a single recipient or to a set of recipients using a comma-separated list.
  • Text message recipients can be configured from an existing field or by entering phone numbers for each carrier.
    • If configured from a field, the addresses should be in the format: number@carrier_domain. For example, for a phone number of (123) 456-7890 using the carrier AT&T, the corresponding recipient address is (123) 456-7890@txt.att.net.
    • If you're entering recipients by carrier, provide the phone numbers for each carrier selected in the Carrier drop-down menu.
  • Phone numbers can be formatted as (123) 456-7890 or as 1234567890. All extraneous characters are removed in processing.


ParameterDescriptionData type

SMTP host

The SMTP server that will send the text message—for example: smtp.HOST-NAME.com.


SMTP server security

The type of SMTP encryption to use on all outgoing messages. Options are as follows:




The user name for the SMTP server.



The password for the SMTP server.


Sender's address

The address that will appear as the sender of the text message—for example: (123) 456-7890@txt.att.net.



The text message recipient or recipients. These can be supplied by an attribute in the outgoing data, or manually when configuring the output.

If you're using an attribute from the data and sending text messages to more than one recipient, use a comma-separated list.

Single-recipient example: (123) 456-7890@txt.att.net

Multiple-recipient example: (123) 456-7890@txt.att.net,(234) 567-8901@txt.att.net,(345) 678-9012@txt.att.net

If you're configuring manually, provide the phone numbers for each carrier selected from the drop-down menu. Multiple recipients can be entered in a comma-separated list.

Single-recipient example: (123) 456-7890 with @txt.att.net selected from the Carrier drop-down menu.

Multiple-recipient example: (123) 456-7890,(234) 567-8901,(345) 678-9012 with @txt.att.net selected from the Carrier drop-down menu.



The subject of the text message. The subject can be configured in a single-line Arcade expression.

Arcade Singleline Text

Message body

The body of the text message. The message body can be configured in a multiline Arcade expression.

Access a feature attribute value by enclosing it in the following token sequence: $${$feature.any_attribute_name}.

Arcade Multiline Text

Considerations and limitations

  • The SMTP server must be externally accessible on the internet.
  • It is recommended that you use the Text Message output for incidents expected to occur relatively infrequently.