Maytapi
Maytapi/Документация//catalog
/catalogДля номеров WhatsApp BusinessAPI каталога товаров WhatsApp
Управляйте каталогом товаров своего номера WhatsApp Business из собственной системы. Добавляйте товары и коллекции, отправляйте в чат один товар или весь каталог и получайте заказы клиентов, не выходя из кода.
- товары и коллекции
- сообщения с товаром
- сообщения с каталогом
- заказы на вебхук
Ваш каталог под управлением API
Держите каталог WhatsApp синхронизированным с магазином вместо ручного редактирования в приложении.
-
catalog/addProduct
Добавление и редактирование
Создавайте товары с названием, описанием, ценой, фото, ссылкой и retailer id; затем редактируйте или скрывайте.
-
catalog/getProducts
Список товаров
Получайте все товары каталога или один товар по id.
-
catalog/addCollection
Коллекции
Группируйте товары в коллекции, добавляйте и удаляйте товары из них.
-
type: product
Сообщение с товаром
Отправьте в чат карточку товара, чтобы клиент посмотрел и заказал его.
-
type: catalog
Сообщение с каталогом
Поделитесь всем каталогом с заголовком и описанием в одном сообщении.
-
catalog/getOrders
Заказы
Заказы из каталога приходят на ваш вебхук; последние можно также получить через API.
Синхронизация товаров из магазина
Передавайте товары из интернет-магазина в каталог WhatsApp по одному запросу на товар. Цены обновляются и закончившиеся товары скрываются так же.
- ✓Название, описание, цена и фото
- ✓Ссылка на товар и ваш retailer id
- ✓Скрыть товар, не удаляя его
curl -X POST "https://api.maytapi.com/api/$PID/$PHONE_ID/catalog/addProduct" \
-H "x-maytapi-key: $TOKEN" \
-H "Content-Type: application/json" \
-d '{
"name": "Classic sneaker",
"description": "Canvas sneaker, sizes 38–45",
"price": "49.90",
"imageUrl": "https://example.com/sneaker.jpg",
"url": "https://example.com/sneaker",
"retailerId": "SKU-1042",
"isHidden": false
}'curl "https://api.maytapi.com/api/$PID/$PHONE_ID/catalog/getProducts" \ -H "x-maytapi-key: $TOKEN"
curl "https://api.maytapi.com/api/$PID/$PHONE_ID/catalog/getCollections" \ -H "x-maytapi-key: $TOKEN"
Отправьте товар или весь каталог
Когда клиент спрашивает, отвечайте карточкой товара или всем каталогом — оба открываются нативно в WhatsApp.
- ✓type: product с id товара
- ✓type: catalog с необязательными заголовком и описанием
curl -X POST "https://api.maytapi.com/api/$PID/$PHONE_ID/sendMessage" \
-H "x-maytapi-key: $TOKEN" \
-H "Content-Type: application/json" \
-d '{
"to_number": "7916xxxxx67@c.us",
"type": "product",
"productId": "3121315354601301"
}'curl -X POST "https://api.maytapi.com/api/$PID/$PHONE_ID/sendMessage" \
-H "x-maytapi-key: $TOKEN" \
-H "Content-Type: application/json" \
-d '{
"to_number": "7916xxxxx67@c.us",
"type": "catalog",
"message": "Check out our products!",
"title": "Our catalog",
"description": "New arrivals every week"
}'Получайте заказы на вебхук
Когда клиент отправляет заказ из каталога, он приходит на вебхук как обычное сообщение. Сохраняйте его в своей базе данных — getOrders хранит только заказы, полученные, пока сессия запущена.
- ✓Заказы приходят в реальном времени
- ✓getOrders и getOrders/{orderId} для последних заказов
- ✓Храните заказы в своей системе для истории
curl "https://api.maytapi.com/api/$PID/$PHONE_ID/catalog/getOrders" \ -H "x-maytapi-key: $TOKEN"
curl "https://api.maytapi.com/api/$PID/$PHONE_ID/catalog/getOrders/$ORDER_ID" \ -H "x-maytapi-key: $TOKEN"
Кто использует API каталога
-
Интернет-магазины
Держите каталог WhatsApp идентичным сайту, включая цены.
-
Отделы продаж
Отвечайте на вопросы о товаре карточкой товара вместо длинного сообщения.
-
Агентства и SaaS
Управляйте каталогами множества клиентских номеров с одной платформы.
Вопросы о каталоге товаров
Задайте любой вопрос поддержке в WhatsApp. Среднее время ответа — меньше 24 часов.
Центр помощи →Нужен ли аккаунт WhatsApp Business?
Да. Каталог — функция WhatsApp Business, поэтому подключённый номер должен быть номером WhatsApp Business.
Хранит ли Maytapi заказы?
Заказы приходят на ваш вебхук в реальном времени. getOrders возвращает только заказы, полученные, пока сессия запущена, поэтому сохраняйте их в своей базе данных для постоянной истории.
Можно отправить в чат один товар?
Да. Отправьте сообщение с type product и id товара — клиент увидит нативную карточку товара.
Можно ли группировать товары?
Да. Создавайте коллекции и добавляйте или удаляйте товары через API.
Другие возможности WhatsApp API
Получите ключ и отправьте первое сообщение за десять минут
Без одобрения, без шаблонов, без карты. Все эндпоинты открыты на три дня.