Creating a Session

To create Live Number Tests, an SMPP connection between our platform and your platform must first be established. Below are the steps for both your platform and ours.

Creating a Session | Steps-On-Your-Platform

Creating a Session | Steps-On-Our-Platform

Steps On Your Platform

Whitelist Our IP Address:

Add the following IP address to your whitelist: 52.29.63.229

Create an SMPP Account:

Set up an SMPP account to enable the connection between our platforms.

Configure Routing:

Ensure that traffic flows securely from our platform to your system and only then to your suppliers. This ensures a controlled testing environment and prevents direct connections to suppliers, which reduces the risk of bypassing quality checks.

Steps On Our Platform

Go to the SMPP & Suppliers page under Integration Settings.

Click on the Create Session button.

Mandatory Inputs for Creating a Session:

Login (system_id): Identifies the SMPP session.
Password: Used for authentication.
Port: Enter the port number of your server (an integer between 0 and 65535).
Host: Specify the URL or IP address (IPv4) of your server.

Mandatory Parameters Set by Default:

Throughput: Default set to 5. This value defines the maximum number of SMS messages that can be submitted per second. The range is from 5 to 50. If this limit is exceeded, messages will be queued in batches.

Note: The actual maximum throughput depends on SMSC latency and whether windowing (parallel submissions) is enabled.

Destination TON/NPI:

Both TON and NPI are set to 1 by default. These parameters define the type and format of the destination phone number.

TON (Type of Number): Can be set to 0, 1, or 5.
NPI (Numbering Plan Indicator): Can be set to 0 or 1.

Optional Parameters:

System Type:

An optional parameter used to identify the type of system connecting to the SMSC. This can be up to 13 characters long.

TLS Enabled (SSL):

If enabled, all communication will be encrypted using TLS. Supported versions are 1.2 and 1.3. Ensure your server supports TLS before enabling it.

Asynchronous Processing Parameters:

In some cases, our SMPP session manager may modify these values to optimize performance.

Window Size:

Defines how many submit_sm requests can be sent before receiving a response from the SMSC. By default, this is set to 1 (synchronous processing), but it can be increased to a maximum of 20 for asynchronous processing.

Window Wait Timeout:

This parameter specifies the amount of time the system will wait for a slot to open in the send window when the window size is full. If no response is received within this time frame, the request will fail.

The default value is 60000 milliseconds (60 seconds), but it can be set to any integer value between 0 and 300000 milliseconds (5 minutes).

Note: The session is enabled by default but can be disabled if needed.

Session Status:

Once the session is created and enabled, you’ll see a dot in the Host column.
If the connection is successful, the dot will turn green.
If the dot stays red for more than a minute, you can find out why by clicking the bug icon in the Action section. This will show the cause of the issue.