Get started
Preparation
To meet the regulatory requirements of authorities in various countries, you may need to complete the following preparations in the console before officially using the Unimatrix SMS service.
Verification
In some countries, telecom carriers require identity verification before allowing SMS to be sent through their SMSC (Short Message Service Center, aka SMS gateway). Unverified individuals, enterprises, or organizations are not supported to submit custom text content for SMS; only OTP (one-time passcode) SMS can be sent.
Add sender
Generally, adding a sender is not required for most countries; however, for those countries where it is necessary, the platform will automatically assign a neutral available sender. If you need to add a custom sender, please go to the console "Messaging - Senders" to add a sender. The considerations are as follows:
- The sender supports naming with the brand name, company name, organization name, website name, application/software name, shop name, trademark name, or their corresponding abbreviations.
- The sender supports using qualifications or public information held by the subject of the current account's account authentication. It also supports authorization from a third-party subject not currently authenticated under account authentication.
Add template
For sending OTP SMS, using the platform's built-in public templates is recommended. For sending alerts, notifications, transactional SMS, marketing, or promotional SMS, you can go to the console "Messaging - Templates" to add a template. Custom SMS template codes are also supported to enhance template identity readability. The considerations are as follows:
- It's recommended to keep the total length of the SMS text within
320
characters to ensure optimal deliverability and user experience. Avoid inserting any special characters, including emojis, as they can disrupt message delivery and incur higher charges. - Variables should be denoted by
{variable_name}
(e.g.,{code}
,{order_no}
), with names consisting of letters, numbers, and underscores, and must be less than 24 characters long. A variable can only appear once in a template and should not be directly combined with short links.
Send messages
Once the above preparations are complete, you can use the Send SMS API to transmit messages. For detailed instructions, visit the API reference.