Skip to main content
Dark Windows are available under Settings → Data → Dark Windows. They let workspace owners and admins pause proactive outbound activity for individual channels without turning the channel off.

​
How a window works

Each channel has its own on/off switch, start time, and end time. Times use the workspace timezone shown on the page. The start is included and the end is excluded. A window such as 21:00 to 08:00 runs overnight. Dark Windows apply to proactive sends and dials from campaigns, callbacks, automations, the API, and MCP. Replies to inbound customer messages and manual replies from History remain available.

​
Channels

You can configure separate windows for Voice, SMS, Email, WhatsApp, Telegram, Slack, Messenger, Microsoft Teams, Discord, Google Chat, and X. Workspaces that opt into beta features also see separate controls for Freshdesk, Gmail, Outlook, Zendesk, ServiceNow, Intercom, Zoho Mail, AgentMail, Instagram, and Zulip. The generic Email window and the provider-specific email windows are independent.

​
API and MCP

  • GET /api/v1/settings/dark-windows returns all channel windows and the workspace timezone.
  • PATCH /api/v1/settings/dark-windows updates one or more channels. Channels omitted from settings remain unchanged.
  • MCP tools: get_dark_window_settings and update_dark_window_settings.
REST uses settings:read / settings:write; MCP also accepts the matching assistant read/write scopes.