System Settings

Overview

System Settings (Admin → Settings) is where the platform owner configures everything that isn't tied to a single workspace: the brand, the WhatsApp engine, signup behaviour, billing scope, SEO, the installable app, email, and integrations. Changes take effect immediately.

Secret values are encrypted. Sensitive credentials — the Meta App Secret, the webhook verify token, the Twilio Auth Token, Unofficial API tokens, and the Meta system-user and Ads tokens — are stored encrypted and never shown back to you in full.

The settings landing page shows a quick summary — how many settings are filled in, how many secrets are stored, what still “needs a test”, and when settings were last changed and by whom — followed by a card for each group. Each group has its own page:

General & Brand

The General page (Settings → General) covers the platform's identity and default behaviour.

Brand assets

WaDesk uses a single favicon shared across all themes, plus one logo per theme so each look can carry its own version. The theme slots are:

The favicon accepts PNG, ICO, JPG, SVG, or WebP (up to 512 KB); logos accept PNG, JPG, SVG, or WebP (up to 1 MB).

Tip. For the Dark theme, upload a light or inverted version of your logo so it stays legible against the dark background.

Default Signup Plan, Trial & Billing Scope

Three settings on the General page govern what happens the moment a new owner finishes signing up:

• Per workspace — each workspace is billed separately on its own plan.
• Per account — the owner's paid plan unlocks all of their workspaces.

Caution. The default signup plan must be a real plan, so create the plan first and then select it here. Changing the billing scope affects how every owner's plan benefits are worked out, so review your plans before switching it on a live platform.

WhatsApp Provider Configuration

The WhatsApp Message page (Settings → WhatsApp Message) is the most important integration page. You pick exactly one messaging engine — it is used across the whole platform; individual workspaces don't get a choice. Clicking an engine card reveals that engine's credential fields.

Switching engines mid-traffic drops messages already queued for sending. Pause campaigns first, then change the engine.

Business API (Meta) fields

Per-workspace credentials. Each workspace connects its own phone number and access token while adding a connected number (Devices → Add device). You, the admin, only configure the platform-level Meta App credentials here.

Advanced Business API controls (shown only when Business API is active)

Unofficial API field

Twilio fields

Sending speed & batching

The bottom of the page controls how fast messages go out, to help you stay under WhatsApp's limits.

Pacing tip. Lower the gap between messages only after running smoothly for a day — Meta throttles senders that move too fast. 3 seconds is the safe default. See the three engines overview for how each engine differs, and the Webhooks page for incoming vs outgoing messages.

Email (SMTP)

The Mail page (Settings → Mail) sets up outgoing email. Every field starts from whatever your installation was set up with, so a fresh install isn't blank. Saving takes effect immediately — the very next email uses the new settings.

Send a test. The page has a Send test button: enter an address and WaDesk sends a one-line test email using the saved settings, then shows success or the exact error. A successful test is recorded in the audit log and clears the “needs test” flag on the settings page.

SEO

The SEO page (Settings → SEO) sets how your platform appears in search results and when shared on social media, with a live preview that uses your brand name. Fields include the page title, description, and keywords; a robots directive (default index, follow); a canonical URL and author; the social-share card details (title, description, image, type, URL) used by Facebook and Twitter; and search-engine verification codes for Google and Bing. A fresh install ships sensible defaults so the preview is never empty.

Installable App (PWA)

The PWA page (Settings → PWA) lets visitors install your platform like an app on their phone or desktop, and controls how that installed app looks.

Tip. Provide both the 192×192 and 512×512 icons — browsers use the small one for the home-screen tile and the large one for the splash screen. Theme and background colors must be valid hex values.

Wallet, Checkout & Integrations

Beyond the groups above, System Settings also covers:

• Wallet rules (Settings → Wallet Rules) — how many credits a new signup gets from a referral, how many credits each outgoing message costs, and how many credits a customer gets per unit of currency when they top up.
• Checkout settings — how the plan checkout behaves, in its own area (Admin → Checkout Settings).
• Integrations — the integration hub, plus Shopify (on/off, app keys, permissions, redirect URL) and WooCommerce connection settings, and the product catalog (with its own test button).
• Privacy & Analytics — the cookie banner, GDPR / CCPA and accessibility options, and analytics tracking IDs (Google Analytics, Google Tag Manager, Meta Pixel, Microsoft Clarity, Plausible, PostHog, and more).

All your settings can be exported to a file, and a “needs test” indicator flags any saved integration — email, catalog, or Shopify — that hasn't yet passed a successful test.

Caution. Provider tokens, app secrets, the webhook verify token, and the email password are stored encrypted using your installation's security key. If that key is ever changed, the saved secrets can no longer be read — you would need to re-enter every secret afterwards.

Related Pages

• AI & API Keys — the global AI provider credentials.
• Security & Audit Log — platform security policy and the record of settings changes.
• Announcements — the platform-wide marquee bar.
• Webhooks — outbound webhooks, and where the inbound platform webhook is wired.