Catalog sync

Your platform stays the source of truth: nobody edits products in Nexafon. Whenever a product, price, image, size or stock changes on your side, push it; Nexafon keeps its copy and mirrors it into the store’s WhatsApp catalog, usually within a minute.

Products

partner.ts

// Your platform stays the source of truth: push each change, Nexafon mirrors it into the store's WhatsApp catalog.
export async function syncProducts(workspaceId: string) {
  const store = nexafon.store(workspaceId)
  await store.categories.upsert([{ externalId: 'shoes', name: 'Shoes' }])
  await store.products.batch([
    {
      externalId: 'sneaker-1',
      name: 'Runner sneaker',
      categoryExternalId: 'shoes',
      priceCents: 2700,
      imageUrls: ['https://cdn.example.com/sneaker-1.jpg'],
      variants: [
        { externalId: 'sneaker-1-42', size: '42', stock: 5 },
        { externalId: 'sneaker-1-43', size: '43', stock: 0, availability: 'out_of_stock' },
      ],
    },
  ])
}

Operation
PUT /api/v1/workspaces/{workspaceId}/commerce/products/{externalId}	Create or update one product (idempotent by your externalId)
POST …/commerce/products/batch	Up to 500 products in one call; results come back in the same order
DELETE …/commerce/products/{externalId}	Remove it, also from WhatsApp
GET …/commerce/products	The products with their WhatsApp review status
PUT …/commerce/categories	Create or update categories (externalId, name), in their display order
GET …/commerce/categories	The categories

A product has a name, description, category, 1 to 10 image URLs, priceCents, an optional sale price with a start and end, availability and stock, and optional variants (size, colour, each with its own price and stock). Each variant, or the product itself when it has none, is one item in WhatsApp, identified by its externalId as WhatsApp’s retailer_id (retailer_id_taken when another product already uses it).

Images are your own public HTTPS URLs; WhatsApp fetches them and Nexafon does not host them. Private or internal addresses are refused. The number of products is limited by the plan’s commerce.products.max (plan_limit_reached).

WhatsApp’s review

Meta reviews each item. The products list shows each one’s status, and a catalog.product_status webhook reports every decision: approved, or rejected with Meta’s reason. Only approved items appear in the Shop.

Nexafon also reconciles the whole catalog nightly, so a missed update corrects itself. The store’s Products screen in the embed shows the same list, read-only.