Sending SMS messages to the USA
884 Views
05.08.2022 
Telecom / SMS / Time2Chat
Objective
There are specific rules for sending SMS to the United States. The guide will explain the rules and show you how to apply them, so that you can send SMS messages to the US.
Requirements
- An OVHcloud SMS account with SMS credits.
- Access to the OVHcloud API (for the API method only)
OVHcloud Control Panel Access
- Direct link: SMS
- Navigation path:
Telecom>SMS> Select your SMS account
Instructions
Step 1: understanding the restrictions
In accordance with the US SMS regulation authority (Neustar), a message template must be validated through our services before an SMS can be sent to this destination. Only alert and two-factor authentication messages are authorised, and advertising SMS templates are not accepted. Once you have set your templates, the SMS will be sent the same way as for other countries.
You can request the validation of multiple message templates.
Setting message templates is free and is carried out by the OVHcloud teams within two working days.
Step 2: adding a template
2.1 Via the Control Panel
Log in to your OVHcloud Control Panel, then select Telecom. Next, click SMS and select your SMS account. Click on the Message and campaign tab then click SMS management.
Finally, click Manage templates.
On the next page, click on Actions then on Add.
A pop-up will appear with fields to complete.
| Field | Description |
|---|---|
| Name | Template name |
| Activity | Select the template type: - Alert - Authentication - Transaction processing system |
| Description | Template description |
| Template | Write the template, including the variable between # |
2.2 Via APIs
If you are not familiar with using the OVHcloud API, please refer to our guide on Getting started with the OVHcloud API.
Log in to api.ovh.com/, then use the following API:
Fill in the required fields and click on Execute.
Examples of templates
Below are two examples of message templates that can be sent to the US.
- Authentication template example:
- Alert template example:
Step 3: analysing returns
Once your message template has been created and validated, the outgoing SMS automatically compares your content with your templates. If the comparison is positive, the SMS is sent in the same way as one sent to another recipient.
If you send an SMS to the US without creating and validating a template, the SMS will be rejected and the Premium Tracking Transaction Code (PTT code) 1999 will be sent to you, which corresponds to the “No templates available” error message.
You can view the other possible return codes in this guide.
Go further
Join our community of users.
Sending SMS messages via the OVHcloud Control Panel
2923