International message
This guide covers sending text messages to overseas numbers.
The send flow is the same as for domestic text messages, but the number format and the billing rules differ.
Number format
You must enter the recipient number in E.164 format, including the country code.
| Country | Country code | Example input |
|---|---|---|
| United States | 1 | +12025551234 |
| Japan | 81 | +819012345678 |
| United Kingdom | 44 | +447911123456 |
| Singapore | 65 | +6591234567 |
If you omit the country code or the format is wrong, the send fails.
Billing rules
For international SMS, the character limit depends on the message encoding. If you exceed it, the message is split and billed per part.
| Encoding | Base length | Segment size when exceeded | Maximum parts |
|---|---|---|---|
| GSM-7 (mostly letters and digits) | 160 characters | 153-character segments | 5 parts |
| Unicode (Korean and similar) | 70 characters | 67-character segments | 5 parts |
For example: 200 characters of English is billed as 2 parts, and 80 Korean characters is billed as 2 parts.
Operational cautions
Check these before you send international messages
- Each country allows sender IDs differently. Check the regulations of the destination country before you send.
- Automatic failover is difficult here, so you should build a separate retry policy.
- Some countries impose additional regulations on marketing messages.
Check the send structure before you integrate
Once you understand the destinations and messageFlow structure, you can handle it the same way no matter which integration method you use.
Check the destinations, messageFlow, and failover structure on a single page.
How will you integrate?
Now that you understand the structure, choose your integration method below.