Code examples

Example clients for connecting, sending SMS, receiving callbacks, and keeping the session alive.

Setup and dependencies

Python

pip install smpplib

Java

C# (.NET)

Connect and send SMS

Python

import smpplib
import smpplib.client
import smpplib.consts

client = smpplib.client.Client("smpp.ecall.ch", 2776, allow_unknown_opt_params=True)

client.connect()
client.bind_transceiver(system_id="your_username", password="your_password")

pdu = client.send_message(
    source_addr_ton=smpplib.consts.SMPP_TON_INTL,
    source_addr_npi=smpplib.consts.SMPP_NPI_ISDN,
    source_addr="eCall",
    dest_addr_ton=smpplib.consts.SMPP_TON_INTL,
    dest_addr_npi=smpplib.consts.SMPP_NPI_ISDN,
    destination_addr="0041791234567",
    short_message="Hello from eCall SMPP!".encode("utf-8"),
    registered_delivery=1,
)

print(f"Message ID: {pdu.message_id}")

client.unbind()
client.disconnect()

Java

C# (.NET)

Receive delivery receipts

Python

import smpplib
import smpplib.client

def message_received(pdu):
    if hasattr(pdu, "esm_class") and pdu.esm_class == 0x04:
        print(f"Delivery receipt: {pdu.short_message}")
    else:
        print(f"Inbound SMS from {pdu.source_addr}: {pdu.short_message}")

client = smpplib.client.Client("smpp.ecall.ch", 2776)
client.connect()
client.bind_transceiver(system_id="your_username", password="your_password")

client.set_message_received_handler(message_received)
client.listen()

Java

Keep-alive

Python

import threading
import time

def keep_alive(client, interval=30):
    while True:
        time.sleep(interval)
        try:
            client.enquire_link()
        except Exception:
            break

thread = threading.Thread(target=keep_alive, args=(client,), daemon=True)
thread.start()

Java