Catalog template

Catalog templates are marketing templates that allow you to fully present your product Catalog. Your product catalog will be available for customers to view directly in WhatsApp.

Catalog Templates display a thumbnail image of the product header and a custom main text, as well as a fixed text header and a sub-header.

Requirements:

You must have inventory uploaded to Meta in an ecommerce catalog connected to your WhatsApp Business Account. You can create multiple catalogues, but it's important - set one catalogue to be active, which will be displayed in WhatsApp.

Creating a template

Creating a template is described in the API documentation in the /addTemplate method.

You can also create a template from the 'Dev Toolkit' → 'Test requests' section of your personal cabinet. The example below was created using this section. Don't forget to specify examples of variables if you have added them to the body, link URL of buttons. Otherwise the template will be rejected by Meta*.

Catalog template:

• The template does not provide for the use of a HEADER object.

• For the catalogue button, the type must be specified as 'CATALOG'. The text of the button cannot be changed, must be specified as ‘View catalogue’. The user in WhatsApp will receive a translation according to their country.

Send a Catalog template

Before you send a catalogue, check if you have it enabled. You can check in your personal account in 360 Dialog, or by calling the /commerce method.

Catalogue template:

• In the button object, you need to write CATALOG in sub_type . The name of the button is not controllable.

• In thumbnail_product_retailer_id you can write the article of the product specified in Meta. In this case, the thumbnail of this product will be used as the header image of the post. Otherwise, the product image of the first product in your catalogue will be used.

Example code part when no thumbnail_product_retailer_id is specified.

 {
      "type": "button",
      "sub_type": "CATALOG",
      "index": 0,
      "parameters": [
        {
          "type": "action",
          "action": {
            "thumbnail_product_retailer_id": ""
          }
        }
      ]
    }

Example of sending the ‘Catalog’ template

Because the template did not contain a variable description in the text, object with type "BODY" is omitted when it is sent.

POST https://api.1msg.io/{{channel}}/sendTemplate
Content-Type: application/json
Body: {
  "namespace": "{{namespace}}",
  "template": "catalog_services",
  "language": {
    "policy": "deterministic",
    "code": "en"
  },
  "params": [
    {
      "type": "button",
      "sub_type": "CATALOG",
      "index": 0,
      "parameters": [
        {
          "type": "action",
          "action": {
            "thumbnail_product_retailer_id": "0002" // A thumbnail of this product will be sent. You can send 'thumbnail_product_retailer_id': ''. The product image of the first product in your catalogue will be used.
        }
      ]
    }
  ],
  "phone": "[phone]"
}