SocialSuite Application Help Manual

Complete user guide and standard operating procedures for marketing agencies & client portals

User Guide v2.5 Developer Config

1. System Architecture & User Roles

Multi-tenant security isolation between Agency Managers and Client Portal Users

SocialSuite is built on a high-concurrency clean architecture with strict tenant isolation. The platform separates administrative powers from client stakeholders, ensuring private customer data and marketing budgets remain confidential.

Agency Admin Full Control

Agency users manage all client portfolios, create multi-channel posts, conduct outbound WhatsApp campaigns, connect company social channels, and manage billing quotas.

Client Portal User Scoped Access

Client stakeholders log into a white-labeled dashboard branded with their own company logo and color palette. They review and approve draft posts, inspect inbound customer leads, and view quota consumption.

Capability Agency Administrator Client Portal User
Switch & Manage All Clients Yes Locked to own organization
Create & Schedule Posts Yes View Scheduled Queue
Review & Approve/Reject Posts Yes Sign-off with comments
WhatsApp Media Broadcasts Yes Within monthly quota
Export Leads to CSV Yes Own leads only
Channel OAuth Integrations Yes View connection status

2. Executive Dashboard & Metrics

Real-time visibility across campaigns, engagement, leads, and channel status

Upon logging in, the dashboard displays high-priority KPIs calculated in real time:

Client Portfolio Count

Total active clients currently managed by the agency, including active campaign rollouts.

Published & Scheduled

Tracks posts published this month vs. queued posts awaiting automated release.

Captured Leads

Volume of qualified prospects captured via Facebook Lead Ads, WhatsApp inquiries, and campaigns.

Outbound Communications

Total WhatsApp flyers, SMS alerts, and marketing emails delivered across all channels.

3. Social Publishing & Content Creation

Cross-post content to Facebook, Instagram, LinkedIn, and YouTube simultaneously

1
Select Target Client: From the client dropdown, choose the client organization for whom the post is authored.
2
Choose Social Platforms: Toggle the platform checkboxes (Facebook Page, Instagram Profile, LinkedIn Company Page, YouTube Shorts).
3
Draft Captions & Hashtags: Enter engaging copy in the post composer with character counter feedback.
4
Attach Media: Upload high-resolution images or videos (supported: JPG, PNG, MP4, MOV up to 100MB).
5
Scheduling & Workflow:
  • Publish Immediately: Sends content directly to authorized channel APIs.
  • Schedule for Future: Set a date and time. The background scheduler dispatches it automatically.
  • Require Client Approval: Moves post into the Approval Queue for stakeholder sign-off before publishing.

4. Client Content Approval Workflow

Eliminate accidental publishing with formal sign-off procedures

When an agency user checks Requires Client Approval, the post remains in state Pending Approval. Client users can log into their branded portal to inspect the post preview.

Client Sign-off Actions: Clients can click Approve (moving it directly to the Scheduled Queue) or click Reject and provide actionable feedback notes (e.g. "Please adjust the offer headline to 20% off"). The agency is notified immediately.

5. Customer Leads & Inquiries CRM

Capture, qualify, and convert leads with 1-click WhatsApp outreach

Pipeline Stages

Track prospect status across stages: New → Contacted → Qualified → Won → Lost.

1-Click WhatsApp Quick Action

Click the green WhatsApp button next to any lead to launch an instant messaging modal with pre-filled greeting and media attachment options.

1-Click CSV Export

Download filtered lead lists with contact numbers, email addresses, source channels, and qualification scores for external CRM importing.

6. Omnichannel Messaging (WhatsApp, SMS & Email)

Send rich promotional flyers, video reels, and scheduled automated broadcasts

The messaging console provides enterprise outbound communication capabilities across three unified channels:

WhatsApp Business Cloud API: Upload promotional flyer images (PNG/JPG) or marketing video clips (MP4). Preview renders dynamically in real-time before delivery.
Telecom SMS: Deliver urgent flash alerts and OTP notifications with verified Alphanumeric Sender IDs.
Email Communications: HTML-formatted campaign announcements and weekly digest reports.
Automated Delivery Scheduling: Toggle the Schedule for Future Delivery switch, pick a date & time. The ScheduledMessageWorker runs every 30 seconds to automatically dispatch due communications.
Real-time Cancellation: Scheduled messages appear in the Outbound Communication Log with a yellow clock badge. Users can click the red Cancel button at any time before the scheduled delivery time arrives.

7. Marketing Campaigns & Broadcasts

Orchestrate multi-channel marketing campaigns across targeted audience segments

Create thematic marketing campaigns (e.g. Black Friday 50% Blast, Q4 Product Launch, Spring Festival Offer):

  • Assign campaign to a specific client and set a designated budget.
  • Select channel targets (Facebook, Instagram, WhatsApp, SMS, Email).
  • Target specific customer audiences (All leads, Qualified leads, or Past customers).
  • Set launch date and schedule automated delivery.

8. Client Portfolio & White-Label Branding

Custom logos, brand colors, and dedicated client portal logins

Custom Brand Logo

Upload each client's high-resolution logo. The sidebar and header automatically replace the default SocialSuite brand when the client user logs in.

Brand Accent Color

Specify the client's corporate HEX color (e.g. #0A66C2 for LinkedIn Blue or #10B981 for Emerald). Buttons and active tabs match their corporate brand.

Brand Tagline

Display custom brand positioning under the client logo in the sidebar (e.g. Official Client Portal).

9. Marketing Calendar & Performance Analytics

Unified visual scheduling and deep multi-channel performance reports

Interactive Calendar

Monthly, weekly, and daily grid views of all scheduled social posts and marketing campaigns with colored channel pills.

Performance Analytics

Engagement rates, impressions, follower growth, click-through rates, and channel ROI comparisons with exportable PDF/Excel summaries.

10. Appearance Themes & Table Usability

Spacious layout, single-line data grids, and color palette engine

Color Palette Switcher: Click the palette icon in the top navigation bar to choose from 5 designer palettes: Royal Indigo, Deep Ocean, Emerald Growth, Sunset Coral, or Studio Violet. Choices persist in browser local storage.
Dark & Light Mode: Toggle dark mode instantly with 1-click for comfortable evening workflow.
Enterprise Grid (Dual-Axis Scroll): All data tables have white-space: nowrap enabled so long phone numbers, email addresses, and client names never wrap awkwardly. If data exceeds the container, smooth horizontal and vertical scrolling is activated automatically with sticky table headers.
Responsive Menu Toggle: On desktops, the hamburger button collapses the sidebar into a compact mini-sidebar with tooltips. On mobile and tablet devices, the sidebar acts as a touch-friendly slideout drawer with backdrop blur.

11. Frequently Asked Questions & Troubleshooting

Fast solutions to common operational and integration questions

What happens if a post fails to publish?

SocialSuite logs the API error message in Post History with a retry button. Verify that the social channel token has not expired under Connected Channels.

How often does the scheduler check for due posts?

The background worker executes every 30 seconds, automatically sending any posts, WhatsApp messages, or campaigns whose scheduled timestamp has arrived.

Can client users see other clients' leads?

No. Client users have a strict tenant isolation claim. The database query automatically attaches WHERE ClientId = @UserClientId, preventing cross-tenant data leakage.