Developer Guides
Comprehensive technical knowledge base for understanding, integrating, and operating the SMS Pro Messaging Platform.
Welcome to the SMS Pro Developer Guides. Unlike quickstarts or copy-paste recipes, this section provides the technical knowledge, telecommunication principles, architectural mental models, and production best practices required to build mission-critical, carrier-grade messaging integrations.
Guide Categories
Explore our technical guides organized by engineering domain:
1. SMS Fundamentals & Encoding
Understand GSM-7 vs. UCS-2 Unicode character sets, concatenation segmentation math, and automatic phone normalization.
2. Transactional SMS Architecture
Single and multi-recipient dispatch and traffic classes.
3. Message Lifecycle & Routing
Submission acceptance, later handset delivery, and traffic classes.
4. Bulk Campaigns & High-Volume Queuing
Asynchronous batch processing, streaming recipient list validation, deduplication, and dynamic personalization.
5. Delivery Reports (DLR) Deep Dive
Operator feedback loops, intermediate vs. terminal statuses, handset latency, and correlation strategies.
6. Webhooks & Event Notifications
Event-driven callbacks, HMAC-SHA256 signature verification, exponential retry backoff, and idempotent event processing.
7. OTP & Zero-Knowledge Verification
Cryptographic blind verification proofs, SHA-256 challenge-response handshakes, and WhatsApp-to-SMS failovers.
8. Sender ID Management & Compliance
Request an alphanumeric sender name and follow PENDING, APPROVED, REJECTED, and REVOKED.
9. Automations
Reminders, birthdays, surveys, events, and short links in the console and on the public API.
10. Wallet, Billing & Usage Accounting
Segment-based charging mechanisms, PAYG wallet unit deductions, handling HTTP 402, and low-balance alerts.
11. Error Handling & Diagnostics
RFC 7807 problem details taxonomy, application error codes, request tracing, and debugging duplicate submissions.
12. Architecture, Resiliency & Scale
Rate-limit headers, retries, and calling SMS Pro from your own worker.
How to Use These Guides
- Building a New Integration? Start with SMS Fundamentals and Message Lifecycle & Routing to understand message segmentation and delivery guarantees.
- Handling Inbound Callbacks? Review Delivery Reports (DLR) and Webhooks & Event Notifications.
- Looking for Concrete Code Samples? If you need ready-to-run, split-pane code in Node.js, Python, PHP, or Java, explore our Interactive Recipes.
- Need Endpoint Schemas? Check the interactive OpenAPI playground in the API Reference.