Message templates

Twenty-eight messages, one per event, all editable. They arrive already written and already enabled, so the addon starts messaging clients as soon as it can send — go through them before you point it at a live API key.

Two tabs

They save separately. Save All Templates on the Client tab writes the twenty client templates and nothing else; the Admin tab is its own save. There is a save button at the top and at the bottom of the list — they do the same thing, so you do not have to scroll back after editing the first one.

What each template gives you

• Message — the text that gets sent. Maximum 240 characters, enforced as you type.
• Variables — listed under the box. These are the only ones this template can use.
• Enable — untick and this event never sends. Everything you have written is kept.
• Days Before — only on the domain renewal reminder. See below.
• Admin Phone Numbers — only on the Admin tab. See below.

Variables

A variable is written in braces and is replaced with the real value when the message is sent: Hi {firstname}, invoice {invoiceid} is due {duedate}.

The list under each box is fixed. You can drop variables you do not want and reorder the ones you keep, but you cannot introduce one that is not listed — an unlisted {something} is not recognised and goes out to the client as those literal characters. If you need a value that is not offered, it is not available to that template.

Dates and money

{duedate} and {expirydate} are written using the Date Format from the Settings tab. {total} is the invoice total as WHMCS stores it.

The 240-character limit

The message box stops you at 240 characters. If a longer value gets in anyway — pasted past the limit, or an old template — the save is refused outright with the template named and the count shown, and nothing on that tab is saved. Shorten it and save again.

Remember the variables expand. {firstname} {lastname} is 21 characters in the box and can be far more on the wire, so a template close to the limit may still produce a longer message than you expect — and a longer SMS may cost more than one message.

Enabling and disabling

Every template ships enabled. Untick Enable and that event stops sending immediately after you save; nothing else about the template changes, and re-ticking it later resumes with the same wording.

This is the switch to reach for when a particular notification is unwanted or too noisy. There is no global off switch — to stop everything, either remove the API key or deactivate the addon.

Days Before, on the domain renewal reminder

DomainRenewalNotice is the only template with a lead time, and the only one not triggered by a WHMCS event. It runs from the WHMCS daily cron: each day it looks at every active domain and messages the client if the domain expires in exactly that many days.

• A whole number from 1 to 365. The default is 15.
• It is exactly that many days, not “within”. At 15, a client gets one message 15 days out — not one a day for the last fortnight.
• The same number fills the {x} variable in the message, so the text and the timing can never disagree.

A blank or out-of-range value is rejected rather than stored: the rest of the tab saves, and a warning names the template whose stored value was kept. That is deliberate — an empty value would both stop the reminder and remove the field from this page, leaving no way back.

Admin Phone Numbers

On the Admin tab, each template has its own recipients — there is no shared list. An admin template with this field empty never sends, however it is otherwise configured.

• Comma separated: +639171234567,+447911123456
• Full international format, including the country code. Spaces are stripped when you save, so +63 917 123 4567 is fine to type.
• Maximum 255 characters for the whole field.

Emoji

Emoji are fine in a fresh install. On an install upgraded from 3.9, saving one can fail until the tables have been migrated — deactivating and reactivating the addon runs that migration. See an emoji will not save.

The 28 templates

Client Templates

Admin Templates