2chat-whatsapp-catalog

name	2chat-whatsapp-catalog
description	Use this skill when the user wants to manage a WhatsApp Business product catalog via the 2Chat API — list, add, edit, or delete products and collections, manage product images. Trigger phrases include "list products", "add product to catalog", "edit product", "delete product", "product image", "list collections", "create collection", "WhatsApp catalog".

2Chat — WhatsApp Catalog

Manage WhatsApp Business product catalogs and collections via the 2Chat API.

Requires the free version of WhatsApp Business. Does not require a WhatsApp Business API (WABA) account.

Authentication

All requests require the header:

X-User-API-Key: <api_key>

API keys are generated at app.2chat.io/developers. Base URL: https://api.p.2chat.io/open

---

Products

List products

GET /whatsapp/catalog/products?from_number={your_number}

To list products from another WhatsApp Business account:

GET /whatsapp/catalog/products/{target_number}?from_number={your_number}

Returns products with id, name, description, price, currency, availability, images, approval_status (PENDING, OUTDATED, REJECTED, APPROVED).

Add product

POST /whatsapp/catalog/product

{
  "from_number": "[phone]",
  "product": {
    "name": "Cool T-Shirt",
    "image_url": "https://example.com/tshirt.jpg",
    "description": "A very cool t-shirt",
    "price": "29.99",
    "currency": "USD",
    "is_hidden": false,
    "url": "https://mystore.com/tshirt",
    "retailer_id": "SKU-001"
  }
}

name and image_url are required. Currency defaults to the number's country currency. At least one product must already exist in the catalog. WhatsApp verification takes minutes to hours.

Edit product

PUT /whatsapp/catalog/product/{product_id}

{
  "from_number": "[phone]",
  "product": {
    "name": "Updated T-Shirt",
    "image_url": "https://example.com/new-tshirt.jpg",
    "description": "Updated description",
    "price": "34.99",
    "is_hidden": false,
    "url": "https://mystore.com/tshirt",
    "retailer_id": "SKU-001"
  }
}

name and image_url cannot be set to null. Edits undergo WhatsApp verification.

Delete product

DELETE /whatsapp/catalog/product/{product_id}

{ "from_number": "[phone]" }

Add product images

POST /whatsapp/catalog/product/image/{product_id}

{
  "from_number": "[phone]",
  "product": {
    "image_urls": [
      "https://example.com/image1.png",
      "https://example.com/image2.png"
    ]
  }
}

Max 2 image URLs per request. Does not replace the default product image.

Delete product image

DELETE /whatsapp/catalog/product/image/{product_id}/{image_index}

{ "from_number": "[phone]" }

image_index is zero-based. The default product image cannot be deleted.

---

Collections

List collections

GET /whatsapp/catalog/collections?from_number={your_number}

To list collections from another account:

GET /whatsapp/catalog/collections/{target_number}?from_number={your_number}

Returns collections with id, name, approval_status, and nested products.

Add collection

POST /whatsapp/catalog/collection

{
  "from_number": "[phone]",
  "collection": {
    "name": "Shoes",
    "product_ids": ["9846351425439378"]
  }
}

Collection names cannot be changed after creation — delete and recreate instead. Product IDs come from the list products endpoint.

Edit collection

PUT /whatsapp/catalog/collection/{collection_id}

{
  "from_number": "[phone]",
  "collection": {
    "remove_product_ids": ["product_id_1"],
    "add_product_ids": ["product_id_3"]
  }
}

The collection ID changes every time you edit it — update subsequent requests with the new ID.

Delete collection

DELETE /whatsapp/catalog/collection/{collection_id}

{ "from_number": "[phone]" }