Skip To Content

Send a Text Message

The Send a Text Message Output Connector can be used to send a formatted message containing data from processed event data as a text message. Messages are structured as plain text and are sent as a request to a configured SMTP server to generate the text message for the identified recipients.

Usage notes

  • This output connector functions by taking event data, adapting it to construct a message as plain text, and then sending the message to an independent SMTP server as a request for it to generate the outgoing email.
  • This output connector pairs the Message Formatter Outbound Adapter with the SMS Outbound Transport.
  • A valid email address for each recipient is constructed using the phone number followed by the domain of the carrier, for example 6075557878@txt.att.net. The event count reported the output in GeoEvent Manager indicates the message containing event data has been sent to the specified SMTP server for delivery to the identified recipients. It does not indicate the success or failure of the SMTP server to create and send the email.
  • If a carrier is not present in the default carrier list, a new carrier can be specified in the SMS settings as part of GeoEvent Manager’s global settings. All that is required is the carrier name (key) and carrier domain (value). After adding, the new carrier will be displayed in the Carrier property list.
  • If there are different carriers for each recipient, configure multiple Send a Text Message outputs for each expected carrier. This avoids appending the incorrect carrier domain to a recipient phone number.
  • Contact your IT administrator to identify the host name, port, and authentication mode of your organization’s SMTP server. For example, port 25 is the well-known port for SMTP, but other ports may be in use by your organization.
  • A new default SMTP server host name, port number, authentication mode, username, and password can be specified in the SMTP settings as part of GeoEvent Manager’s global settings. By defining default values for each SMTP property, any newly configured output using the SMTP Outbound Transport such as the Send an Email Output Connector will display the correct information.

Parameters

ParameterDescription

Name

A descriptive name for the output connector used for reference in GeoEvent Manager.

Sender’s Email Address

The email address of the sender. The email address can be provided directly as a string of text or it can be dynamically obtained from a field in the event data using ${FIELD-NAME}. There is no default for this property.

Message Body

The message body of the email. Fields from the processed event data can be used to reference specific values in the outbound email message body. The default for this property is a placeholder string, Enter Message Body Here.

Example: A message structured like “Driver, ${DRIVER}, was going ${SPEED} miles per hour at ${TIME}” would return as “Driver, John Doe, was going 82 miles per hour at 14:25:30” in an outbound email.

Carrier

Specifies the carrier the recipient phone numbers are a member of. GeoEvent Server pairs the gateway/domain of the specified carrier to the recipient phone number in order to construct the recipient address.

The default carriers include:

  • Altel – @message.alltel.com will be appended to each recipient number.
  • AT&T – @txt.att.net will be appended to each recipient number.
  • Boost Mobile – @myboostmobile.com will be appended to each recipient number.
  • Metro PCS – @mymetropcs.com will be appended to each recipient number.
  • Powertel – @ptel.com will be appended to each recipient number.
  • Nextel – @messaging.nextel.com will be appended to each recipient number.
  • Qwest – @qwestmp.com will be appended to each recipient number.
  • Sprint – @messaging.sprintpcs.com will be appended to each recipient number.
  • Sprint PCS – @messaging.sprintpcs.com will be appended to each recipient number.
  • Sun Com – @tms.suncom.com will be appended to each recipient number.
  • T-Mobile – @tmomail.net will be appended to each recipient number.
  • US Cellular – @email.uscc.net will be appended to each recipient number.
  • Verizon Wireless – @vtext.com will be appended to each recipient number.
  • Virgin Mobile – @vmobl.com will be appended to each recipient number.

Recipient(s)

The phone number of the recipient(s). If there are multiple recipients, provide a comma separated list of the phone numbers. The phone number(s) can be dynamically obtained from a field in the event data using ${FIELD-NAME}. There is no default for this property.

Note:
If the recipient(s) phone number is 607-555-7878, specify it as 6075557878. GeoEvent Server will append the value of the carrier domain to the phone number to create a recipient email for the text message.

SMTP Server Host Name

Specifies the SMTP server host name. This is the SMTP server to use for sending email messages. The default is a placeholder string, smtp.HOST-NAME.com.

SMTP Server Port Number

Specifies the SMTP server port number. This is the port that the SMTP server receives on. The default is 25.

SMTP Authentication Mode

Specifies the SMTP server authentication mode. Available authentication modes include Anonymous, SSL, and TLS. The default property is Anonymous.

  • Anonymous - The SMTP server accepts anonymous authentication. Requests issued to the SMTP server by GeoEvent Server will be anonymous. A username and password are not required.
  • SSL - The SMTP server accepts SSL authentication. Requests issued to the SMTP server by GeoEvent Server will be done over SSL. A SMTP authenticated username and password are required for sending the email.
  • TLS - The SMTP server accepts TLS authentication. Requests issued to the SMTP server by GeoEvent Server will be done over TLS. A SMTP authenticated username and password are required for sending the email.

Username

(Conditional)

Specifies the SMTP authenticated user responsible for sending the email. The default for this property is a placeholder string, MyUsername.

Property is shown when SMTP authentication mode is set to SSL or TLS and is hidden when set to Anonymous.

Password

(Conditional)

Specifies the password of the SMTP authenticated user sending the email. There is no default for this property.

Property is shown when SMTP Authentication Mode is set to SSL or TLS and is hidden when set to Anonymous.


In this topic
  1. Usage notes
  2. Parameters