Social Post Workflow
The social post workflow handles scheduling and tracking social media posts across multiple platforms via Ayrshare integration.
Overview
Supported Platforms
Step-by-Step Flow
1. Create SocialPost
2. Post is Published
Ayrshare automatically publishes at the scheduled time:
3. Analytics Collection
Every 6 hours, the Bridge collects performance data:
SocialPost States
| Status | Description | What Happens |
|---|---|---|
| Draft | Work in progress | Not sent to Ayrshare |
| Scheduled | Ready to publish | Sent to Ayrshare, waiting |
| Published | Live on platform | Analytics being collected |
| Failed | Error occurred | Check error field |
Post Types
| Type | Purpose | Example |
|---|---|---|
| Promo | Announce new content | "New episode dropping tomorrow!" |
| Reminder | Remind about upcoming | "Going live in 1 hour!" |
| Clip | Share video clip | Short clip with caption |
| Episode Link | Link to full content | "Watch the full episode: [link]" |
| Quote | Quotable moment | Pull quote from episode |
| Behind Scenes | BTS content | Studio photos, outtakes |
Linking to Content
SocialPosts can be linked to ContentProduction for tracking:
Deleting/Canceling Posts
When a SocialPost is deleted, the Bridge cancels it in Ayrshare:
Multi-Platform Posting
Post the same content to multiple platforms:
Analytics Tracking
Metrics Collected
| Metric | Description |
|---|---|
| Impressions | Times post was shown |
| Likes | Like/favorite count |
| Comments | Comment count |
| Shares | Retweet/share count |
| Clicks | Link clicks |
| Engagement Rate | Interactions / Impressions |
Data Flow
API Operations
Schedule a Post
http
POST /ayrshare/schedule
Content-Type: application/json
{
"post": "Check out our latest episode! 🎙️",
"platforms": ["twitter", "facebook"],
"scheduleDate": "2026-02-10T15:00:00.000Z",
"mediaUrls": ["https://example.com/image.jpg"]
}1
2
3
4
5
6
7
8
9
2
3
4
5
6
7
8
9
Get Post History
http
GET /ayrshare/history?limit=501
Get Analytics
http
GET /ayrshare/analytics?platform=twitter&postId=ayr_1231
Delete/Cancel Post
http
POST /ayrshare/delete
Content-Type: application/json
{
"id": "ayr_123"
}1
2
3
4
5
6
2
3
4
5
6
Best Practices
Schedule in Advance
Schedule posts at least 10 minutes in advance to ensure reliable delivery.
Use Platform-Specific Content
Different platforms have different optimal content. Customize for each.
Character Limits
- X/Twitter: 280 characters
- Facebook: 63,206 characters
- LinkedIn: 3,000 characters
- Instagram: 2,200 characters
Track Performance
Use Grafana dashboards to identify your best-performing content types and times.