Social Media Integrations
Vivreal supports five social media platforms: X (Twitter), Instagram, LinkedIn, Facebook, and TikTok. Each integration lets you view posts, create content, and manage your social presence from within the portal.
Supported Platforms
| Platform | Post Types | Scheduling | Status |
|---|---|---|---|
| X (Twitter) | Text, images | Planned | Connected via OAuth |
| Images, stories | Planned | Connected via OAuth | |
| Text, articles, images | Planned | Connected via OAuth | |
| Text, images, links | Planned | Connected via OAuth | |
| TikTok | Video | Planned | Connected via OAuth |
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.
OAuth availability
OAuth authorization is fully functional for platforms where credentials are configured. If you see a "Connect your account" prompt without a redirect, contact your group admin to ensure the OAuth credentials are set up for that platform.
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 account information:
- Connected account name and avatar
- Follower/following counts (when available)
- Recent engagement 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) when available
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.
Save or publish
Save the post as a draft to edit later, or publish it immediately to push it to the connected platform.
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.
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.