DIY Surveys / API
  • Welcome to the DIY Surveys API
  • Getting Started
  • Messaging
    • Keyword
    • Languages
    • GSM Character Set
    • Macros
      • Macro Reference
    • Message Statuses
    • Message Windows
    • Metadata
    • Stop Lists
    • Usage
    • Message Type
  • Organizations
  • Recipient
  • Security
  • Survey
  • TinyUrl
  • Web Hooks and Callbacks
  • Custom Transformations
  • FAQ
  • Cloud Service
  • API Versions
    • DIY Surveys API 1.0
    • DIY Surveys API 2.0
    • DIY Surveys API 3.0
Powered by GitBook

Services

  • Surveys
  • Respondents
  • Results
  • Channels

© 2025 DIY Surveys Ltd.

On this page
  • Adjusting for Country Time Zone
  • Multiple Windows

Was this helpful?

  1. Messaging

Message Windows

PreviousMessage StatusesNextMetadata

Last updated 8 months ago

Was this helpful?

Message windows are used to control when a message can be sent from the DIY Surveys platform. It is based on the possibility that messages could be queued up in the platform (due to a heavy load) and they should not be sent out at inappropriate times. If a window is defined then the platform knows to hold on to the message if the associated window is closed.

A window is defined by three parameters:

  1. From - a time when the window is open

  2. To - a time when the window is closed

  3. Days - the days the window is open

The times are automatically adjusted to the country based on the destination and the days are represented by a number where 1 is Sunday and 7 is Saturday.

It is also possible to use the three letter days (e.g. sun, mon, etc.) or the full names (Sunday, Monday, etc.).

"Window": [{ "From": "09:00", "To": "16:00", "Days": "1,2,3,4,5"}]

Adjusting for Country Time Zone

The DIY Surveys Platform will automatically adjust the time based on the destination country of the message to be sent. This means that a window of 9am to 4pm will be 9am to 4pm whatever country the message is going to arrive in.

Multiple Windows

It is also possible to define multiple windows to cater for different windows on different days. For example it may be necessary to have a different window during the week compared to the weekend.

For examples of how windows are used in sending messages check .

here