Skip to main content

Documentation Index

Fetch the complete documentation index at: https://docs.digifist.com/llms.txt

Use this file to discover all available pages before exploring further.

A Meta Catalog is the product database that powers WhatsApp’s native commerce features — product cards, catalog browse, and the buy interface customers see when they tap a product in a WhatsApp message. Galantis connects to Meta Catalog to push your Shopify product data into WhatsApp, keeping the two systems in sync automatically. Connecting a Meta Catalog is required before any SPM, MPM, or Whole Catalog message format can be used. Without it, product-based templates cannot be activated.

​
What this covers

  • The three Meta Catalog flows available in Galantis
  • How to connect or create a catalog
  • How ongoing automatic sync works
  • Per-product sync status tracking
  • Error handling and recovery

​
Three catalog flows

Galantis supports three paths for connecting your product data to Meta, depending on whether you already have a Meta Catalog configured.
Import an existing Meta Catalog — connect a catalog you have already configured in Meta Commerce Manager and sync it into Galantis.Use this flow if:
  • You already have a Meta Catalog set up and populated in Meta Commerce Manager
  • You are migrating to Galantis from another tool that managed your Meta Catalog
  • You want Galantis to manage sync going forward but the catalog structure already exists
How it works:
1

Connect your Meta Catalog token

In Galantis, go to Settings → WhatsApp Connection and connect a Meta Catalog access token. This token is obtained from Meta Business Manager and grants Galantis permission to read and write to your catalog.
2

Select the catalog to import

Galantis fetches your available Meta Catalogs and lets you select which one to connect.
3

Import catalog data

Galantis imports the existing catalog structure and product data into Galantis records, reconciling them with your synced Shopify products.
4

Enable ongoing sync

Once imported, Galantis manages ongoing sync between Shopify product updates and the connected Meta Catalog via SyncMetaCatalogJob.
After importing, Galantis becomes the source of truth for catalog updates — it pushes changes from Shopify to Meta. Direct edits in Meta Commerce Manager will be overwritten the next time SyncMetaCatalogJob runs with updated Shopify data.

​
Per-product Meta sync status

Every product in Galantis has a Meta sync status that reflects its current state in the push pipeline:
StatusDescription
PENDINGQueued for Meta upload — not yet pushed
SYNCEDSuccessfully pushed to Meta — product is live in the catalog
FAILEDSync error — the product was not pushed to Meta; review error details
Status is visible per product in Catalog → [Product Name]. The overall catalog health view in Catalog shows aggregate counts across all three statuses. See Catalog Health for how to interpret and act on these statuses.

​
Meta Catalog access token

Connecting a Meta Catalog requires a catalog access token from Meta Business Manager. This token:
  • Must have permissions to read and write to the target catalog
  • Is stored encrypted per tenant in Galantis
  • Can expire or be revoked if permissions change in Meta Business Manager
If catalog sync stops working or FAILED statuses appear unexpectedly across many products simultaneously, the first diagnostic step is to verify the Meta Catalog token is still valid under Settings → WhatsApp Connection. A revoked or expired token will cause all Meta push attempts to fail until the token is refreshed.
If your Meta Catalog access token expires, SyncMetaCatalogJob will fail silently for all products until the token is renewed. Product data in Meta will become stale — prices, availability, and images will not reflect Shopify changes. Monitor catalog health periodically to catch token expiry issues early. See Catalog Health.