Сообщения для отдельных продуктов | Документация для разработчиков
Сообщения, относящиеся к одному продукту
Обновлено: 3 марта 2026 г
Сообщения с описанием одного товара — это интерактивные сообщения, отображающие один товар из вашего каталога, позволяющие покупателям просмотреть подробную информацию о товаре, добавить его в корзину и оформить заказ — и все это в WhatsApp.
Пример сообщения для одного продукта:
Пример страницы с подробным описанием товара:
Обзор
Клиенты, получающие сообщения, посвященные одному продукту, могут выполнить 3 основных действия:
Если к учетной записи вашего клиента подключено несколько устройств, сообщения по одному товару будут синхронизироваться между устройствами. Однако корзина покупок остается локальной для каждого конкретного устройства. Подробнее разделе «Работа с корзиной покупок»
В настоящее время сообщения, касающиеся отдельных продуктов, можно получать на следующих платформах:
Если версия приложения клиента не поддерживает сообщения для отдельных продуктов, он получит сообщение с объяснением, что не смог получить сообщение, поскольку использует устаревшую версию WhatsApp. Вы также получите уведомление через веб-перехватчик, указывающее на то, что сообщение не было доставлено из-за использования клиентом устаревшей версии WhatsApp.
Ожидаемое поведение
Сообщения, посвященные одному продукту, могут быть следующими:
Сообщения, относящиеся к одному товару, не могут быть:
Варианты использования
Сообщения, ориентированные на один товар, лучше всего подходят для того, чтобы направить покупателей к конкретному товару из вашего ассортимента, предлагая быстрые ответы с ограниченным набором вариантов, таких как:
Сообщения, содержащие информацию об одном продукте, также могут использоваться в рамках рабочего процесса оператора. Однако для этого необходимо разработать инструменты, позволяющие оператору генерировать такие сообщения в отдельном потоке.
Почему вам следует их использовать
Сообщения, ориентированные на конкретный товар, лучше всего подходят для простого и персонализированного пользовательского опыта, где удобнее направлять клиента к конкретному товару, наиболее подходящему для него, чем заставлять его просматривать весь ассортимент.
Шаблонов нет
Интерактивные сообщения не требуют шаблонов или предварительного согласования. Они генерируются в режиме реального времени и всегда будут отражать актуальную информацию о товаре, ценах и наличии на складе.
Отправить сообщение об одном товаре
Перед отправкой сообщений о товарах выполните следующие действия для начала работы, наиболее подходящие для ваших потребностей:
Все вызовы API, упомянутые в этом руководстве, должны быть аутентифицированы с помощью токена доступа. Вы можете аутентифицировать свои вызовы API с помощью токена доступа, сгенерированного в «Панель управления приложениями» > «WhatsApp» > «Настройка API» . Если вы являетесь поставщиком решений, вы должны аутентифицироваться с помощью токена доступа с whatsapp_business_messaging .
Шаг 1: Соберите интерактивный объект
Для отправки сообщения, содержащего информацию об одном продукте, соберите
интерактивный объект типа «продукт» , состоящий из следующих компонентов:| Необходимые компоненты | Дополнительные компоненты |
|---|---|
см. в разделе «Сообщения», «Интерактивный объект» . По завершении процесса интерактивный объект должен выглядеть примерно так:
{ "messaging_product": "whatsapp", "recipient_type": "individual", "to": "PHONE_NUMBER", "type": "interactive", "interactive": { "type": "product", "body": { "text": "BODY_TEXT" }, "footer": { "text": "FOOTER_TEXT" }, "action": { "catalog_id": "CATALOG_ID", "product_retailer_id": "ID_TEST_ITEM_1" } } }Если ни один из элементов, указанных в вызове API, не соответствует товару из вашего каталога, отправляется сообщение об ошибке, и сообщение об одном товаре не отправляется пользователю.
Шаг 2: Добавьте общие параметры сообщения
После завершения создания интерактивного объекта добавьте остальные параметры, формирующие сообщение:
recipient_type , to , messaging_product и type . Не забудьте установить тип как interactive .curl -X POST https://graph.facebook.com/v25.0/FROM_PHONE_NUMBER/messages \ -H 'Authorization: Bearer ACCESS_TOKEN' \ - d '{ "messaging_product": "whatsapp", "recipient_type": "individual", "to": "PHONE_NUMBER", "type": "interactive", "interactive": { // ИНТЕРАКТИВНЫЙ ОБЪЕКТ ЗДЕСЬ }'
Для получения информации обо всех доступных параметрах см. Справочник, Сообщения .
Шаг 3: Отправьте запрос на конечную точку сообщений
Отправьте POST-запрос на
/PHONE_NUMBER_ID/messages , используя JSON-объект, собранный вами на шагах 1 и 2. Если ваше сообщение будет отправлено успешно, вы получите следующий ответ:{ "messaging_product": "whatsapp", "contacts": [{ "input": "PHONE_NUMBER", "wa_id": "WHATSAPP_ID", }] "messages": [{ "id": "wamid.ID", }] }