CreateProduct#

Для работы с методом необходимо иметь WhatsApp* Business аккаунт.

Метод предназначен для создания продукта в каталоге.

Чтобы метод работал успешно, на телефоне должен быть предварительно создан хотя бы один каталог продуктов.

Ограничения со стороны WhatsApp*

WhatsApp* может временно ограничить доступ к Business Catalog API при частом обращении к методам каталогов.
Не выполняйте большое количество запросов к методам каталогов за короткий промежуток времени.

Запрос#

Для создания продукта в каталоге требуется выполнить запрос по адресу:

POST

{{apiUrl}}/waInstance{{idInstance}}/createProduct/{{apiTokenInstance}}

Для получения параметров запроса idInstance и apiTokenInstance обратитесь к разделу Перед началом работы.

Параметры запроса#

Параметр	Тип	Обязательный	Описание
`name`	string	Да	Название продукта
`countryCode`	string	Да	Код страны происхождения в формате ISO 3166-1 alpha-2 (например, RU)
`price`	string	Да	Цена (обычный формат, например "850" = 850 руб). Допускается дробная часть, например "99.90"
`imageUrl`	string	Да	Ссылка на изображение продукта. Должна начинаться с `http://` или `https://`
`currency`	string	Нет	Код валюты в формате ISO 4217 (например, RUB). Если не указан, определяется по `countryCode`
`retailerId`	string	Нет	Идентификатор продукта у продавца
`description`	string	Нет	Описание продукта
`url`	string	Нет	Ссылка на страницу продукта. Должна начинаться с `http://` или `https://`
`isHidden`	boolean	Нет	Скрыт ли продукт (по умолчанию false)

Пример тела запроса#

{
  "name": "Handmade Ceramic Mug",
  "countryCode": "RU",
  "price": "850",
  "imageUrl": "https://example.com/mug.jpg",
  "description": "Hand-painted ceramic mug, 350ml. Dishwasher safe.",
  "currency": "RUB",
  "retailerId": "12345",
  "url": "https://example.com",
  "isHidden": true
}

Ответ#

Поля ответа#

Поле	Тип	Описание
`productId`	string	Уникальный идентификатор созданного продукта в WhatsApp*.

Пример тела ответа#

{
    "productId": "26437451389197252"
}

Ошибки CreateProduct#

Перечень общих для всех методов ошибок смотрите в разделе Стандартные ошибки

Код HTTP	Идентификатор ошибки	Описание
400	`Catalog mutations require a business account`	Ограничение со стороны WhatsApp* при частом обращении к методам каталогов. Возвращается, даже если запрос выполняется от Business-аккаунта

Примеры кода#

PythoncURL

import requests
url = "{{apiUrl}}/waInstance{{idInstance}}/createProduct/{{apiTokenInstance}}" 
payload = {
    "name": "Handmade Ceramic Mug",
    "countryCode": "RU",
    "price": "850",
    "description": "Hand-painted ceramic mug, 350ml. Dishwasher safe.",
    "imageUrl": "https://example.com/mug.jpg",
    "currency": "RUB",
    "retailerId": "12345",
    "url": "https://example.com",
    "isHidden": True
}
headers = {
    'Content-Type': 'application/json'
}
response = requests.post(url, json=payload, headers=headers)
print(response.text.encode('utf8'))

curl --location '{{apiUrl}}/waInstance{{idInstance}}/createProduct/{{apiTokenInstance}}' \
--header 'Content-Type: application/json' \
--data-raw '{
    "name": "Handmade Ceramic Mug",
    "countryCode": "RU",
    "price": "850",
    "description": "Hand-painted ceramic mug, 350ml. Dishwasher safe.",
    "imageUrl": "https://example.com/mug.jpg",
    "currency": "RUB",
    "retailerId": "12345",
    "url": "https://example.com",
    "isHidden": true
}'