Sending text messages

This page is for owners and administrators who want NaliSuite to send real text messages. It explains how to pick and connect an SMS provider, test it, check your credit, get delivery reports back, and everything in NaliSuite that texts people through that provider.

You will find the settings under Settings → Preferences → Marketing.

Note: The SMS provider comes with the Marketing app, so the Marketing tab shows while Marketing is switched on. Anyone who can see the settings can open the tab; choosing a provider, saving, Send a test message and Check balance need the Manage settings permission (core.settings.manage: the owner and admin roles by default).

Choose your SMS provider

  1. Open Settings → Preferences and click the Marketing tab (marker 1).
  2. Choose the SMS provider (marker 2). The line under it says where the provider works best and where to find your keys.
  3. Fill in the Sender ID (marker 3) and the provider's own fields: for Africa's Talking, the Username (marker 4) and API key (marker 5).
  4. Click Save preferences.
The Marketing tab with the SMS provider, Sender ID, Username and API key marked
The Marketing tab with the SMS provider, Sender ID, Username and API key marked

The providers in the list (marker 1):

The SMS provider list open, showing None, Africa's Talking, Twilio, Vonage, Infobip and Sinch
The SMS provider list open, showing None, Africa's Talking, Twilio, Vonage, Infobip and Sinch
Provider Best for Fields
None (log only) Trying NaliSuite out None. Texts are written to the log and never sent. This is where every workspace starts.
Africa's Talking (recommended for Africa) Kenya, Uganda, Tanzania, Rwanda, Nigeria, Malawi, Zambia, Ethiopia and more: the best coverage and prices in Africa Username (type sandbox to use the Africa's Talking sandbox while testing) and API key.
Twilio Worldwide Account SID (starts AC), Auth token and an optional Messaging Service SID (starts MG). With a Messaging Service, Twilio picks the sending number; without one, put your Twilio number in Sender ID or from number. Both are on the Twilio console.
Vonage Worldwide API key and API secret from the Vonage dashboard. Sender ID or from number is required: a registered sender ID or a Vonage number.
Infobip Worldwide Base URL (like xxxxx.api.infobip.com) and API key, both on the Infobip portal home page.
Sinch Worldwide Service plan ID and API token under SMS → APIs on the Sinch dashboard, and the Region of your account: US, EU, AU, BR or CA.

Choosing another provider shows its own fields straight away (Twilio here: marker 1 is the from number, marker 2 the account SID, marker 3 the optional Messaging Service).

The Marketing tab with Twilio chosen, showing the from number, Account SID, Messaging Service SID and the delivery reports line
The Marketing tab with Twilio chosen, showing the from number, Account SID, Messaging Service SID and the delivery reports line

Secrets such as API keys and tokens are stored encrypted. If you have more than one company, pick the company at the top of Preferences first: each company can use its own provider, and companies without one use the workspace's.

The sender ID

The Sender ID is the name or number people see as the sender, for example ACMETRADERS, up to 20 characters.

Phone numbers people type locally, such as 0712 345 678, are turned into the international form using your company's country, so a Kenyan company sends to 254712345678.

Send a test message and check your balance

Both buttons sit under the provider's fields (marker 3 and marker 4) and use the details on the screen, so you can try them before you save.

The Marketing tab with the company, the delivery reports address, Send a test message and Check balance marked
The Marketing tab with the company, the delivery reports address, Send a test message and Check balance marked
  1. Click Send a test message.
  2. Check the Mobile number (marker 1); it starts with your own phone number from your profile.
  3. Change the Message (marker 2) if you like, up to 160 characters, and click Send (marker 3).
The Send a test message window with the mobile number, the message and Send marked
The Send a test message window with the mobile number, the message and Send marked

"Test message sent to …" with the provider's message ID means the provider took it. If it fails, the message says what the provider answered, for example a wrong key. "Fill in all the provider's details first." means a field is still empty.

Check balance shows the credit left on your account, for example "Africa's Talking balance: KES 1,250.00". Africa's Talking, Twilio, Vonage and Infobip report a balance; Sinch does not, so check it on the Sinch dashboard.

Delivery reports

A delivery report is the provider telling NaliSuite whether each text reached the phone.

The address ends in a private code for your company, so only paste it into the provider's dashboard. Reports from anyone else are refused, and Twilio's reports must also carry Twilio's signature. Once a text is marked delivered or failed, a late or repeated report cannot change it back.

See how many texts arrived

On Marketing → Campaigns, the Delivered column (marker 1) counts how many texts of each SMS campaign reached the phone (marker 2). It shows a dash for email campaigns and for SMS campaigns not yet sent, and rises as reports come in.

The campaigns list with the Delivered column and a sent SMS campaign marked
The campaigns list with the Delivered column and a sent SMS campaign marked

Open the campaign to see the totals under its name: "Sent 248 of 248 · delivered 236 · failed 3" (marker 1). Failed counts texts the provider refused when they were sent.

An SMS campaign with sent, delivered and failed counts under its name
An SMS campaign with sent, delivered and failed counts under its name

Drip sequence texts are tracked the same way.

What your SMS provider sends

Every text NaliSuite sends goes through the provider you chose here:

Good to know