SMS setup and settings
Before you can send SMS campaigns and automations, you connect a sending account. Contlo offers one path for North America and the rest of the world, where you get a dedicated number, and one for India, where you connect your own vendor account, sender headers and approved templates. This article covers both, plus the settings you manage afterwards.
Les guides sont en anglais.
Choose how you send
Open the App Market, find SMS and start the setup. The first screen, Choose your account vendor, groups the options by region.
| Group on screen | Vendor | What you need |
|---|---|---|
| Recommended for North America, Canada and rest of the world | Twilio | Nothing. Contlo assigns a new number to your account. You write your own message text. |
| Recommended for India | TrustSignal | The API key from your TrustSignal account. |
| Recommended for India | Karix | Your API key, your SMS header and the account type. |
| Recommended for India | Gupshup | Your user ID, password and the account type. |
Select a vendor card and click Proceed. The next screen is Account Authorization.
Set up with a dedicated number
Use this path if you send to customers in North America or anywhere outside India.
- Choose Twilio and click Proceed.
- Read the notice. When you continue, a new number is assigned to your account. It is unique to your account and is used to send and receive text messages with your customers.
- Tick I Understand and agree to the Terms and Conditions.
- Click Proceed. Contlo assigns the number and takes you to Billing, where you can add SMS credits.
If you see "Error while assigning Twilio number", try again in a few minutes. If it keeps failing, write to hello@contlo.com. For credits and charges, see Billing and plans.
Set up for India
In India, SMS is sent through your own vendor account using your registered sender headers and DLT-approved templates. Have your vendor credentials ready.
| Vendor | Fields on Account Authorization |
|---|---|
| TrustSignal | API Key. Copy it from the SMS API section of your TrustSignal dashboard. |
| Karix | API Key, SMS Header, Account Type. |
| Gupshup | User ID, Password, Account Type. |
Account Type is Transactional or Promotional. Select transactional for alphabetic headers and promotional for numeric headers.
- Choose your vendor and click Proceed.
- Fill in every field and click Verify.
- TrustSignal only: after the key is verified, a Callback URL appears. Copy it and paste it in your TrustSignal dashboard. This is how delivery and click data comes back to Contlo for your reports.
- TrustSignal only: follow the DLT whitelisting step shown below the callback URL (see Whitelist tracked links on DLT), then click Yes, proceed further.
- You land on the SMS settings page with your account under Connected accounts.
| Message | What to do |
|---|---|
| Please fill all the details! | A required field is empty. Complete every field for your vendor. |
| The credentials given are invalid! Please provide valid credentials and try again. | The API key was rejected. Copy it again from your vendor dashboard, without extra spaces. |
Manage connected accounts and sender IDs
For India vendors, the SMS page has two tabs: Templates and Settings. The Settings tab lists your Connected accounts.
| Column | Meaning |
|---|---|
| Vendor | The vendor the account belongs to. |
| Sender Id | The header or user ID that messages are sent from. |
| Account Type | Transactional or promotional. |
| Actions | Sync Templates, plus a menu with Callback URL (TrustSignal accounts) and Remove Account. |
Click Add Account to add a new vendor, or to add another header for a vendor you already use. Each header is listed as its own account.
Remove an account
Choose Remove Account from the row menu and confirm with Remove. This removes all the user IDs associated with that vendor and all the templates synced from the account.
If you use a dedicated number instead, the SMS page shows My Twilio Number and your consent keywords. To stop using it, open the menu at the top right and choose Remove Vendor. The same automation rule applies.
SMS templates
With an India vendor, you send from the templates registered on your vendor account. Contlo needs a copy of them before you can pick one in a campaign or automation.
- Open the Settings tab and find the account under Connected accounts.
- Click Sync Templates.
- TrustSignal accounts: Contlo fetches your templates directly from the vendor.
- Karix and Gupshup accounts: the Import Templates dialog opens. Click Import and upload a CSV file with your SMS templates.
- Open the Templates tab to check the result.
The Templates tab lists each template's Template Name and Message Body, ten per page. "No templates synced yet" means no sync or import has completed. Sync again whenever you get new templates approved, so they show up in Contlo.
If you see "Unable to sync templates", check that the API key on the account is still valid at your vendor, then try again. To use templates in a send, see SMS campaigns.
Whitelist tracked links on DLT
Contlo replaces links in your SMS with a short tracking link so it can count clicks. Indian operators block SMS links that aren't whitelisted on DLT, so the tracking domain has to be approved on your DLT account for each sender header you use.
The step appears during TrustSignal setup and on the Settings tab of the SMS page. It names the exact domain to whitelist and has a Copy domain button.
- Click Copy domain in the whitelisting step.
- Sign in to your DLT portal and open the URL (CTA) whitelisting section.
- Add the copied domain and link it to your sender header. If you send from several headers, link it to each one.
- Wait for approval. It can take up to a day.
- Send yourself a test SMS with a link and open it to confirm clicks are counted.
| What the step shows | Meaning |
|---|---|
| Grey circle | No result yet. Complete the whitelisting if you haven't. |
| Red alert with "Your operator rejected this link on" and a date | A message with a tracked link was rejected. The domain is not whitelisted for the header that sent it. |
| Green check with "Tracked links are being delivered again" | Messages with tracked links are going through. Nothing more to do. |
Consent keywords
When you send from a dedicated number, customers can reply with keywords to confirm or withdraw their consent. Consent Keywords shows what happens for each keyword and lets you edit the automatic replies. Find it on the SMS page, or under Settings → Channels → SMS.
| Trigger | Action | Message |
|---|---|---|
| After signing up to receive SMS | Profile must confirm consent | Editable. By default it asks the customer to reply YES to receive updates and says they can reply STOP to opt out. |
| YES or Y | Profile is subscribed | Editable. By default it thanks the customer for signing up and repeats how to opt out. |
| STOP, STOPALL, UNSUBSCRIBE, CANCEL, END, QUIT | Profile is unsubscribed | Not editable. |
Edit a message in its text box. It saves when you click out of the box, and you see "Settings saved successfully".
SMS in Channel settings
Settings → Channels lists every channel installed on your account as a card. Click SMS to open its settings without leaving Settings.
- With a dedicated number, you see your number and Consent Keywords.
- With an India vendor, you see SMS Templates: an Accounts table with Sync Templates for each account, and the Templates list.
If the Channels page says "No channels installed", click Open App Store and install the channel you need. To stop sending SMS altogether, remove your vendor or accounts as described in Manage connected accounts and sender IDs.
Other channels have their own pages: see Sender domains for email, Push settings for web and mobile push, and WhatsApp setup for WhatsApp.
Guides associés
- SMS campaignsWrite or pick an SMS, personalize it, add tracked links, an opt-out line and a discount, send a test and launch.
- Billing and plansCheck your Contlo plan, contacts and credits, change plan, top up SMS credits, pay a failed payment and understand the contact-limit prompts.
- Automations overviewWhat automations do, how to create one from a template or from scratch, and how to manage and measure them on the Automations page.
- App MarketBrowse, install, set up and uninstall apps in Contlo: channels, analytics, ad audiences and the third-party tools your store already uses.