Сообщения для отдельных продуктов | Документация для разработчиков

Сообщения, относящиеся к одному продукту

Обновлено: 3 марта 2026 г

Сообщения с описанием одного товара — это интерактивные сообщения, отображающие один товар из вашего каталога, позволяющие покупателям просмотреть подробную информацию о товаре, добавить его в корзину и оформить заказ — и все это в WhatsApp.

Пример сообщения для одного продукта:

Пример страницы с подробным описанием товара:

Обзор

Клиенты, получающие сообщения, посвященные одному продукту, могут выполнить 3 основных действия:

Просмотр товара: При каждом клике покупателя на товар загружается актуальная информация о товаре, и он отображается в формате страницы с подробным описанием товара (PDP). В настоящее время PDP поддерживают только изображения товаров — любые видео или GIF-файлы, добавленные к товару, не будут отображаться на PDP.Добавление товара в корзину: Каждый раз, когда пользователь добавляет товар в корзину, загружается актуальная информация о товаре. Если произошло изменение состояния, отображается диалоговое окно с сообщением «Один или несколько товаров в вашей корзине были обновлены» — см. раздел « Обновления товаров для получения дополнительной информации. Корзина сохраняется в чате между вами и вашим клиентом до тех пор, пока корзина не будет отправлена вам — см. раздел « Работа с корзиной покупок для получения более подробной информации.Отправка корзины покупок вам: После добавления товаров покупатели могут отправить вам свою корзину. После этого вы можете определить дальнейшие шаги, такие как запрос информации о доставке или предоставление вариантов оплаты.

Если к учетной записи вашего клиента подключено несколько устройств, сообщения по одному товару будут синхронизироваться между устройствами. Однако корзина покупок остается локальной для каждого конкретного устройства. Подробнее разделе «Работа с корзиной покупок»

В настоящее время сообщения, касающиеся отдельных продуктов, можно получать на следующих платформах:

iOS: 2.21.210Android: 2.21.19Веб-версия: Веб-клиент поддерживает эту функцию.

Если версия приложения клиента не поддерживает сообщения для отдельных продуктов, он получит сообщение с объяснением, что не смог получить сообщение, поскольку использует устаревшую версию WhatsApp. Вы также получите уведомление через веб-перехватчик, указывающее на то, что сообщение не было доставлено из-за использования клиентом устаревшей версии WhatsApp.

Ожидаемое поведение

Сообщения, посвященные одному продукту, могут быть следующими:

Переслано одним пользователем другому.Пользователь повторно открыл этот вопрос в рамках той же ветки чата.

Сообщения, относящиеся к одному товару, не могут быть:

Отправляется в виде уведомлений. Отправка возможна только в рамках существующих чатов.

Варианты использования

Сообщения, ориентированные на один товар, лучше всего подходят для того, чтобы направить покупателей к конкретному товару из вашего ассортимента, предлагая быстрые ответы с ограниченным набором вариантов, таких как:

Ответ на конкретный запрос клиента.Предоставление рекомендации.Повторный заказ ранее приобретенного товара.

Сообщения, содержащие информацию об одном продукте, также могут использоваться в рамках рабочего процесса оператора. Однако для этого необходимо разработать инструменты, позволяющие оператору генерировать такие сообщения в отдельном потоке.

Почему вам следует их использовать

Сообщения, ориентированные на конкретный товар, лучше всего подходят для простого и персонализированного пользовательского опыта, где удобнее направлять клиента к конкретному товару, наиболее подходящему для него, чем заставлять его просматривать весь ассортимент.

Шаблонов нет

Интерактивные сообщения не требуют шаблонов или предварительного согласования. Они генерируются в режиме реального времени и всегда будут отражать актуальную информацию о товаре, ценах и наличии на складе.

Отправить сообщение об одном товаре

Перед отправкой сообщений о товарах выполните следующие действия для начала работы, наиболее подходящие для ваших потребностей:

Непосредственные разработчикиПоставщики решений

Все вызовы API, упомянутые в этом руководстве, должны быть аутентифицированы с помощью токена доступа. Вы можете аутентифицировать свои вызовы API с помощью токена доступа, сгенерированного в «Панель управления приложениями» > «WhatsApp» > «Настройка API» . Если вы являетесь поставщиком решений, вы должны аутентифицироваться с помощью токена доступа с whatsapp_business_messaging .

Шаг 1: Соберите интерактивный объект

Для отправки сообщения, содержащего информацию об одном продукте, соберите интерактивный объект типа «продукт» , состоящий из следующих компонентов:

Необходимые компоненты	Дополнительные компоненты
Объект действия — должен содержать как catalog_id, так и product_retailer_id.	Тело ОбъектОбъект нижнего колонтитула

см. в разделе «Сообщения», «Интерактивный объект» . По завершении процесса интерактивный объект должен выглядеть примерно так:

Если ни один из элементов, указанных в вызове API, не соответствует товару из вашего каталога, отправляется сообщение об ошибке, и сообщение об одном товаре не отправляется пользователю.