Send windows

Learn how to control when notifications are delivered using send windows.

You can use send windows to specify when a channel step should send a message. For example, if you want to ensure your customers don’t receive a given transactional email from your product outside of working hours, you can set send windows for Monday - Friday, between 9:00 a.m. and 6:00 p.m. local user time.

Send windows are evaluated using the recipient's local time, specified by the user timezone property. If the user's timezone is not set, the account default timezone will be used.

Modeling send windows

Knock models send windows as a list of send window objects. Each day must have 1 send window specified.

The send window object has the following properties:

PropertyDescription
dayDay of the week. One of: ”monday”, ”tuesday”, ”wednesday”, ”thursday”, ”friday”, ”saturday”, ”sunday”.
typeWhether notifications should be sent or not sent for this send window. One of: ”send”, ”do_not_send”.
fromAn optional ISO-8601 time-only format string specifying the start of the window (defaults to 00:00:00). Only supported if type is set to ”send”.
untilAn optional ISO-8601 time-only format string specifying the end of the window (defaults to end of day). Only supported if type is set to ”send”.

In our JSON representation this will look something like:

The send windows editor

When creating or modifying a channel step, you can use the send window editor to configure send windows.

You can use it to configure whether notifications should be sent on a given day or not. If notifications are enabled for a day of the week, you can also specify the time range they should be sent.

Send windows editor

Send windows editor