SMPP Connection

Guidance for configuring, securing, and tuning your persistent SMPP connection to Sendexa.

Connection Parameters

Typical settings for your SMPP client (ESME).

Parameter	Value	Description
Host / IP	`smpp.sendexa.co`	The primary endpoint for SMPP connections.
Port (TLS)	`2776`	Encrypted connection (recommended).
System ID	Your Client ID	Assigned in the Sendexa dashboard.
Password	Your Client Secret	Use the secret from the dashboard; rotate regularly.
Enquire Link Interval	`30s`	Keepalive heartbeat to avoid idle disconnections.
Window Size	`10–50`	Number of outstanding unacknowledged messages for throughput.

Example TLS Client (Node)

Connect and bind using a popular SMPP client.

JavaScript

// Example using node-smpp
const smpp = require('smpp');

const session = new smpp.Session({host: 'smpp.sendexa.co', port: 2776, tls: true});

session.on('connect', () => {
  session.bind_transceiver({
    system_id: process.env.SMPP_SYSTEM_ID,
    password: process.env.SMPP_PASSWORD,
    system_type: 'sendexa'
  }, (pdu) => {
    if (pdu.command_status === 0) console.log('Bind successful');
    else console.error('Bind failed', pdu);
  });
});

session.on('close', () => console.log('Connection closed'));
session.on('error', (err) => console.error('SMPP error', err));

Connection Best Practices

Use TLS

Prefer the TLS port for all production traffic. Validate certificates and avoid sending credentials in plaintext.

Monitor Heartbeats

Send enquire_link regularly and react to missing replies by attempting a graceful rebind.