Documentation

Social Publishing README

Structured guidance, reference notes, and linked documentation for WebSwift.

Type

Docs

Reference

Updated

Apr 14

Last edit

This document is part of the WebSwift knowledge base, with structured navigation and linked references.

# Detailed Product Documentation

## Overview and Purpose

Social Publishing enables organizations to distribute content to external social channels from within the platform. It supports channel connectivity, scheduling, queue execution, and publishing visibility so teams can run consistent outbound campaigns.

## Target Users/Personas

-   Social Media Manager: plans and schedules campaigns.
-   Content Marketer: transforms blogs/docs into social posts.
-   Organization Admin: oversees connected account health and governance.

## Key Capabilities

-   Multi-channel connection management.
-   Draft, immediate, and scheduled publishing.
-   Queue execution and publish tracking.
-   Tenant-safe account and post isolation.

## Workflows and User Journeys

1.  User connects social accounts.
2.  User composes post or imports from source content.
3.  User selects channels and schedule.
4.  Queue executes at target time.
5.  User reviews status and retries failures as needed.

## High-Level Architecture

-   Models: social account, post, schedule/queue entities.
-   Views/services: compose, validate, enqueue, execute workflows.
-   Background processing: scheduled publish runner.
-   Integrations: external platform APIs and token refresh logic.

## Integrations

-   Blog/Pages/Knowledge Hub as source content.
-   Accounts/Tenants for authorization and scoping.
-   AI modules for content suggestion generation.

## Limitations and Edge Cases

-   External API rate limits can delay or fail publishes.
-   Token expiry can break queue jobs without reconnect handling.
-   Platform-specific content format constraints vary significantly.

# Features

### Social Account Connectivity

1.  Connect social platform accounts.
2.  OAuth/token persistence for connected channels.
3.  Channel metadata storage (name/type/status).
4.  Token validity checks and reconnect flows.
5.  Channel enable/disable controls.

### Content Publishing

1.  Create social posts from internal content.
2.  Multi-platform publish selection.
3.  Immediate publish workflow.
4.  Scheduled publish workflow.
5.  Draft save/edit before publishing.
6.  Publish status tracking.
7.  Failure capture and retry affordances.

### Queue and Scheduling

1.  Publish queue model for future jobs.
2.  Scheduled time and timezone handling.
3.  Batch enqueue behaviors.
4.  Queue processing execution path.
5.  History listing for scheduled and executed posts.

### Performance and Tracking

1.  Per-post engagement metadata capture (where available).
2.  Publishing audit/history logs.
3.  Platform/channel-level performance summaries.
4.  Linkback to source content when derived from blog/docs.

### Hidden/System Features

1.  Tenant-scoped social account isolation.
2.  Permission-gated publishing actions.
3.  Safe behavior for expired credentials.
4.  Idempotency guards around repeated publish attempts.
5.  Compatibility with AI-generated content workflows.

Explore the site

Launch your own site.

Social Publishing README