Сообщения, отображающие несколько товаров | Документация для разработчиков
Сообщения, содержащие информацию о нескольких товарах
Обновлено: 3 марта 2026 г
Многотоварные сообщения — это интерактивные сообщения, отображающие до 30 товаров из вашего каталога, сгруппированных по разделам. Клиенты могут просматривать товары, изучать подробную информацию, добавлять товары в корзину и отправлять заказы — всё это в WhatsApp.
Пример сообщения, содержащего информацию о нескольких товарах:
Меню активируется при нажатии пользователем кнопки «Начать покупки»:
Обзор
Клиенты, получающие сообщения, содержащие информацию о нескольких продуктах, могут выполнить 3 основных действия:
Если к учетной записи вашего клиента подключено несколько устройств, сообщения, относящиеся к нескольким товарам, будут синхронизироваться между устройствами. Однако корзина покупок остается локальной для каждого конкретного устройства. Подробнее разделе «Работа с корзиной покупок»
В настоящее время сообщения, содержащие информацию о нескольких товарах, можно получать на следующих платформах:
Если версия приложения клиента не поддерживает отправку сообщений нескольким продуктам, он получит сообщение с объяснением, что не смог получить сообщение, поскольку использует устаревшую версию WhatsApp. Вы также получите уведомление через веб-перехватчик, указывающее на то, что сообщение не было доставлено из-за использования клиентом устаревшей версии WhatsApp.
Ожидаемое поведение
Сообщения, содержащие информацию о нескольких товарах, могут быть следующими:
Сообщения, содержащие информацию о нескольких товарах, не могут быть:
Варианты использования
Сообщения, содержащие информацию о нескольких товарах, лучше всего подходят для того, чтобы направить покупателей к определенному подмножеству вашего ассортимента, например:
Сообщения, содержащие информацию о нескольких товарах, также могут использоваться в рамках рабочего процесса оператора. Однако для этого необходимо разработать инструменты, позволяющие оператору генерировать такие сообщения в отдельном потоке.
Почему вам следует их использовать
Сообщения, содержащие информацию о нескольких товарах, лучше всего подходят для простого и персонализированного пользовательского опыта, где целесообразнее направлять клиента к подмножеству наиболее релевантных для него товаров, а не заставлять его просматривать весь ассортимент.
Простой и эффективный
Сочетание этих функций с инструментами навигации, такими как обработка естественного языка (NLP), текстовый поиск или отображение списков сообщений и кнопок ответа, позволяет быстро найти то, что ищет клиент.
Личное
Заполняется динамически, поэтому может быть персонализировано под клиента или ситуацию. Например, можно показать сообщение с несколькими товарами, которые клиент заказывает чаще всего.
Результаты бизнеса
Высокоэффективный канал для привлечения заказов. В ходе тестирования компании показали средний показатель конверсии в 7% для сообщений, содержащих несколько товаров, которые были отправлены, и привели к получению корзины.
Шаблонов нет
Интерактивные сообщения не требуют шаблонов или предварительного согласования. Они генерируются в режиме реального времени и всегда будут отражать актуальную информацию о товаре, ценах и наличии на складе.
Отправить сообщение, содержащее несколько товаров
Перед отправкой сообщений о товарах выполните следующие действия для начала работы, наиболее подходящие для ваших потребностей:
Все вызовы API, упомянутые в этом руководстве, должны быть аутентифицированы с помощью токена доступа. Вы можете аутентифицировать свои вызовы API с помощью токена доступа, сгенерированного в «Панель управления приложениями» > «WhatsApp» > «Настройка API» . Если вы являетесь поставщиком решений, вы должны аутентифицироваться с помощью токена доступа с whatsapp_business_messaging .
Шаг 1: Соберите интерактивный объект
Для отправки сообщения, содержащего информацию о нескольких товарах, соберите
интерактивный объект типа product_list , включающий следующие компоненты:| Необходимые компоненты | Дополнительные компоненты |
|---|---|
см. в разделе «Сообщения», «Интерактивный объект» . По завершении процесса интерактивный объект должен выглядеть примерно так:
{ "messaging_product": "whatsapp", "recipient_type": "individual", "to": "PHONE_NUMBER", "type": "interactive", "interactive": { "type": "product_list", "header":{ "type": "text", "text": "HEADER_CONTENT" }, "body": { "text": "BODY_CONTENT" }, "footer": { "text": "FOOTER_CONTENT" }, "action": { "catalog_id": "CATALOG_ID", "sections": [ { "title": "SECTION_TITLE", "product_items": [ { "product_retailer_id": "PRODUCT-SKU" }, { "product_retailer_id": "PRODUCT-SKU" }, ... ] }, { "title": "SECTION_TITLE", "product_items": [ { "product_retailer_id": "PRODUCT-SKU" }, { "product_retailer_id": "PRODUCT-SKU" }, ... ] } ] } } }Отсутствующие предметы
Если ни один из элементов, указанных в вызове 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", }] }