Workspace Settings

Configure workspace defaults for business hours, escalation, messaging, and data export.

Intermediate
4 min read

Workspace Settings

Configure your workspace's core behavior — business hours, escalation rules, branding, and defaults that apply across all channels and workflows.

Go to SettingsWorkspace to access these settings. You'll need workspace management permissions to make changes.

General

Basic workspace identity and configuration.

SettingWhat It Does
NameDisplay name for your workspace
SlugURL identifier (e.g., my-workspace) — used in site URLs and API paths
TimezoneDefault timezone for scheduling, business hours, and event timestamps
LocaleLanguage and regional formatting preferences
Signup CodeCode required for new members to join via self-service signup
PublicWhether the workspace appears in public directories
Default AgentThe agent used when no specific agent is assigned to a workflow or task

Business Hours

Define when your workspace is "open." Business hours drive multiple platform behaviors:

  • The is_business_hours variable in CEL expressions and template variables
  • Escalation routing decisions
  • Phone number work modes (AI during hours, forward/voicemail after)
  • Conditional ability activation

For each day:

  • Enabled — Whether it's a working day
  • Start / End — Operating hours (e.g., 09:00 - 18:00)

Default: Monday through Friday, 9 AM to 6 PM in the workspace timezone.

Phone

Workspace-wide phone settings that apply to all phone numbers. Individual numbers can override these.

SettingWhat It Does
Brand NameHow the AI introduces itself on calls (e.g., "Thanks for calling Acme Corp")
Brand DescriptionBrief company description used for context and compliance
Brand WebsiteCompany website URL for reference
Default WorkflowWorkflow used for calls that don't have a specific assignment

See Phone & Voice for per-number configuration.

Escalation

Configure how conversations escalate from AI to humans. This applies across all channels.

SettingWhat It Does
Escalation WorkflowThe workflow triggered when the AI escalates a conversation
Escalation MessageMessage sent to the user when escalation occurs
Business Hours BehaviorHow escalations work during vs. outside business hours — you can route differently after hours

Email

Workspace-wide email defaults for outbound messages.

SettingWhat It Does
From NameDisplay name for outbound emails (e.g., "Acme Support")
Reply-ToWhere replies go when someone responds to a system email
SignatureText appended to the bottom of all outbound emails

See Email & Inboxes for per-inbox configuration.

Actions

Configure default behavior for workspace-level actions.

SettingWhat It Does
Default Webhook URLFallback URL used when an action doesn't specify its own webhook endpoint
Retry PolicyHow failed actions are retried (number of attempts and delay)

See Actions for creating and configuring individual actions.

Import / Export

Manage your workspace configuration as a whole.

Export

Download your entire workspace configuration as a JSON file. Useful for:

  • Backups — Save a snapshot before making major changes
  • Migration — Move configuration between workspaces
  • Debugging — Share configuration with support when troubleshooting

Import

Upload a workspace configuration JSON to restore or apply settings.

Warning: Import overwrites existing configuration. Always export first as a backup before importing.

Tips

  • Set business hours early — Many features reference them, including phone work modes, escalation rules, and CEL conditions
  • Configure escalation — Even if you plan to let the AI handle everything, have an escalation path ready for edge cases
  • Use the default agent — Setting a workspace default means new workflows automatically have an AI assigned
  • Export regularly — Keep periodic configuration backups, especially before making large changes