Receive SMS messages

Modified on Fri, 17 Nov 2017 14:40 by Audun Hegranes — Categorized as: Uncategorized

Step 1: Create a keyword you can receive SMS messages on ¶

Go to https://accountweb.pswin.com/ and select "Keywords".

Then select an access number (The number an end user sends a SMS to).

Then press "Add keyword"

You can then select an apropriate keyword, and check if it is availible.

Then set primary protocol to XMLHTTP2, and set your primary destination, where you will receive the SMS message xml.

The keyword request will then be sent to Link Mobility, and processed.

Step 2: Receive the SMS message¶

Example:

<?xml version="1.0"?>
<MSGLST>
  <MSG>
    <ID>1</ID>
    <TEXT>Incoming message 1</TEXT>
    <SND>4512345678</SND>
    <RCV>4512345678</RCV>
  </MSG>
</MSGLST>

You can find details of the xml request here: Incoming SMS XML

Details of the XML request elements can be found here: Gateway XML API

Step 3: Reply with an XML response¶

<?xml version="1.0"?>
<MSGLST>
  <MSG>
    <ID>1</ID>
    <STATUS>OK</STATUS>
  </MSG>
</MSGLST>

Read the XML request, and reply with the message id. If not, then Link Mobility will retry the SMS message up to 10 times.

Step 4: Test¶

When your keyword has been created, you can access the keyword page, and press the little "play" icon next to your keyword. You will then receive a test message to your endpoint.

All done!¶

You are now ready to start receiving SMS messages!