> For the complete documentation index, see [llms.txt](https://help.1msg.io/docs/llms.txt). Markdown versions of documentation pages are available by appending `.md` to page URLs; this page is available as [Markdown](https://help.1msg.io/docs/russkii/api-1msg/shablony-waba/shablon-katalog.md).

# Шаблон Каталог

Шаблон Каталог - это маркетинговый шаблон, который позволяет представить полный каталог продукции. Ваш каталог товаров будет доступен для просмотра клиентам прямо в WhatsApp.

<figure><img src="https://1775018921-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2FoCNwQHK1ya1FkEe495Vr%2Fuploads%2FTq6YB38jwJnL351Oqa0E%2Fimage.png?alt=media&amp;token=be3bcf72-fbb7-4327-9ea8-847a4e150836" alt=""><figcaption></figcaption></figure>

Шаблоны каталога отображают изображение миниатюру одного товара и основной текст, а также фиксированный текстовый заголовок и подзаголовок.

**Требования:**

У вас должен быть загружен каталог в Meta в Commerce Manager, подключенном к вашей учетной записи WhatsApp Business. Можно создавать несколько каталогов, но **важно** —  активным выставить один каталог, который будет отображаться в WhatsApp.&#x20;

Проверить активность каталога можно также в личном кабинете 360Dialog либо вызвав у нас метод /commerce.&#x20;

## Создание шаблона "Каталог"

Создание шаблона описано[ в документации API ](https://1msg-docs.web.app/ru#tag/Shablony/operation/addTemplate)в методе /addTemplate.

Шаблон Каталог:

* Шаблон не предусматривает использование объекта HEADER.&#x20;
* Для кнопки каталога нужно указать type - "CATALOG". Текст кнопки нельзя менять,  должен быть прописан как "View catalog". Пользователь в WhatsApp получит перевод в соответствии со своей страной.

<details>

<summary>Пример создания шаблона "Каталог"</summary>

```json
POST https://api.1msg.io/{{channel}}/addTemplate
Content-Type: application/json
Body: {
  "token": "{{token}}",
  "name": "catalog_create_test",
  "allow_category_change": true,
  "category": "MARKETING",
  "language": "en",
  "components": [
    {
      "text": "Check out all of {{1}}. Go!",
      "type": "BODY",
      "example": {
        "body_text": [
          [
            "our services" // Переменная BODY {{1}} 
          ]
        ]
      }
    },
    {
      "type": "BUTTONS",
      "buttons": [
        {
          "type": "CATALOG",
          "text": "View catalog"
        }
      ]
    },
    {
      "type": "FOOTER",
      "text": "Catalog 1MSG"
    }
  ]
}
```

</details>

## Отправить шаблон "Каталог" <a href="#kak-otpravit-shablon-katalog" id="kak-otpravit-shablon-katalog"></a>

Отправка шаблона описана [ в документации API ](https://1msg-docs.web.app/ru#tag/Shablony/operation/sendTemplate)в методе /addTemplate.

Прежде чем отправить каталог, проверьте, включен ли он у вас. Проверить вы можете в своем личном кабинете в 360 Dialog либо вызвав метод /commerce.

Шаблон Каталог:

* В объекте кнопки в sub\_type необходимо написать CATALOG . Наименование кнопки не управляется.
* Можно записать в thumbnail\_product\_retailer\_id артикул товара, который указан в Meta. В этом случае миниатюра этого товара будет использоваться в качестве изображения заголовка сообщения. Иначе будет использоваться изображение продукта первого товара в вашем каталоге.

Пример части кода, когда не указан thumbnail\_product\_retailer\_id.

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

<details>

<summary>Пример отправки шаблона "Каталог"</summary>

Так как шаблон не содержал в type "BODY" описания переменных, то при отправке в теле сообщения этот объект опушен.&#x20;

```json
POST https://api.1msg.io/{{channel}}/sendTemplate
Content-Type: application/json
Body: {
  "token": "{{token}}",
  "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" // Отправится миниатюра данного товара. Можно отправить "thumbnail_product_retailer_id": "". Тогда будет использоваться изображение продукта первого товара в вашем каталоге.
        }
      ]
    }
  ],
  "phone": "+556123122026"
}
        
```

</details>