Social Media Integrations
Vivreal supports five social media platforms: X (Twitter), Instagram, LinkedIn, Facebook, and TikTok. Each integration lets you view posts, create and schedule content, and manage your social presence from within the portal.
Supported Platforms
| Platform | Post Types | Scheduling | OAuth | Multi-account |
|---|---|---|---|---|
| X (Twitter) | Text, images | Yes (publishDate) | Live | Yes |
| Images, video | Yes | Live (Instagram Login) | Yes | |
| Text, articles, images | Yes | Live (incl. Company Pages) | Yes (account + org) | |
| Text, images, links | Yes | Live (Pages via Facebook Login) | Yes (account + page) | |
| TikTok | Video | Yes | Live | Yes |
Engagement metrics are not yet live
Likes / impressions / reposts on published posts currently render as -- placeholder. The OAuth bind, post publishing, scheduling, and account targeting all work today; the per-platform analytics backfill cron is the missing piece. This is on the roadmap.
Connecting a Social Account
Social integrations use OAuth 2.0 to connect your account. This means you authorize Vivreal to act on your behalf without sharing your password.
Open the integration page
Go to Channels from the bottom navigation bar and tap the social platform you want to connect.
Start the OAuth flow
Click the Connect button in the integration's configuration panel. You will be redirected to the platform's authorization page.
Authorize Vivreal
Sign in to your social account (if not already) and approve the requested permissions. Vivreal requests only the scopes needed for posting and reading your content.
Return to the portal
After authorization, you are redirected back to the Vivreal portal. The integration status will show as Connected with your account name.
One channel can hold multiple accounts
Each social channel is multi-account: a single LinkedIn integration can hold one personal account that admins three Company Pages, and a single Facebook integration can hold one user account that admins multiple Pages. When you compose a post, the account picker lets you choose which account (and, where applicable, which org or page) to publish from.
The Social Integration Page
All five social platforms share a consistent page layout with the following sections:
Overview Tab
Each platform's overview tab shows platform-specific metrics and connected-account information:
- Connected account name and avatar
- For LinkedIn: list of admin'd Company Pages
- For Facebook: list of admin'd Pages
- Recent post summary
Posts Tab
The posts tab displays all content associated with the integration. Each post card shows:
- Post text or caption
- Attached media (images, video thumbnails)
- Publication status (published, draft, scheduled)
- Engagement metrics (likes, comments, shares) — currently placeholder, see callout above
You can filter posts by status and search by keyword.
Settings Tab
From the settings tab you can:
- Sync from the platform — Pull the latest posts and data from the connected account.
- Update authorization — Re-authorize if your OAuth token has expired.
- Disconnect — Remove the social integration from your group.
Creating Social Content
Navigate to the integration
Open the social platform's integration page from the sidebar.
Click New Post
Click the + New Post button at the top of the posts tab. This opens the content editor.
Compose your content
Write your post text, attach images or media, and set the publication status. A character counter helps you stay within the platform's limits. If the channel has multiple connected accounts, the account picker lets you choose which one publishes the post.
Schedule or publish
Pick a future publish date to schedule the post, leave the date blank to publish immediately, or save as a draft to edit later. Scheduled posts are dispatched by Vivreal at the chosen time.
Cross-platform publishing
Vivreal is building toward omnichannel publishing, where you can publish a single piece of content to your website, social accounts, and email list in one action. Currently, you publish to each platform individually — but you can schedule the same content across multiple channels at the same moment by passing the same publish date to each.
Content Sync
Each social integration supports on-demand sync. Click Sync from [Platform] in the settings tab to pull your latest posts from the connected account into Vivreal. Synced posts appear as collection objects linked to the integration.
Sync requires active credentials
If your OAuth token has expired or the integration is not fully connected, the sync button will prompt you to re-authorize before proceeding.
Managing Posts
From the posts tab, you can:
- Edit — Update the text or media of a draft post.
- Delete — Remove a post from Vivreal. This does not delete it from the external platform.
- View on platform — Open the post directly on X, Instagram, LinkedIn, Facebook, or TikTok.
Platform-Specific Notes
X (Twitter)
Posts are limited to 280 characters (or 25,000 for premium accounts). Image attachments support up to 4 images per post.
Requires a Business or Creator account for API access. Story publishing is planned for a future release.
Supports text posts and article sharing. Company page posting requires admin access to the LinkedIn page.
Connects to Facebook Pages, not personal profiles. You must be an admin of the Page to authorize the integration.
TikTok
Video publishing requires uploading a video file. TikTok's API has specific encoding requirements that Vivreal handles automatically during upload.