Перейти к основному содержимому

Сообщения, отображающие несколько товаров | Документация для разработчиков

Сообщения, содержащие информацию о нескольких товарах

Обновлено: 3 марта 2026 г
Многотоварные сообщения — это интерактивные сообщения, отображающие до 30 товаров из вашего каталога, сгруппированных по разделам. Клиенты могут просматривать товары, изучать подробную информацию, добавлять товары в корзину и отправлять заказы — всё это в WhatsApp.
Пример сообщения, содержащего информацию о нескольких товарах:
Меню активируется при нажатии пользователем кнопки «Начать покупки»:
Пример сообщения для нескольких товаров
Меню покупок активируется кнопкой «Начать покупки»

Обзор

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

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

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

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

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

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

            Сообщения, содержащие информацию о нескольких товарах, лучше всего подходят для простого и персонализированного пользовательского опыта, где целесообразнее направлять клиента к подмножеству наиболее релевантных для него товаров, а не заставлять его просматривать весь ассортимент.
            Простой и эффективный
            Сочетание этих функций с инструментами навигации, такими как обработка естественного языка (NLP), текстовый поиск или отображение списков сообщений и кнопок ответа, позволяет быстро найти то, что ищет клиент.
            Личное
            Заполняется динамически, поэтому может быть персонализировано под клиента или ситуацию. Например, можно показать сообщение с несколькими товарами, которые клиент заказывает чаще всего.
            Результаты бизнеса
            Высокоэффективный канал для привлечения заказов. В ходе тестирования компании показали средний показатель конверсии в 7% для сообщений, содержащих несколько товаров, которые были отправлены, и привели к получению корзины.
            Шаблонов нет
            Интерактивные сообщения не требуют шаблонов или предварительного согласования. Они генерируются в режиме реального времени и всегда будут отражать актуальную информацию о товаре, ценах и наличии на складе.

            Отправить сообщение, содержащее несколько товаров

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

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

              Для отправки сообщения, содержащего информацию о нескольких товарах, соберите интерактивный объект типа product_list , включающий следующие компоненты:
              Необходимые компоненты Дополнительные компоненты
                Объект заголовка — Тип заголовка должен быть установлен как текст. Не забудьте добавить текстовый объект с желаемым содержимым.Тело ОбъектОбъект действия — должен содержать catalog_id и sections.
                  Разделы должны представлять собой массив объектов, описывающих каждый раздел с помощью заголовков и элементов продукта.
                    Значение параметра product_items для каждого раздела должно представлять собой массив, описывающий каждый товар в разделе с использованием значения product_retailer_id и артикула товара (SKU).
                      Объект нижнего колонтитула
                      см. в разделе «Сообщения», «Интерактивный объект» . По завершении процесса интерактивный объект должен выглядеть примерно так:
                      

                      {
                      
"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: Добавьте общие параметры сообщения
                        Once the interactive object is complete, append the other parameters that make a message: тип_получателя, к, messaging_product, и тип. Remember to set the тип к интерактивный.
                        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": { // ИНТЕРАКТИВНЫЙ ОБЪЕКТ ЗДЕСЬ }'

                        For all available parameters, see Reference, Messages.
                        Шаг 3: Отправьте запрос на конечную точку сообщений
                        Отправьте POST-запрос на /PHONE_NUMBER_ID/messages endpoint with the JSON object you have assembled in steps 1 and 2. If your message is sent successfully, you get the following response:
                        { "messaging_product": "whatsapp", "contacts": [{ "input": "PHONE_NUMBER", "wa_id": "WHATSAPP_ID", }] "messages": [{ "id": "wamid.ID", }] }
                        
    
                                
                        
    
                        

            
                        
        
                        
    
                        

    
                        

    
    
                        
        
                        
             Вернуться наверх