social media content publishing

## 📱 SOCIAL MEDIA POSTING WORKFLOW
━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━

🎯 PURPOSE:
Automated multi-platform social media posting using Postiz API. Distributes content across Instagram, Twitter/X (2 accounts), LinkedIn, and Facebook with platform-specific content cleaning and formatting.

🔄 COMPLETE WORKFLOW PROCESS:
1. 📊 Fetch social media content from Airtable database
2. 🔗 Get integration IDs for all connected social platforms
3. 🔀 Route each platform to appropriate content processor
4. 🧹 Clean content to prevent JSON formatting errors
5. 📱 Post to respective social media platforms simultaneously

📋 PLATFORM COVERAGE:
• 📸 Instagram (Visual content + captions)
• 🐦 Twitter/X Main Account (Text + images)
• 🐦 Twitter/X Alt Account (Duplicate posting)
• 💼 LinkedIn (Professional content)
• 📘 Facebook (Meta ecosystem posting)

⚠️ CRITICAL CONTENT CLEANING:
• Removes line breaks (\n), carriage returns (\r), tabs (\t)
• Replaces multiple spaces with single spaces
• Prevents 'JSON parameter needs to be valid JSON' errors
• ESSENTIAL: Without cleaning, all API calls fail!

🔧 TECHNICAL SPECIFICATIONS:
• API: Postiz /posts endpoint (POST)
• Authentication: HTTP Header Auth
• Content-Type: application/json
• Posting Type: Immediate ('now') + 1 minute delay
• Media: References pre-uploaded Postiz image paths
• Rate Limit: 30 requests/hour (API beta limitation)

🔗 DATA SOURCES:
• Content: Airtable 
• Media: Pre-uploaded via separate media upload workflow
• Fields: instagram_caption, linkedin_post, twitter single, faceboook
• Images: References 'postiz image' field paths

⚡ EXECUTION FLOW:
Airtable → Integrations → Platform Router → Content Cleaners → Social Publishers

🚨 TROUBLESHOOTING:
• JSON Errors: Check content cleaning nodes
• 500 Errors: Verify integration IDs and account connections
• Missing Media: Ensure media upload workflow ran first
• Rate Limits: Space out executions (30/hour limit)

🔄 DEPENDENCIES:
• Requires: Media upload workflow (for image/video paths)
• Connects to: Analytics and monitoring workflows
• Updates: Airtable with posting status and URLs

━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━