Messaging rules: quiet hours, Friday, Ramadan, frequency caps and test numbers

Settings → Messaging rules (/app/settings/messaging) decides when, and how often, a marketing message may reach a person. The rules belong to the workspace you have open and are read in each recipient's own local time.

Who can change it

• Owner and Admin change the rules and press Save rules. Anyone else who opens the page sees them read-only, with "Only an owner or admin can change these rules."
• Owners, admins and editors can see and add Test numbers. Each person can remove the numbers they added; owners and admins can remove any.

What the rules do

• They apply to every WhatsApp broadcast in the workspace and are checked again for each batch, every 10 seconds. A change you save also applies to broadcasts that are already sending.
• They hold back Marketing templates. Utility templates are held back only when Apply to Utility templates too is on; Authentication (one-time codes) never is.
• Local time is the Timezone on the person's contact in Contacts when it is set (for someone who lives abroad, set it there). Otherwise it is the country of their phone number: +966 Saudi Arabia, +971 the UAE, +965 Kuwait, +974 Qatar, +973 Bahrain, +968 Oman, +20 Egypt (with its summer time), and so on. For countries with several time zones (+1, for example) the workspace Timezone is used (Workspace timezone).
• A person outside the window shows Waiting in the broadcast's Recipients (under Results). Their What happened shows Next try ... and, in amber, "Waiting for the recipient's send window: 2026-09-25 09:00 (Asia/Riyadh)", and they are sent when it opens. The broadcast stays Sending until everyone has had their turn.
• A person who already reached a frequency cap is Skipped, with the reason under What happened, for example "Frequency cap: already 1 marketing message(s) today (limit 1 a day)".

Step by step

1. Open Settings, then Messaging rules in the list of sections.
2. Quiet hours: set Earliest send time (default 09:00) and Latest send time (default 21:00). If the end is before the start the window runs past midnight; if both are the same, marketing may go at any hour.
3. Turn on Apply to Utility templates too only if order updates and reminders should also wait for the window.
4. Friday prayer pause: Pause marketing during Friday prayer is on by default, with Pause from 11:30 Until 13:30. The pause must end after it starts, on the same day.
5. Ramadan: Use the Ramadan send window during Ramadan is on by default, with Window opens 12:00 and Window closes 01:00. Under it the page lists this year's and next year's dates, for example "Ramadan 2026: 18 February to 19 March", and says "Ramadan is on now" during Ramadan.
6. Frequency caps: Per day (the recipient's local day) (default 1, up to 10) and Per 7 days (default 3, up to 50). 0 turns a cap off.
7. Extra STOP words: in Your words, one word or short phrase per line, up to 20. A message that is exactly one of them stops all messages to that person, like STOP and إيقاف do.
8. Opt-in keywords: the page lists the built-in words (START, SUBSCRIBE, YES OFFERS, OPT IN, اشتراك, اشترك, نعم للعروض…). Add your own in Your words, one per line, up to 20. A WhatsApp message that is exactly one of them subscribes the person to your marketing (Consent and opt-out). A word cannot be both an opt-in and a STOP word. Make an opt-in link & QR code opens Contacts → Opt-in link & QR.
9. Confirmation messages: Send a confirmation when someone subscribes and Send a confirmation when someone unsubscribes are on by default, each with an English text and an Arabic text (up to 500 characters; an empty box uses the built-in text). The Arabic text goes to people who wrote an Arabic keyword or whose contact language is Arabic. The message goes once, right after theirs, so it is free; nothing is sent when their consent did not change.
10. Press Save rules. "Messaging rules saved" appears, and "Last changed" with the time under the button. Before the first save the page says the recommended GCC defaults are in use.

Test numbers

1. In Test numbers, type the Phone number with its country code (for example +966 5x xxx xxxx) and, if you like, a Label (optional) such as "Sara's phone". 2. Press Add number. "Test number added" appears and the number is listed. 3. Remove takes a number off the list; it shows only on numbers you may remove. - Up to 10 numbers per workspace, each once. Contacts never receive test sends. - Send test on a broadcast's Review step (WhatsApp broadcasts) and in the template builder sends to these numbers only. A workspace can send 30 test messages in 24 hours.

How Ramadan and the windows combine

• Ramadan is detected automatically with the Umm al-Qura calendar (the official calendar of Saudi Arabia). Where the local moon sighting differs, the first or last day can be one day off.
• During Ramadan the Ramadan window replaces the quiet hours. A window belongs to the day it opens: the 12:00 to 01:00 window of the last day of Ramadan runs until 01:00 on the first day of Eid, and the night before 1 Ramadan still follows the everyday window.
• The Friday pause applies in Ramadan too.

What counts toward the caps

• Every marketing message a WhatsApp broadcast sends, and every marketing template an agent sends from the inbox. The inbox does not hold an agent's template back, but it counts toward the next broadcast.
• Messages are counted per person: all the numbers of a merged contact (Contacts) count together. "Per day" is the person's local day, from midnight.
• The broadcast's own Cooldown (days) still applies when a broadcast is created.

SMS

SMS (a later phase) has legal send windows these settings cannot change: Saudi Arabia 09:00 to 22:00, and 12:00 to 01:00 in Ramadan; the UAE 07:00 to 21:00.

If something goes wrong

• "The Friday pause must end after it starts, on the same day." → choose a Until time later than Pause from.
• "khalas" is both an opt-in and a STOP word. Remove it from one of the lists. → keep the word in only one of Extra STOP words and Opt-in keywords.
• "Enter the number with its country code, e.g. +966 5x xxx xxxx." → type the full international number.
• "A workspace can have up to 10 test numbers. Remove one first." or "This number is already a test number." → remove one, or use the one already listed.
• A broadcast has stayed Sending with people Waiting → read the amber note under their What happened: they are waiting for their local send window.
• Many people Skipped for the frequency cap → they already had marketing today or this week; send later, or raise the caps if your customers expect more.

Related

• WhatsApp broadcasts
• Contacts
• Workspace timezone and link tracking