Setup guide: client accounts, SMPP credentials and delivery schemes

1. Create an account for a client

1. 1

   In the side menu, click on the “Accounts” section, then on the “Create an account” button

2. 2

   In the Account field, enter the name you have chosen for the client (use English characters, underscores and numbers)

3. 3

   In the Name field, enter the client's name. This field can be used to describe which reports will be generated or for whom

4. 4

   In the Phone field, enter the client's contact number in international format, while this field is for storing the phone - but in the future, notifications may come to this number

5. 5

   In the E-mail field, enter the contact e-mail address - will be used to send notifications related to the account

6. The fields “URL for send API SMS State” and “URL for send RestAPI SMS State” are used if you connect to the client via API or REST API. Links are inserted here, where SMS delivery reports will be sent to the client.

7. 6

   Click on the Save button

8. You will be redirected to the customer account setup page

9. The next configuration step is to create an SMPP account for the client and add an IP

2. Add SMPP credentials and an IP

1. 1

   On the same page, go to the “SMPP config” section and click the Create button in the “SMPP Credentials” block

2. 2

   In the Login field, enter the login for the SMPP client account

3. 3

   In the Password field, enter the password for the SMPP client account

4. 4

   Click on the Save button

5. 5

   Return to the client account settings page, go to the “SMPP config” section and click the Create button in the “SMPP IP” block

6. 6

   Enter the IP and click on the Add button

7. Your client can now bind to the sandbox over SMPP and send traffic

8. For each smpp connection that will connect to this account, you need to make a separate login and password, and of course, add all the IP addresses from which they will connect

9. The last step is a delivery scheme. It defines how many reports (as a percentage) come back as Delivered, Not Delivered, Expired, Pending or Rejected, and after what delay

3. Create a delivery-report scheme

1. 1

   On the client account settings page, in the Routing section, click the Create button. Here you will create a so-called Rule, according to which all client traffic that passes through this account will be distributed

2. 2

   In the Name field, enter a name for the Scheme, which will help you quickly navigate. For example, “90% Delivered, 10% Not Delivered” or “Super Scheme”

3. 3

   In the Delay field, enter the number of seconds to wait before sending the report. That is, how many seconds should elapse between sending SMS and delivering the report

4. 4

   In the “Aggregators” block, you need to select the report statuses that will be valid in the scheme and their percentage. For example, if we want 90% of the reports to be returned with the Delivered status, and 10% of the reports with the Not Delivered status, then we need to select two corresponding aggregators. And opposite each, in the Percentage field, enter a percentage

5. 5

   Click on the Create button

6. Want to understand the receipt statuses first? Read the guide to SMPP delivery receipts.

SMPP delivery receipts explained