SMTP Gateway Configuration

Description

This feature allows emails to be sent to third party providers (example: Zappier; ASPSMS.com) which process the information in the email received and convert it to an SMS to send to the recipient.

How to configure

1. Access Veridium Manager webpage

2. Go to “Settings” → “Messaging” → “SMS” → “Smtp Gateway”
   

   

3. Under this menu, the following parameters need to be configured:

   1. Password – The password used for connecting to the third party SMS provider.

   2. Email Address – The Email Address from which the third party SMS provider will receive the email.

   3. Api Id – API ID can be configured if the third party SMS provider requires it.

   4. Username – The username used for connecting to the third party SMS provider.

   5. Body As Html – The Body as HTML flag, is used to specify if the body of the email/SMS will be send as HTML or plain text. This is useful in case of smtp gateways like ASPSMS, gateway that accept only plain text as body.

   6. Default Encoding – The Default Encoding is used to force the encoding of the message content. In case of ASPSMS, special characters must be encoded with a specific encoding type. By default, the value for encoding is UTF-8.
      

      

4. After configuring the required information, navigate to: “Settings” → “Messaging” → “SMS” → “SMS templates”

5. All of the templates must be configured to align to the third party SMS provider requirements for Subject, Body, Receiver and Sender information.

Testing using aspsms.com

Ensure that the account used for testing has sufficient ASPSMS Credits.

1. Login to aspsms.com

2. Navigate to API Credentials.

3. Save the “Userkey” and “API Password” codes.

4. Access Veridium Manager webpage

5. Go to “Settings” → “Messaging” → “SMS” → “Smtp Gateway”

6. Fill in the information as described above.

7. Click on “Send Test SMS”. A window will appear containing fields for “Email Sender”, “Email Receiver”, “Email Subject” and “Email Body”.

8. Fill in the fields with the required information relevant to aspsms.com client and click “Send”.

   1. Email Sender – the email address used for the aspsms.com account.

   2. Email Receiver – the email address for aspsms.com client (textsms@smtp.aspsms.com).

   3. Email Subject – is composed of a string of parameters delimited by a comma:

      1. UserKey=${smsSmtpConfig.apiId} – the sender’s API Password.

      2. Password=${smsSmtpConfig.password} – the aspsms.com account password.

      3. Recipient=${phoneNumber} – recipient’s phone number in international format, replacing the “+“ character with a zero.

   4. Email Body – the content of the SMS message.

Email Subject example: UserKey=${smsSmtpConfig.apiId},Password=${smsSmtpConfig.password},Recipient=${phoneNumber}

The parameters configured previously can be accessed by using the “Property Name” variables on the right side of the page.