Search the wiki¶

»

API Documentation¶

• Gateway XML API
  • Getting started
• Gateway HTTP API
• Gateway SMTP API
• Gateway Polling API
• Gateway SOAP API
• Link Engage integrations
  

Mobile Payment¶

• CPA SMS
• CPA GAS
  

Sub-numbering/SMS dialogues

Certain access numbers can be extended with subnumbers. Subnumbers are extra digits added to the end of the original access number.
Typical usage of subnumbers is to create dialogue-based SMS applications, where the handset user does not need to use a specific SMS keyword when replying to a message.

Table of Contents [Hide/Show]    Example:    Example screenshot from handset    Implementation guide:       Prerequisites       1. Configure MO SMS forwarding for Subnumber       2. SMS message to handset       3. Receive reply MO request from PSWinCom Gateway       4. SMS confirmation to handset    Source code examples

Example:¶

Accessnumber 26199 in Norway can be extended with 9 digits, such as 26199123456789.
PSWinCom Gateway can allocate a range of this subnumbered accessnumber to your account, for example 26199123456000 – 26199123456999.

When you send SMS, you can set the SenderNumber to a new unique subnumber for each SMS you send. When the receiver replies to the SMS on his phone, you will receive an incoming SMS where the ReceiverNumber is the unique subnumber you assigned that particular message.

Example screenshot from handset¶

Download image with sample dialog between Salesperson and Handset, via subnumber

Implementation guide:¶

Prerequisites¶

To follow this guide, you will need an account on the PSWinCom Gateway, this can be ordered from www.pswin.com.
Also, either a single subnumber combination, or a range of these must have been assigned to your account.
For help on this, please contact PSWinCom Support.

1. Configure MO SMS forwarding for Subnumber¶

You will need to implement a MO/DR endpoint by following API documentation for the PSWinCom Gateway.
Then, you can login to the PSWinCom Accountweb, and configure MO Request forwarding on this url: Accountweb - Subnumbers

2. SMS message to handset¶

Make sure that you set the SND(Sender ID) field to a valid subnumber combination.

3. Receive reply MO request from PSWinCom Gateway¶

When a handset user responds to the SMS message that was sent, the PSWinCom Gateway will forward a MO Receive Request to the URL that was configured in step 1.

4. SMS confirmation to handset¶

We recommend sending a confirmation SMS to the handset that the reply SMS was received and handled correctly by your system.

Source code examples¶

At the moment, we do not have any full source code examples for the subnumber SMS dialog scenario,
but comprehensive source code examples for sending and receiving SMS messages for several development environments can be found on the PSWinCom Github page.