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.
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.
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:
ScheduledMessageWorker runs every 30 seconds to automatically dispatch due communications.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
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.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.
3. Social Publishing & Content Creation
Cross-post content to Facebook, Instagram, LinkedIn, and YouTube simultaneously