[WIP] Implement marketing automation for social media platforms

[Copilot]

• Analyze existing codebase structure and integrations page
• Review research documentation for marketing automation requirements
• Verify build and type-check pass
• Phase 4.1 - Schema & Models
  • Add SocialChannel enum to Prisma schema
  • Add SocialIntegration model for platform connections
  • Add SocialProduct model for catalog sync
  • Add SocialOrder model to track orders from social platforms
  • Add CreatorAffiliate model for TikTok creator programs
• Phase 4.2 - API Routes
  • Add /api/social-commerce/[platform] routes for each platform
  • Add /api/social-commerce/catalog for product catalog sync
  • Add /api/social-commerce/webhooks for order import
  • Add /api/social-commerce/analytics for platform performance
• Phase 4.3 - Dashboard UI
  • Create Social Commerce dashboard page
  • Add platform connection cards (Facebook, Instagram, TikTok, WhatsApp, etc.)
  • Add social analytics dashboard component
  • Update navigation sidebar with Social Commerce section
• Phase 4.4 - Integration Components
  • Facebook Shop connection dialog
  • Instagram Shopping configuration
  • TikTok Shop setup
  • WhatsApp Business configuration
  • Pinterest/Snapchat integration cards
• Run code review and codeql_checker
• Final verification and testing

Original prompt

---

This section details on the original issue you should resolve

<issue_title>[Phase 4] Epic: Marketing Automation</issue_title>
<issue_description>## Priority: P3
Phase: 3
Type: Epic

Overview

Epic Goal: Enable merchants to sell products directly through social media platforms (Facebook Shop, Instagram Shopping, TikTok Shop, WhatsApp Business) without leaving the social apps, leveraging 4.9 billion social media users worldwide.

This epic targets the 70% of consumers who discover products through social media, providing native checkout experiences on platforms where customers already spend 2+ hours daily.

Business Value

• Market Size: 4.9 billion social media users globally (2024)
• Discovery to Purchase: 54% of social media users shop via social platforms
• Mobile-First: 98% of Facebook Shop purchases on mobile
• Impulse Buying: 30% higher conversion rate vs traditional e-commerce
• Younger Demographics: 72% of Gen Z prefer social shopping

Child Issues

Phase 3.1 - Facebook & Instagram (3 issues, 8 days)

• Issue [Phase 1] Idempotency Key & Request Replay Safety Layer #66: Facebook Shop Setup (3 days)

  • Facebook Commerce Manager integration
  • Product catalog sync (XML feed)
  • Inventory updates every 15 minutes
  • Order notifications via Facebook Messenger API
  • Checkout on Facebook (vs redirect to StormCom)

• Issue [Phase 1] RBAC & Scoped API Tokens (Multi-Tenant Authorization) #67: Instagram Shopping Tags (2 days)

  • Instagram Graph API (product tagging in posts/stories)
  • Sync product catalog from Facebook Shop
  • Shoppable posts UI (tag products in media)
  • Analytics (views, taps, purchases)

• Issue [Phase 1] Cache Tags & ProductSummary Denormalization Strategy #68: Facebook/Instagram Ads Integration (3 days)

  • Dynamic product ads (catalog-driven)
  • Pixel tracking (view_content, add_to_cart, purchase events)
  • Retargeting campaigns (abandoned cart recovery)
  • ROAS tracking (return on ad spend)

Phase 3.2 - TikTok Shop (3 issues, 8 days)

• Issue [Phase 1] Webhook Infrastructure & Delivery Guarantees #69: TikTok Shop Integration (3 days)

  • TikTok Seller API (product sync)
  • Live shopping integration (sell during live streams)
  • TikTok Shop tab on profile
  • Order management via TikTok Seller Center

• Issue [Phase 1] Observability Baseline (Structured Logging & Metrics) #70: TikTok Pixel & Attribution (2 days)

  • Install TikTok Pixel on StormCom checkout
  • Track events (view_content, add_to_cart, purchase)
  • TikTok Ads Manager campaigns
  • Attribution reporting (organic vs paid)

• Issue [Phase 1] Rate Limiting & Throttling Controls #71: Creator Collaboration Tools (3 days)

  • Affiliate links for TikTok creators
  • Commission tracking (10-20% per sale)
  • Creator dashboard (earnings, clicks, conversions)
  • Sample request system (send free products to creators)

Phase 3.3 - WhatsApp & Emerging Platforms (3 issues, 7 days)

• Issue [Phase 1] Refund & Return Workflow Primitives #72: WhatsApp Business API (3 days)

  • WhatsApp chatbot (order status, product inquiries)
  • Product catalog in WhatsApp Business app
  • Click-to-WhatsApp ads (Facebook/Instagram → WhatsApp chat)
  • Order confirmation via WhatsApp message

• Issue [Phase 1] P0 Integrity Foundations Tracking & Risk Matrix #73: Snapchat Commerce (2 days)

  • Snapchat Ads Manager integration
  • Product catalog sync
  • AR try-on (future feature placeholder)
  • Swipe-up to shop

• Issue [WIP] Add idempotency key and request replay safety layer #74: Pinterest Shopping (2 days)

  • Pinterest Product Pins (rich pins with pricing)
  • Pinterest Catalog ingestion
  • Shopping ads on Pinterest
  • Analytics (impressions, saves, outbound clicks)

Acceptance Criteria (Epic Level)

1. Facebook Shop

   • ✅ Product catalog synced to Facebook Commerce Manager
   • ✅ Checkout on Facebook (native Facebook Pay)
   • ✅ Inventory updates every 15 minutes
   • ✅ Order notifications via Messenger API

2. Instagram Shopping

   • ✅ Product tagging in posts and stories
   • ✅ Instagram Shop tab on profile
   • ✅ Checkout on Instagram (native Instagram Checkout)
   • ✅ Shoppable Reels (tag products in Reels)

3. TikTok Shop

   • ✅ TikTok Shop tab visible on profile
   • ✅ Live shopping (sell during live streams)
   • ✅ Product links in video descriptions
   • ✅ Affiliate creator program (10-20% commission)

4. WhatsApp Business

   • ✅ Product catalog in WhatsApp app
   • ✅ Chatbot for order inquiries
   • ✅ Click-to-WhatsApp ads
   • ✅ Order confirmation messages

5. Analytics

   • ✅ Revenue by social platform (last 30 days)
   • ✅ Conversion rate by platform
   • ✅ ROAS (return on ad spend) by platform
   • ✅ Top-performing products per platform

6. Performance

   • ✅ Product sync latency <5 minutes
   • ✅ Order import <30 seconds
   • ✅ Webhook processing <5 seconds
   • ✅ Support 10,000 orders/month across all platforms

Technical Architecture

Facebook Shop Flow

Merchant → StormCom Dashboard → "Connect Facebook"
                                      ↓
                        OAuth to Facebook Commerce Manager
                              ...

</details>

- Fixes CodeStorm-Hub/stormcomui#36

<!-- START COPILOT CODING AGENT TIPS -->
---

💡 You can make Copilot smarter by setting up custom instructions, customizing its development environment and configuring Model Context Protocol (MCP) servers. Learn more [Copilot coding agent tips](https://gh.io/copilot-coding-agent-tips) in the docs.

[vercel]

The latest updates on your projects. Learn more about Vercel for GitHub.

Project	Deployment	Preview	Comments	Updated (UTC)
stormcomui	Ready	Preview	Comment	Nov 25, 2025 2:22am