Inbound SMS Guidelines
The Inbound SMS guidelines outline important considerations when receiving SMS on DID numbers. These guidelines explain how delivery works, highlight potential restrictions, and describe the limitations related to A2P messaging, SMS verification, and troubleshooting.
SMS Delivery
DID numbers are optimized to receive SMS within their country of registration. International delivery may be affected by:
Local restrictions — Some countries enforce regulatory or technical limits on inbound international SMS to DIDs.
Outdated routing data — Originating networks may rely on outdated or incomplete routing databases, causing delivery failures.
Note
Delivery behavior may vary depending on the originating network and message type, and international traffic can sometimes experience delays or message loss due to upstream carrier dependencies.
SMS to Email Delivery
If you are using an SMS to Email trunk, inbound SMS messages will be automatically forwarded to the recipient email address you configured.
All forwarded messages are delivered from the address
sms-forwarding@didww.com
.The subject line and email body are generated according to the configuration you set when creating the trunk.
Supported placeholders (e.g.,
{SMS_SRC_ADDR}
,{SMS_DST_ADDR}
,{SMS_TEXT}
) can be used in the trunk setup to customize the email output.
Note
Make sure your email system allows incoming mail from sms-forwarding@didww.com
so that inbound SMS messages are not filtered as spam or rejected.
SMS Verification Notice
Using DID numbers for SMS verification is not recommended. DID numbers are non-exclusive and may be reassigned over time, which can create security and continuity risks for verification workflows.
Note
Some applications and platforms may not deliver one-time codes to DID numbers by policy. They may restrict delivery to mobile (cellular) ranges only, or block numbers identified by number-validation checks.
If you must use SMS verification, ensure you have an alternative verification path and do not rely on a single DID for long-term account recovery.
A2P Messaging
DID numbers are primarily intended for two-way person-to-person communication. In certain countries, Application-to-Person (A2P) traffic to DIDs may be restricted by regulation or commercial policy.
Note
To reduce costs, some originators run number validation before sending messages. These tools can misclassify DID prefixes if their databases are outdated or incomplete.
Originators may also deliver A2P messages with alphanumeric sender IDs, which can behave differently from numeric MSISDNs.
Encoding and Concatenation
Inbound SMS may arrive in different encodings depending on the sender:
GSM-7 — Standard encoding, up to 160 characters.
UCS-2 (Unicode) — Required for non-Latin scripts (e.g., Chinese, Arabic, Cyrillic), up to 70 characters per message.
When a message exceeds these limits, it is delivered as a concatenated message (multi-part SMS). A User Data Header (UDH) is used to split and reassemble long messages. Up to 255 parts may be supported for a single message.
Note
Applications must be able to process UDH headers and reassemble multi-part SMS to correctly display long messages.
Firewall Configuration
To receive inbound SMS correctly, ensure your firewall allows traffic from DIDWW inbound SMS delivery IP addresses. Requests will always originate from DIDWW-defined IPs (see Endpoints), which must be explicitly permitted.
Troubleshooting
If you have delivery issues after reviewing the points above, contact DIDWW Technical Support at support@didww.com and include the SMS details below.
Field |
Description |
---|---|
Date and Time (UTC) |
Exact timestamp when the SMS was sent. |
Originating Number |
The sender’s phone number. |
Destination DID |
The DID number that should receive the SMS. |
Originating Network/Operator |
Name of the operator or platform that submitted the SMS, if known. |
Any Error/Status from Sender Side |
Delivery status, error code, or logs provided by the originating platform. |
SMS Details Example
When opening a trouble ticket to our support team at support@didww.com you may copy the example below and replace the placeholder values with your real SMS details.
Date and Time (UTC): YYYY-MM-DD HH:MM:SS
Originating Number: +<E.164>
Destination DID: +<E.164>
Originating Network/Operator: <Name, if known>
Any Error/Status from Sender Side: <Delivery status, error code, or logs, if available>
Note
More context reduces investigation time. If you performed multiple test attempts, please share multiple samples with different timestamps.