User Guide

Registration

Go to Portal

Navigate to https://selfhost.smpp.asia/portal.html

Click Register

Fill in your name, email, phone (optional), and password.

Start Free Trial

You get 3 days free trial with full access to all features.

Free Trial: 3 days with 500 SMS/day, 15,000 SMS/month, 2 gateway devices (4 SIMs).

Dashboard Overview

Stats Cards

Metric	Description
Today's SMS	SMS sent today / daily limit
This Month	SMS sent this month / monthly limit
Gateways	Registered devices / max allowed
Online	Currently connected gateway devices

Dashboard Tabs

Send SMS - Quick SMS sending form
Credentials - API key and SMPP credentials
Gateways - Manage Android gateway devices
History - View sent SMS history

Gateway Setup

Download App

Download MSG95 Gateway APK from the Gateways tab or click here.

Install on Android

Enable "Install from unknown sources" and install the APK.

Grant Permissions

Allow SMS, Phone, and Notification permissions.

Copy Token

Go to Gateways tab in dashboard and copy your Connection Token.

Connect

Paste token in the app and tap Connect. Status should show "Online".

Important: Disable battery optimization for the app to keep it running in background.

Sending SMS

From Dashboard

Go to "Send SMS" tab, enter phone number and message, click Send.

Via API

                    curl -X POST "https://selfhost.smpp.asia/api/sms/send" \
  -H "Authorization: Bearer YOUR_API_KEY" \
  -H "Content-Type: application/json" \
  -d '{"phone":"09xxxxxxxxx","message":"Hello World"}'
                

API Integration

Getting Your API Key

Go to Credentials tab in dashboard. Your API key is displayed there.

API Base URL

https://selfhost.smpp.asia/api

Endpoint	Method	Description
/api/sms/send	POST	Send SMS message
/api/sms/history	GET	Get SMS history
/api/otp/request	POST	Send OTP
/api/otp/verify	POST	Verify OTP
/api/client/profile	GET	Get profile & usage
/api/gateways	GET	List gateways

See full API documentation at api-docs.html

SMPP Connection

SMPP Credentials

Find your SMPP credentials in the Credentials tab.

Setting	Value
Host	selfhost.smpp.asia
Port	2558
System ID	Your unique system_id
Password	Your SMPP password

Python SMPP Example

                    import smpplib

client = smpplib.client.Client('selfhost.smpp.asia', 2558)
client.connect()
client.bind_transmitter(system_id='YOUR_SYSTEM_ID', password='YOUR_PASSWORD')
client.send_message(
    source_addr='YourApp',
    destination_addr='09xxxxxxxxx',
    short_message='Hello via SMPP!'
)
client.unbind()
client.disconnect()
                

OTP Verification

Send OTP

                    curl -X POST "https://selfhost.smpp.asia/api/otp/request" \
  -d "accessToken=YOUR_API_KEY" \
  -d "to=09xxxxxxxxx" \
  -d "brand=YourApp"
                

Response includes requestId for verification.

Verify OTP

                    curl -X POST "https://selfhost.smpp.asia/api/otp/verify" \
  -d "accessToken=YOUR_API_KEY" \
  -d "requestId=12345" \
  -d "code=384756"
                

Usage Limits

Package	Daily Limit	Monthly Limit	Max Devices	Price (MMK)
Starter Pro	500	15,000	2 (4 SIMs)	100,000
Business Elite	1,000	30,000	4 (8 SIMs)	200,000
Enterprise Pro	2,000	60,000	8 (16 SIMs)	350,000
Enterprise Max	4,000	120,000	16 (32 SIMs)	600,000
Ultimate	10,000	300,000	32 (64 SIMs)	1,000,000

When you reach daily/monthly limit, SMS sending will be blocked until the limit resets.

Table of Contents