[Reading time: 2 minutes]
Overview
For SMS sending to work on INO CX, an external SMS provider must be configured at the client account level. This provider handles the delivery of SMS messages to recipients.
This configuration is reserved for administrators.
Prerequisites
- Administrator access to the Maker
- The URL and credentials provided by your external SMS provider
1. Accessing SMS settings
- Open the Maker
- Go to Client account settings
- Select SMS Settings
2. Configuring the SMS provider
2.1. Provider URL
Enter the URL to which INO CX will send SMS data for processing by your provider. The URL must start with https://.
2.2. Authentication
If your provider requires authentication:
- Enable the authentication option
- Enter the login and password
- Click Test connection to validate the credentials before saving
Note: the login field accepts letters, numbers, and the following special characters: _ + . @ -
3. Data format sent to the provider
Each time an SMS is sent, INO CX transmits the following data to the provider in JSON format:
| Field | Description |
|---|---|
type | SMS type: NOTIFICATION (transactional — appointment confirmations, payment notifications, delivery tracking, etc.) or MARKETING (promotional — may require an opt-out clause such as “STOP” for GDPR compliance). If the sender field is not set, the type automatically switches to MARKETING. |
sender | Custom sender name as configured in INO CX |
to | Recipient phone number in international format |
retId | Unique INO CX identifier associated with the send — do not modify |
isUnicode | true if the message contains Unicode characters (accents, emojis, etc.), which reduces capacity from 160 to 70 characters per credit |
text | SMS text content |
credits | Number of SMS credits consumed by this send |
Tip: share this format specification with your SMS provider so they can configure their receiving endpoint accordingly.