Hotel360 Hotel360User Guide

Messaging (SMS)

Introduction

Messaging lets you send SMS messages from Hotel360 to your staff, to your customer contacts, or to a single phone number. Use it for shift reminders, offers and notices. Messages are paid for with prepaid SMS credits from your SMS provider.

Open Office > Messaging. You need the Open Messaging permission and a plan that includes messaging. The page has five tabs: Compose, Contacts, History, Balance & Top Up and Settings. The Quick Message button at the top is always available.

Before You Start

Nothing can be sent until the SMS API key is saved. Until then the tabs show "SMS not configured" and sending gives "Please configure your SMS API key in settings first." See Settings. You also need SMS credits; see Balance and Top Up.

Sending a Message to a Group

Choosing Who Gets the Message

On the Compose tab, under Recipients, choose Send to:

Choice Who receives it
Department Staff in the department you pick under Select Department.
Individual Staff The staff you tick under Select Staff.
All Staff Every staff member with a phone number.
All Customers Everyone in your Contacts list.
Select Customers The contacts you pick under Select Customers.

Staff phone numbers come from the staff records. Staff with no phone number are left out.

Note

"Customers" here means the Contacts tab on this page. It is a separate list from the Customers page used for accounts (see Customers and Accounts). Customers added there are not messaged from here unless they are also in Contacts.

The Preview panel lists everyone who will receive the message, with the last three digits of each phone number hidden, and Total: 12 recipient(s). If it says "Select recipients to preview", you have not chosen anyone yet.

Writing the Message

  1. Type in Message text. It must be at least 3 characters.
  2. To put each person's name in, type {name}. For example "Hey {name}, welcome! Enjoy 20% off this weekend." Each person gets their own name. This is the only placeholder.
  3. Watch the counter under the box: "98 characters · 1 SMS unit(s)". One unit is counted for every 145 characters. Long messages are split and charged for each part.
  4. Click Send Message. It asks "Send this message to all selected recipients?"
  5. You see "Queued 12 message(s) for sending." The messages are sent in the background, so they may take a short while. The text box is cleared.

If you chose nobody, or nobody has a phone number, you see "No recipients with phone numbers found."

Things to know:

  • A number that appears twice is sent to once only.
  • Numbers that cannot be read as a Kenyan number (starting 0, 254 or +) are skipped. The message after sending says how many, for example "Queued 11 message(s) for sending. Skipped 1 with an invalid phone number."
  • Sending the very same text to the same number twice within a minute sends it once (this stops accidental double clicks). After a minute it sends again.
  • If your SMS provider has not registered a custom sender name for you, the system adds your business name at the end of every message, like "Shift starts at 6am ~Lakeview Hotel". This is counted in the cost.
  • Sending the same text to the same number again within an hour is ignored. Change the wording if you need to repeat it.

Warning

You cannot take a message back once it is queued. Check the Preview list and the text before you click Send Message.

Sending a Quick Message

Use this to text one person who is not on any list.

  1. Click Quick Message at the top right.
  2. Enter the Phone Number (between 9 and 14 characters, such as 0712345678) and the Message.
  3. Click Send. You see "Message sent successfully." The window closes.

If the number is not a valid Kenyan number you see "Invalid phone number." If the provider refuses it, you see the provider's reason, or "Failed to send message."

Contacts

The Contacts tab is your list of customer phone numbers for messaging.

  • Search contacts... finds by name or number.
  • Add Contact: enter First Name and Phone Number, then click Save. You see "Contact saved."
  • Import Excel: choose a .xlsx, .xls or .csv file of up to 2 MB with the columns first_name and phone_number, then click Import. You see "Imported 40 contact(s), skipped 2." Rows missing a name or number are skipped.
  • ⋯ > Edit or Delete ("Delete this contact?").

The Source column shows where each contact came from: Manual, Import, or Coop bank (added automatically from bank payments that carry a phone number). The page shows the total number of contacts at the bottom. Phone numbers are shown with the last three digits hidden.

Adding a contact with a number that already exists updates the name of that contact instead of making a duplicate. When you edit a contact and change its number, the same contact is updated; if the new number belongs to another contact you see "Another contact already uses this phone number."

History

The History tab shows the latest 50 messages recorded by the SMS provider: To, Message, Cost and Status. Use the filter to show All Messages, Pooled, Sent, Delivered or Failed. Click Refresh to update.

  • Pooled: received by the provider and waiting to go out.
  • Sent: handed to the phone network.
  • Delivered: reached the phone.
  • Failed: did not go through.

Messages queued from Compose can take a moment to appear.

Balance and Top Up

The Balance & Top Up tab shows:

  • SMS Credits: how many credits you have left. Click Refresh to update.
  • Account Number: use it as the M-Pesa reference if you pay manually.
  • Sender ID: the name messages come from, marked Custom (Registered) or Default.
  • Pricing: KES 1.00 per SMS of 145 characters. Long messages are split and charged per part.

To buy credits:

  1. Click Top Up Now.
  2. Enter the M-Pesa Phone Number and the Amount (KES). The minimum is KES 10.
  3. Click Send STK Push. An M-Pesa prompt goes to that phone.
  4. Enter the M-Pesa PIN. The credits are added.

If the prompt cannot be sent you see "Invalid phone number." or the provider's message.

Settings

The Settings tab holds the SMS Configuration.

  1. Paste your API Key (the bearer token from your OlinSMS account). It must be at least 10 characters.
  2. Click Save. You see "SMS settings saved."

Below it, Sender ID shows the Active Sender ID and whether it is Custom or Default. The sender ID is managed by OlinSMS, not in Hotel360.