> For the complete documentation index, see [llms.txt](https://developer.ecall-messaging.com/llms.txt). Markdown versions of documentation pages are available by appending `.md` to page URLs; this page is available as [Markdown](https://developer.ecall-messaging.com/api-references/smpp/code-examples.md).

# Code examples

### Setup and dependencies

{% tabs %}
{% tab title="Python" %}

```bash
pip install smpplib
```

{% endtab %}

{% tab title="Java" %}

```xml
<dependency>
    <groupId>com.cloudhopper</groupId>
    <artifactId>ch-smpp</artifactId>
    <version>5.0.8</version>
</dependency>
```

{% endtab %}

{% tab title="C# (.NET)" %}

```bash
dotnet add package ArdaXi.SmppSharp
```

{% endtab %}
{% endtabs %}

### Connect and send SMS

{% tabs %}
{% tab title="Python" %}

```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()
```

{% endtab %}

{% tab title="Java" %}

```java
import com.cloudhopper.smpp.*;
import com.cloudhopper.smpp.pdu.*;
import com.cloudhopper.smpp.type.*;

SmppSessionConfiguration config = new SmppSessionConfiguration();
config.setHost("smpp.ecall.ch");
config.setPort(2776);
config.setSystemId("your_username");
config.setPassword("your_password");
config.setType(SmppBindType.TRANSCEIVER);
config.setUseSsl(true);

DefaultSmppClient smppClient = new DefaultSmppClient();
SmppSession session = smppClient.bind(config);

SubmitSm request = new SubmitSm();
request.setSourceAddress(new Address((byte) 0x05, (byte) 0x00, "eCall"));
request.setDestAddress(new Address((byte) 0x01, (byte) 0x01, "0041791234567"));
request.setShortMessage("Hello from eCall SMPP!".getBytes("UTF-8"));
request.setRegisteredDelivery((byte) 0x01);

SubmitSmResp response = session.submit(request, 10000);
System.out.println("Message ID: " + response.getMessageId());

session.unbind(5000);
session.destroy();
```

{% endtab %}

{% tab title="C# (.NET)" %}

```csharp
using JamaaTech.Smpp.Net.Client;
using JamaaTech.Smpp.Net.Lib;

var settings = new SmppConnectionSettings
{
    Host = "smpp.ecall.ch",
    Port = 2776,
    SystemID = "your_username",
    Password = "your_password",
    SystemType = "",
    InterfaceVersion = 0x34,
    UseSsl = true
};

using var client = new SmppClient();
client.Properties = settings;
client.Connect();

var msg = new TextMessage
{
    SourceAddress = "eCall",
    DestinationAddress = "0041791234567",
    Text = "Hello from eCall SMPP!",
    RegisterDeliveryNotification = true
};

client.SendMessage(msg);
client.Disconnect();
```

{% endtab %}
{% endtabs %}

### Receive delivery receipts

{% tabs %}
{% tab title="Python" %}

```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()
```

{% endtab %}

{% tab title="Java" %}

```java
import com.cloudhopper.smpp.*;
import com.cloudhopper.smpp.pdu.*;

public class ECallSmppHandler extends DefaultSmppSessionHandler {

    @Override
    public PduResponse firePduRequestReceived(PduRequest pduRequest) {
        if (pduRequest instanceof DeliverSm) {
            DeliverSm deliver = (DeliverSm) pduRequest;
            byte esmClass = deliver.getEsmClass();

            if (esmClass == 0x04) {
                System.out.println("Delivery receipt: " +
                    new String(deliver.getShortMessage()));
            } else {
                System.out.println("Inbound SMS from " +
                    deliver.getSourceAddress().getAddress() + ": " +
                    new String(deliver.getShortMessage()));
            }
        }
        return pduRequest.createResponse();
    }
}
```

{% endtab %}
{% endtabs %}

### Keep-alive

{% tabs %}
{% tab title="Python" %}

```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()
```

{% endtab %}

{% tab title="Java" %}

```java
config.setRequestExpiryTimeout(30000);
config.setWindowMonitorInterval(15000);
```

{% endtab %}
{% endtabs %}


---

# Agent Instructions
This documentation is published with GitBook. GitBook is the documentation platform designed so that both humans and AI agents can read, navigate, and reason over technical content effectively. Learn more at gitbook.com.

## Querying This Documentation
If you need additional information that is not directly available in this page, you can query the documentation dynamically by asking a question.

Perform an HTTP GET request on the current page URL with the `ask` query parameter:

```
GET https://developer.ecall-messaging.com/api-references/smpp/code-examples.md?ask=<question>
```

The question should be specific, self-contained, and written in natural language.
The response will contain a direct answer to the question and relevant excerpts and sources from the documentation.

Use this mechanism when the answer is not explicitly present in the current page, you need clarification or additional context, or you want to retrieve related documentation sections.