Перейти к содержанию

GetProducts#

Test Postman Apidog

Бета-версия

Функциональность находится в режиме бета-версии. Функции могут быть изменены, а также могут работать нестабильно.

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

Особенности работы метода

  • Метод работает без авторизации инстанса через публичный GraphQL WhatsApp*.
  • Если инстанс авторизован как бизнес-аккаунт – чтение происходит через Facebook GraphQL (видны товары на модерации или скрытые).
  • Если не авторизован – видны только одобренные товары.

Запрос#

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

POST 
{{baseUrl}}/waInstance{{idInstance}}/getProducts/{{apiTokenInstance}}

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

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

Параметр Тип Обязательный Описание
chatId string Да Идентификатор чата продавца в формате 79991234567@c.us

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

{
  "chatId": "79636191159@c.us"
}

Ответ#

Поля ответа#

Поле Тип Описание
id string Уникальный идентификатор продукта в WhatsApp
name string Название товара
description string Описание товара
price string Цена товара (в минимальных денежных единицах, например 85000 = 850.00 RUB)
currency string Код валюты (например, RUB)
retailer_id string/null Идентификатор товара у продавца
is_hidden boolean/null Скрыт ли товар
is_sanctioned boolean Находится ли товар под санкциями
product_availability string Доступность товара (IN_STOCK, OUT_OF_STOCK и т.д.)
max_available integer Максимальное доступное количество
status_info object Информация о статусе модерации (поле status: APPROVED, PENDING, REJECTED)
media object Медиафайлы товара (массивы images и videos)

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

[
  {
    "id": "26437451389197252",
    "retailer_id": null,
    "is_hidden": null,
    "is_sanctioned": false,
    "product_availability": "IN_STOCK",
    "max_available": 99,
    "name": "Handmade Ceramic Mug - Large+",
    "description": "Hand-painted ceramic mug, 450ml. Dishwasher safe. New larger size.",
    "url": null,
    "shimmed_url": null,
    "currency": "RUB",
    "price": "95000",
    "status_info": {
      "can_appeal": null,
      "status": "APPROVED"
    },
    "sale_price": null,
    "media": {
      "images": [
  {
    "id": "26756491040611445",
    "original_image_url": "https://mmg.whatsapp.net/...",
    "request_image_url": "https://mmg.whatsapp.net/..."
  }
  ],
  "videos": []
},
  "belongs_to": null,
  "compliance_category": null,
  "compliance_info": null,
  "variant_info": null
  }
]

Ошибки GetProducts#

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

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

import requests
url = "{{apiUrl}}/waInstance{{idInstance}}/getProducts/{{apiTokenInstance}}"
payload = {
    "chatId": "79636191159@c.us"
}
headers = {
    'Content-Type': 'application/json'
}
response = requests.post(url, json=payload, headers=headers)
print(response.text.encode('utf8'))

curl --location '{{apiUrl}}/waInstance{{idInstance}}/getProducts/{{apiTokenInstance}}' \
--header 'Content-Type: application/json' \
--data-raw '{
    "chatId": "79636191159@c.us"
}'

Внимание

  • Организация Meta, а также её продукты Instagram и Facebook, на которые мы ссылаемся в этой статье, признаны экстремистскими на территории РФ.

  • WhatsApp* принадлежит компании Meta Platforms Inc., деятельность которой признана экстремистской и запрещена на территории Российской Федерации. На основании решения Тверского районного суда г.Москвы от 21.03.2022 и требований ст. 10 ФЗ-114 в отношении компании Meta Platforms Inc.