Meta Shops Integration Setup

📋Before You Start

• Facebook Business Manager account
• Facebook Shop enabled on your Facebook Page or Instagram Business account
• Commerce account set up in Meta Commerce Manager (commerce.facebook.com)

🔧Setup Steps

1. 1
   Open Meta OAuth in Pythias

   In Pythias, go to Admin → Integrations → Add New Integration → Meta Shops. Click Connect with Facebook. You will be redirected to Facebook's login and permissions page.
2. 2
   Grant Commerce Manager permissions

   Sign in with the Facebook account that has admin access to your Business Manager. When prompted, select the Business Manager and Commerce account you want to connect. Grant Pythias access to: Manage orders and Manage shipping. Click Continue.
3. 3
   Select your shop

   Pythias will list the Facebook Shops associated with your Commerce account. Select the shop you want to sync orders from and click Save.
4. 4
   Configure shipping and fulfillment

   Meta requires tracking numbers to be uploaded within 3 days of the estimated ship date. In the integration settings, configure your default carrier and enable Auto-upload tracking.

🔄What Gets Synced

• ✓Orders placed via Facebook Checkout or Instagram Checkout
• ✓Order items, product IDs, quantities, and buyer shipping address
• ✓Shipment tracking pushed to Meta Commerce Manager
• ✓Order fulfillment status update (fulfillment confirmations sent to buyer)

💡Tips & Troubleshooting

• ⚡Meta Shops orders can come from both Facebook and Instagram — both funnel into the same Commerce account.
• ⚡Facebook OAuth tokens are long-lived but can expire or be revoked. Re-authorize if orders stop appearing.
• ⚡Product catalog sync (listing products to your Facebook Shop) is separate from order fulfillment — manage listings in Meta Commerce Manager or via the Pythias catalog publishing feature.