> ## Documentation Index
> Fetch the complete documentation index at: https://docs.masivo.ai/llms.txt
> Use this file to discover all available pages before exploring further.

# Intelligent Timing

> Send scheduled messages and journey steps to each customer at the hour they are usually active

> [!NOTE]
>
> Intelligent Timing sends a scheduled message to each customer at their own
> best hour instead of sending it to everyone at once.

## What you'll learn

By the end of this guide, you'll know where to turn Intelligent Timing on, what
happens to a send that uses it, and how Masivo works out each customer's best
hour.

## Where it is available

* **Scheduled sends**: a switch in the **Schedule notification** dialog of
  **email** and **push** templates.
* **Journeys**: an option on any **Wait** step of a customer journey.

Both are off by default. Scheduled WhatsApp, in-app and News Feed sends do not
have it.

## Send at each customer's best hour

1. Open a template and select **Schedule**.
2. Pick the audience and set the **Schedule date**. This is when the send
   starts.
3. Turn on **Send at each customer's best hour**.
4. Select **Save**.

When the send starts, Masivo sorts the audience into two groups:

* **Customers with a best hour of their own** get the message the next time
  that hour comes around, within 24 hours of the schedule date. A customer whose
  best hour is the hour the send starts gets it right away.
* **Everyone else** gets the message when the send starts.

### What changes in this mode

* **Sending limits for the send are not available.** The send already spreads
  over 24 hours, so the per-send limits section is hidden.
* **Account and template email limits are counted when the send starts**, for
  the whole audience, not hour by hour.
* **The message content is prepared when the send starts.** Template variables
  use the customer's data at that moment, also for customers who get it hours
  later.
* **The send shows as processed once it is planned.** Messages keep going out
  for up to 24 hours after the schedule date.
* **You can cancel during those 24 hours.** Customers still waiting for their
  hour do not get the message. Customers who already got it keep it.

Template variants and control groups work the same as in any other send.

## Wait for the best hour in a journey

In a journey, the best hour is an option of the **Wait** step between two
nodes.

1. Open the journey and select the transition where the customer should wait.
2. Add a **Wait** step if it does not have one.
3. Check **Wait for the customer's best hour**.
4. Set **If unknown, wait**. This is how long customers without a best hour of
   their own wait. Leave it at 0 to move them on right away.

A customer with a best hour moves to the next node the next time that hour
comes around, so within 24 hours. If it is already their best hour, they move
on right away. Whatever the next node does, such as sending an email or a push,
happens at that moment.

The option is not shown in ticket journeys, because a ticket has no best hour.

## How the best hour is calculated

### What counts as activity

Activity is anything the customer does: opening the app, viewing products,
buying, opening or clicking an email, or any custom event you send for them.

Messages that Masivo sends do not count. A push delivered at 09:00 says when you
sent it, not when the customer was active.

### The rules

Masivo looks at the last **30 days** and groups each customer's activity by day
and hour, in your account's timezone.

* **Best hour of a customer**: the hour of the day in which they were active
  on the most days. If two hours tie, the one with more events wins.
* **Enough history**: a customer has a best hour of their own when all three of
  these are true:
  * They were active in at least **3** different day-and-hour slots.
  * Those slots fall on at least **2** different days.
  * Their best hour repeats on at least **2** different days.

A customer who opened the app on Monday at 19:10, Wednesday at 19:40 and
Friday at 12:05 has three slots on three days, and 19:00 repeats on two of
them. Their best hour is 19:00.

A customer who was active only once, or at a different hour each time, has no
best hour of their own.

## Good to know

* **Not everyone has a best hour.** Expect between 10% and 30% of your active
  customers to have one. The rest get the message at the schedule date.
* **Per-customer sends use a daily list.** Masivo refreshes each account's
  list of best hours about once a day, and a send at each customer's best hour
  reads from that list. A change in a customer's habits can take up to a day
  to show.
* **New customers start without a best hour.** They get one once they have
  enough history.
* **Email opens are a weak signal on some inboxes.** Some mail apps open
  messages automatically. Masivo counts each day and hour once, however many
  events arrive, so repeated opens do not skew the result.
* **Push has no open event.** For push, the best hour comes from app activity.
* **One timezone per account.** Customers in another timezone are measured in
  your account's timezone. Their best hour is still the right moment for them,
  because the send goes out at that same moment.


This documentation is built and hosted on [Mintlify](https://mintlify.com), a developer documentation platform.