> 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="/files/zqMkWzEaV7u5qhiGvT0s" 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>


---

# Agent Instructions
This documentation is published with GitBook. GitBook is the documentation platform designed so that both humans and AI agents can read, navigate, and reason over technical content effectively. Learn more at gitbook.com.

## Querying This Documentation
If you need additional information that is not directly available in this page, you can query the documentation dynamically by asking a question.

Perform an HTTP GET request on the current page URL with the `ask` query parameter, and the optional `goal` query parameter:

```
GET https://help.1msg.io/docs/russkii/api-1msg/shablony-waba/shablon-katalog.md?ask=<question>&goal=<endgoal>
```

`ask` is the immediate question: it should be specific, self-contained, and written in natural language.
`goal` is optional and describes the broader end goal you are ultimately trying to accomplish on behalf of the user. GitBook uses it to tailor the answer towards what is most useful for that goal.

The response will contain a direct answer to the question and relevant excerpts and sources from the documentation.

Use this mechanism when the answer is not explicitly present in the current page, you need clarification or additional context, or you want to retrieve related documentation sections.