SMPP API

This guide provides all the information you need to integrate SMPP into your applications for sending and receiving SMS messages efficiently and reliably.

What is SMPP?

SMPP (Short Message Peer-to-Peer) is an industry-standard protocol used to exchange SMS messages between short message service centers (SMSC) and external messaging entities. Unecast's SMPP API allows for high-throughput, low-latency SMS messaging, making it ideal for large-scale and time-sensitive communications.

Unecast supports the latest SMPP version (version 5.0 - an advanced version of the protocol) for sending and receiving SMS messages between short message service centers (SMSC) and external short messaging entities (ESME).

Here are some key features and enhancements in SMPP 5.0 compared to previous versions:

1. Enhanced Security: Introduction of additional security features such as support for TLS/SSL for secure message transmission.

2. Advanced Message Routing: Improved routing capabilities allowing more sophisticated handling of messages based on criteria like origin, destination, or message content.

3. Extended Message Format Support: Support for a wider range of message formats, including Unicode and binary messages, enabling the transmission of various content types.

4. Enhanced Reporting and Delivery Receipts: More detailed delivery reports and status information, allowing for better tracking and management of message delivery.

5. Support for Multiparty Messaging: Introduction of features supporting group messaging and multiparty communication scenarios.

6. Improved Error Handling: More comprehensive error codes and descriptions to facilitate troubleshooting and error resolution.

7. Improved Network Interoperability: Better interoperability with various network types and configurations, ensuring seamless communication across different network infrastructures.

8. Enhanced Traffic Management: Advanced traffic management features to handle large volumes of messages efficiently and prevent congestion.

These enhancements make SMPP 5.0 a robust and versatile protocol for SMS communication, suitable for a wide range of applications from simple messaging services to complex enterprise solutions.

SMPP Best Practices

When using SMPP (Short Message Peer-to-Peer) for SMS messaging, adhering to best practices is essential to ensure communication is reliable, secure, and efficient. Below are some recommended best practices:

1. Security

   1. Use Secure Connections: Employ TLS/SSL to encrypt the communication between the ESME and SMSC, protecting against eavesdropping and man-in-the-middle attacks.

   2. Authentication and Authorization: Implement strong authentication mechanisms and ensure that only authorized entities can connect to the SMSC.

   3. Regular Security Audits: Conduct regular security audits and vulnerability assessments to identify and mitigate potential security threats.

2. Reliability

   1. Error Handling and Retries: Implement robust error handling and retry mechanisms to ensure messages are not lost in case of temporary failures.

   2. Delivery Receipts: Utilize delivery receipts to confirm message delivery and track the status of each message.

   3. Message Throttling: Implement message throttling to avoid overloading the SMSC and to comply with any rate limits set by the service provider.

3. Performance

   1. Efficient Encoding: Use efficient message encoding formats (e.g., GSM 7-bit) to maximize the number of characters per message and reduce costs.

   2. Optimize PDU Size: Optimize the size of Protocol Data Units (PDUs) to minimize fragmentation and ensure efficient transmission.

4. Network and Traffic Management

   1. Plan for Scalability: Design the system to handle increasing volumes of traffic and support future growth without significant rework.

   2. Load Balancing: Employ load balancing to distribute traffic evenly across multiple connections and prevent any single point of failure.

   3. Monitoring and Alerts: Implement real-time monitoring and alerting systems to detect and address issues promptly.

5. Compliance

   1. Adhere to Regulations: Ensure compliance with relevant regulations and industry standards, such as GDPR for data protection and privacy.

   2. Opt-in and Opt-out Management: Implement mechanisms for managing user opt-ins and opt-outs to comply with legal requirements and respect user preferences.

6. Maintenance and Updates

   1. Regular Software Updates:

      • Keep the SMPP software and associated systems up to date with the latest patches and updates to protect against vulnerabilities.

   2. Documentation and Training:

      • Maintain comprehensive documentation and provide regular training for staff to ensure they are knowledgeable about SMPP and best practices.

By following these best practices, you can ensure that your SMPP implementation is secure, reliable, efficient, and compliant with relevant standards and regulations.

---

Getting Started with Unecast SMPP API

Prerequisits

• Host: smpp://smsc.unecast.com

• Port: 2775

• System ID: Provided upon SMPP APP Creation

• Password: Provided upon SMPP APP Creation

• System Type: VMA (or as specified by Unecast)

Useful Resources

• Documentation of SMPP Error Codes - https://smpp.org/smpp-error-codes.html

• Documentation on SMPP Version 5.0 - https://smpp.org/SMPP_v5.pdf

---

Community and Support

Join our community forums to connect with other developers, ask questions, and share your experiences. Our support team is also available to help you with any technical issues or inquiries.

---

Technical Support

For service requests, questions, or clarifications, please visit the Unecast Support Center. Our engineers and technical consultants will assist you in resolving your concerns free of charge.