Telemessage Integration

Steps to Use Telemessage with PageGate

Send Text and SMS Messages from Telemessage
PageGate can easily be configured to pass messages to Telemessage by using their three internet hosts (SNPP, WCTP and web API) and their dial-in based TAP host. Since PageGate supports all four communication methods, you can configure a tiered failover system that implements all available protocols.

For example, we could configure PageGate to use Telemessage's web API as a primary method of contact. Then, if the web API is down or can't accept messages, we can have PageGate automatically fail over to deliver the message by SNPP. If SNPP fails, it can fail over to WCTP. If WCTP fails, or if the internet or network connection fails, the program can fail over to TAP to deliver the messages by modem and phone line. It's important to note, however, that TAP delivery does require a modem with connected phone line. Also, if you're running PageGate in a virtual environment, it's still entirely possible to use modems and other physical hardware with the appropriate RS-232 or COM port virtualizer, like those made by Digi and DigiKey.

Here's how to configure PageGate to send messages to the Telemessage web API:

1)
In the PageGate Admin, right click Carriers and select 'Add'.

2) Specify the following:
Carrier: TelemessageAPI
Protocol: HTTPPOST
Host: secure.telemessage.com/partners/xmlMessage.jsp
Port: 443
Max Chars: 160

3) Click Apply.

4) Go to Carriers - Telemessage - Template.

5) In this step, we're telling PageGate how to format the XML data to submit to Telemessage's web API.

Copy and paste the following in to the 'Text' section of the Template:
<?xml version="1.0" encoding="UTF-8" ?>

<TELEMESSAGE>
<TELEMESSAGE_CONTENT>
<MESSAGE>
<MESSAGE_INFORMATION>
<SUBJECT></SUBJECT>
</MESSAGE_INFORMATION>
<USER_FROM>
<CIML>
<NAML>
<LOGIN_DETAILS>
<USER_NAME>enter user name here</USER_NAME>
<PASSWORD>enter your password here</PASSWORD>
</LOGIN_DETAILS>

</CIML>
</NAML>
</USER_FROM>
<MESSAGE_CONTENT>
<TEXT_MESSAGE>
<MESSAGE_INDEX>0</MESSAGE_INDEX>
<TEXT>%Message%</TEXT>
</TEXT_MESSAGE>
</MESSAGE_CONTENT>
<USER_TO>
<CIML>
<DEVICE_INFORMATION>
<DEVICE_TYPE DEVICE_TYPE="SMS"/>

<DEVICE_VALUE>%RecipientId%</DEVICE_VALUE>
</DEVICE_INFORMATION>

</CIML>
</USER_TO>
</MESSAGE>
</TELEMESSAGE_CONTENT>
<VERSION>1.6</VERSION>
</TELEMESSAGE>

6)
Click Apply.

--------------

Here's how to configure PageGate to send messages to the Telemessage SNPP host:

1) In PG Admin, right click Carriers and select 'Add'.

2) Specify the following:

Carrier: TelemessageSNPP
Protocol: SNPP
Host: csnpp.telemessage.com
Port: 444
Max Chars: 500

3) Click Apply.

4) Go to Carriers - TelemessageSNPP - Advanced.

5) Enter your Telemessage Username and Password in the appropriate fields.

6) Click Apply.

--------------

Here's how to configure PageGate to send messages to the Telemessage WCTP host:

1) In PG Admin, right click Carriers and select 'Add'.

2) Specify the following:

Carrier: TelemessageWCTP
Protocol: WCTP
Host: wctp.TeleMessage.com/servlet/wctp
Port: 444
Max Chars: 500

3) Click Apply.

4) Go to Carriers - TelemessageWCTP - Advanced.

5) Enter your Telemessage Username and Password in the appropriate fields.

6) Click Apply.

--------------

Here's how to configure PageGate to send messages to the Telemessage TAP host:

1) In PG Admin, right click Carriers and select 'Add'.

2) Specify the following:

Carrier: TelemessagTAP
Protocol: TAP
Phone Number: Please contact Telemessage.
Baud Rate: 1200
Parity: Even
Data Bits: 7
Stop Bits: 1
Init String: (auto)
Max Chars: 240

3) Click Apply.

--------------

Here's how to configure a failover in PageGate:

1) In the PageGate Admin, go to Carriers - TelemessageAPI - Advanced.

2) In the Failover field, select: TelemessageSNPP

3) Click Apply.

4) Go to Carriers - TelemessageSNPP - Advanced.

5) In the Failover field, select: TelemessageWCTP

6) Click Apply.

7) Go to Carriers - TelemessageWCTP - Advanced.

8) In the Failover field, select: TelemessageTAP

9) Click Apply.

NotePage, Inc.
PO Box 296
Hanover, MA 02339