Log in to Duka Maps, select your duka, then open SMS from the Admin Menu. Confirm the duka name before taking action. Each duka has separate SMS settings, credits and records.
Open Send SMS. You need Send SMS and Manage Customers permissions, a saved duka contact number and an active main subscription. Sending pauses when the main subscription expires, including when using your own provider.
Use this page for staff-composed messages. Debt reminders use their defined wording and are sent from Customer Balances. Account-entry notifications are selected on Customer Debts & Credits.
Follow the section for your sending account. The sender ID near the top of the page is the name customers see as the message sender.
Using the DukaMaps Account
This account uses the DukaMaps sender ID and credits purchased through Buy SMS. SMS costs KSh 0.30 per unit and is purchased separately from the main subscription. Purchased credits never expire.
Only service notifications to individual customers are allowed on Send SMS. Staff-composed group messages and marketing messages require an activated own HostPinnacle account and approved sender ID.
Select the Customer and Message Purpose
Find one customer through the shared customer search. Confirm their name and primary phone number. Alternative phone numbers are not included.
Use Service notification for information about the customer’s service, order or account. For example: Your repaired phone is ready for collection. Marketing is not allowed through the DukaMaps account. Do not label a promotion as a service notification to bypass this restriction.
Message Body
Enter only the body in plain text. Duka Maps adds the duka name, greeting and contact footer:
Example Duka
Hi Jane! Your repaired phone is ready for collection.
For Questions, Contact: 0712345678
Do not repeat the header or footer.
Keep the Complete Message Within Three SMS Units
The complete personalised message must fit three SMS units, including the duka name, greeting and contact footer. Watch the live counter as you type; it warns or prevents further input when the limit is exceeded.
Changing the recipient can change the available body space because their first name is included in the greeting. Shorten the body if the new customer’s message exceeds the limit.
Use ordinary text or emojis to ensure that you message is delivered.
Preview and Confirm
Click Preview messages and recipients. Review the customer, phone number, complete message, SMS-unit count and DukaMaps cost. If the customer is excluded, read the reason and correct the issue before trying again.
Use Edit selection to change the customer or wording. A preview expires after 10 minutes, so preview again if asked. Previewing alone does not send anything.
Click Confirm and queue messages after checking the preview. The message enters the queue; its DukaMaps credits are reserved while processing. Sending finalises the deduction. A failed or cancelled message releases its reservation; an Unknown outcome needs administrator verification before retrying.
The queue normally runs every minute during the sending window from 8 am until before 9 pm Kenyan time. A message queued outside that window waits. Larger batches can take several runs; confirmation does not mean every recipient has already been sent a message.
The system rechecks permissions, subscription, provider settings and recipient details before sending. Changes may cancel an affected message instead of sending it using outdated information.
Debt reminders started manually from Customer Balances and selected account-entry/deletion notifications are attempted immediately through their respective workflows. They do not wait for the composed-message queue window.
Common Questions
Why is the Send SMS tab or customer search unavailable?
Ask the owner to check your Send SMS and Manage Customers permissions.
Can I send to alternative customer numbers?
No. Sending uses the primary customer phone number only. Update that number in Duka Customers when necessary.
Will ordinary composed messages include payment instructions?
No. Enter any necessary payment information in the body yourself. The automatic additions are the duka name, greeting and contact footer.
Why has my message not been sent immediately?
Composed messages are queued. Check SMS history for progress, the subscription status and any reason shown. Do not submit the same batch again while it is waiting.
Can I edit a confirmed batch here?
Edit selection is available before confirmation. After confirmation, this page does not offer a batch-edit or cancel control. Check history or contact support if a confirmed message needs attention.
Using Your Own HostPinnacle Account
A DukaMaps administrator must first verify and activate your HostPinnacle SMS account and approved sender ID. The administrator enters the account’s user ID and password. Ordinary staff do not change provider accounts through Settings.
This setup applies across the duka’s customer SMS functions, not just Send SMS. Maintain your SMS balance directly with HostPinnacle. DukaMaps does not deduct its SMS credits for own-account messages.
Existing DukaMaps credits remain if you switch to your own account and can be used if you switch back. Own-account sending does not automatically fall back to DukaMaps credits when the provider balance runs out.
Select Recipients
The Send to field offers:
| Option | Recipients |
|---|---|
| Individual customer | One customer found through the shared search. |
| Customer categories | Customers assigned directly to one or more selected categories. |
| All customers | Customers in this duka, subject to message eligibility. |
| All except selected categories | Customers outside the selected categories, including those without a category. |
Selecting a parent category does not automatically include its subcategories. Select the actual assigned categories you need.
All messages use the primary phone number only. Alternative numbers are not included. Duplicate phone numbers are excluded within a batch so a shared number receives only one message.
Choose the Message Purpose
Choose Service notification for information about a customer’s service, order or account. Choose Marketing for promotions or offers. Marketing includes only customers subscribed to marketing SMS.
Do not label promotional messages as service notifications to bypass customer preferences. Marketing opt-outs do not stop legitimate service notifications.
Message Body
Enter only the body in plain text. Duka Maps adds the duka name, greeting and contact footer:
Example Duka
Hi Jane! Your repaired phone is ready for collection.
For Questions, Contact: 0712345678
Do not repeat the header or footer. Do not add placeholders such as {first_name} or {balance} to a composed body; they remain literal text rather than being replaced.
The system detects the message’s character type automatically. You do not need to choose Text or Unicode.
Keep the Message Body Within Two SMS Units
The staff-composed body must fit two SMS units, for both individual and group messages. The complete message may use more units after the duka name, personalised greeting and contact footer are added. HostPinnacle charges for all units in the complete message.
Watch the live counter while typing. For ordinary basic text, the two-unit body limit is 306 encoding spaces. For Unicode it is 134. Some symbols use more than one encoding space, so rely on the counter rather than a visible-character count.
Ordinary text usually has more space than messages containing emojis, curly quotation marks or other Unicode characters. Some symbols take more than one encoding space. Longer messages use part of each unit to join their parts together. Rely on the live counter and preview rather than counting visible characters yourself.
Debt reminders and account-entry notifications retain their separate three-unit complete-message limit.
Preview the Messages and Recipients
Click Preview messages and recipients. Review the actual recipients, complete message samples and total SMS units. The preview shows No DukaMaps charge; maintain sufficient balance with HostPinnacle for the full messages.
For a group, up to three sample messages are displayed. Recipient and SMS-unit totals include all messages to be sent, not just the samples. Different customer-name lengths can produce different unit counts.
Excluded recipients are listed with reasons, such as an invalid primary number, a duplicate phone number or a marketing opt-out. When customers share a phone number, check that the sample greeting is appropriate.
Use Edit selection to change recipients or wording. A preview expires after 10 minutes, so preview again if asked. Previewing alone does not send anything.
Confirm and Queue
Click Confirm and queue messages only after reviewing the preview. Composed messages enter the queue rather than being delivered immediately. DukaMaps does not reserve or deduct its credits for these messages.
The queue normally runs every minute during the sending window from 8 am until before 9 pm Kenyan time. A message queued outside that window waits. Larger batches can take several runs; confirmation does not mean every recipient has already been sent a message.
The system rechecks permissions, subscription, provider settings and recipient details before sending. Changes may cancel an affected message instead of sending it using outdated information.
Debt reminders started manually from Customer Balances and selected account-entry/deletion notifications are attempted immediately through their respective workflows. They do not wait for the composed-message queue window.
Common Questions
Why is the Send SMS tab or customer search unavailable?
Ask the owner to check your Send SMS and Manage Customers permissions.
Can I send to alternative customer numbers?
No. Sending uses the primary customer phone number only. Update that number in Duka Customers when necessary.
Will ordinary composed messages include payment instructions?
No. Enter any necessary payment information in the body yourself. The automatic additions are the duka name, greeting and contact footer.
Why has my message not been sent immediately?
Composed messages are queued. Check SMS history for progress, the subscription status and any reason shown. Do not submit the same batch again while it is waiting.
Can I edit a confirmed batch here?
Edit selection is available before confirmation. After confirmation, this page does not offer a batch-edit or cancel control. Check history or contact support if a confirmed message needs attention.
Why did fewer customers receive messages than I selected?
Check excluded recipients and SMS history. Invalid numbers, duplicate phones, marketing opt-outs or eligibility changes can reduce the sent total. Some queued messages may still be waiting.
What happens if my own HostPinnacle balance runs out?
Top up your own HostPinnacle account and check the message history before attempting to send again. The system does not automatically use your DukaMaps credits instead.