π POSTIZ MEDIA UPLOAD WORKFLOW ββββββββββββββββββββββββββββββββββββββββββββ π― PURPOSE: Automated media upload pipeline that downloads videos and images from Google Drive and uploads them to Postiz storage for social media posting. π WORKFLOW PROCESS: Webhook triggers the workflow Fetch media metadata from Airtable Download video + image from Google Drive Upload both files to Postiz storage Save Postiz file paths back to Airtable π§ TECHNICAL DETAILS: β’ API: Postiz /upload endpoint (multipart-form-data) β’ Storage: Converts Google Drive files β Postiz URLs β’ Integration: Updates Airtable with Postiz paths β’ Required: All media must be uploaded before posting π± 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: π Fetch social media content from Airtable database π Get integration IDs for all connected social platforms π Route each platform to appropriate content processor π§Ή Clean content to prevent JSON formatting errors π± 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: instagramcaption, linkedinpost, 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 ββββββββββββββββββββββββββββββββββββββββββββββββββββββββββββββββββββββββββ β οΈ CRITICAL NOTES: β’ Cannot use external URLs in Postiz posts β’ Files must be uploaded to google drive first - id referenced in airtable β’ Enables reference tracking for all platforms π DATA FLOW: Google Drive β Download β Postiz Upload β Airtable Update π CONNECTS TO: Main social media posting workflows that reference these uploaded file paths for Instagram, Twitter, LinkedIn, Facebook, and YouTube posting. π¬ VIDEO POSTING WORKFLOW ββββββββββββββββββββββββββββββββββββββββββββββββββββββββββββββββββββββββββ π― PURPOSE: Automated video content distribution across Instagram, Facebook, and YouTube using Postiz API. Specialized workflow for video content with platform-specific processing and cleaning. π WORKFLOW EXECUTION: π Fetch video content from Airtable database (recuoYjg4icStHsMK) π Get integration IDs for video-enabled platforms π Route platforms to appropriate video processors π§Ή Clean content for Instagram & Facebook (YouTube bypassed) πΉ Publish to video platforms simultaneously πΉ PLATFORM COVERAGE: β’ π± Instagram: Video posts & Reels (β Working) β’ π Facebook: Video content (β οΈ Test mode) β’ π¬ YouTube: Long-form videos (π¨ Broken) β‘ EXECUTION FLOW: Airtable β Integrations β Video Router β [3 Parallel Paths] βββ Instagram: Cleaner β Publisher βββ Facebook: Cleaner β Publisher βββ YouTube: [Direct] β Publisher ποΈ DATA SOURCE: β’ Base: Netkreatives.com β’ Table: Youtube tool β’ Video Field: 'postiz video' β’ Content Fields: instagram_caption, faceboook π§ TECHNICAL SPECS: β’ Method: POST β’ Auth: HTTP Header (Postiz credentials) β’ Timing: Immediate posting (+1 minute delay) β’ Media: Pre-uploaded video paths β’ Content-Type: application/json
