Платформа WhatsApp Business > Облачный API > Руководства

Предоставление клиентам информации о товарах

Существует несколько способа предоставить клиентам информацию о товарах:

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

Сообщения с каталогом

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

В сообщениях с каталогом отображается выбранная вами миниатюра в качестве изображения заголовка, настраиваемый текст тела, фиксированный текстовый заголовок, фиксированный текстовый подзаголовок и кнопка Просмотр каталога.

Когда клиент нажимает кнопку Просмотр каталога, ваш каталог товаров отображается в WhatsApp.

Требования

Ваш ассортимент должен быть загружен в Meta в каталог электронной коммерции, связанный с вашим аккаунтом WhatsApp Business.

Синтаксис запроса

Чтобы отправлять сообщения с каталогом, используйте конечную точку Номер телефона WhatsApp Business > Сообщения.

POST /<WHATSAPP_BUSINESS_PHONE_NUMBER_ID>/messages

Тело публикации

{
  "messaging_product": "whatsapp",
  "recipient_type": "individual",
  "to": "<TO>",
  "type": "interactive",
  "interactive" : {
    "type" : "catalog_message",
    "body" : {
      "text": "<BODY_TEXT>"
    },
    "action": {
      "name": "catalog_message",
      
      /* Parameters object is optional */
      "parameters": {
        "thumbnail_product_retailer_id": "<THUMBNAIL_PRODUCT_RETAILER_ID>"
      }
    },

    /* Footer object is optional */
    "footer": {
      "text": "<FOOTER_TEXT>"
  }
}

Свойства

Заполнитель	Описание	Пример значения
`<BODY_TEXT>` Строка	Обязательный параметр. Текст, который будет отображаться в теле сообщения. Максимальное количество символов: 1 024.	`Hello! Thanks for your interest. Ordering is easy. Just visit our catalog and add items to purchase.`
`<FOOTER_TEXT>` Строка	Необязательный параметр. Текст, который будет отображаться в нижнем колонтитуле сообщения. Максимальное количество символов: 60.	`Best grocery deals on WhatsApp!`
`<THUMBNAIL_PRODUCT_RETAILER_ID>` Строка	Необязательный параметр. Номер артикула товара. Отмечается в Commerce Manager как ID контента. В качестве изображения заголовка в этом сообщения будет использоваться миниатюра этого товара. Если объект `parameters` отсутствует, будет использоваться изображение товара первого элемента каталога.	`2lc20305pt`
`<TO>` Строка	Номер телефона клиента.	`+16505551234`

Пример запроса

curl 'https://graph.facebook.com/v17.0/106540352242922/messages' \
-H 'Content-Type: application/json' \
-H 'Authorization: Bearer EAAJB...' \
-d '
{
  "messaging_product": "whatsapp",
  "recipient_type": "individual",
  "to": "+16505551234",
  "type": "interactive",
  "interactive": {
    "type": "catalog_message",
    "body": {
      "text": "Hello! Thanks for your interest. Ordering is easy. Just visit our catalog and add items to purchase."
    },
    "action": {
      "name": "catalog_message",
      "parameters": {
        "thumbnail_product_retailer_id": "2lc20305pt"
      }
    },
    "footer": {
      "text": "Best grocery deals on WhatsApp!"
    }
  }
}'

Пример ответа

{
  "messaging_product": "whatsapp",
  "contacts": [
    {
      "input": "+16505551234",
      "wa_id": "16505551234"
    }
  ],
  "messages": [
    {
      "id": "wamid.HBgLMTY1MDM4Nzk0MzkVAgARGBI0ODVEREUwQzEzQkVBRjQ1RUUA"
    }
  ]
}

Шаблоны сообщений с каталогом

Шаблоны сообщений с каталогом — это шаблоны сообщений, содержащие кнопку, при нажатии которой открывается ваш каталог товаров в WhatsApp.

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

Сообщения со ссылками на каталог товаров

Чтобы отправить ссылку на весь каталог своих товаров, вы можете создать ссылку wa.me и добавить ее в стандартное текстовое сообщение. При отправке текстового сообщения вы можете использовать необязательный параметр preview_url со значением true, чтобы в сообщении отображался набор миниатюр каталога продукции для любого URL-адреса в строке сообщения body.

Обратите внимание: если вы отключите каталог, то при нажатии ссылки wa.me и кнопки Просмотр каталога в сообщениях со ссылками на каталог появится сообщение Недействительная ссылка на каталог.

Чтобы создать ссылку wa.me, добавьте рабочий номер телефона компании, включая код страны, в конец следующей строки:

https://wa.me/c/

Пример:

https://wa.me/c/15555455657

Сообщения о товарах

Сообщения об одном или нескольких товарах являются сообщениями типа interactive.

Пример сообщения о нескольких товарах:	Пример сообщения об одном товаре:

Меню, которое открывается, когда пользователь нажимает "Начать покупки":	Пример страницы с информацией о товаре:

Обзор

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

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

Если у клиента есть несколько устройств, связанных с одним и тем же аккаунтом, сообщения об одном или нескольких товарах будут синхронизироваться между этими устройствами. Однако корзина для покупок является локальной для каждого конкретного устройства. Подробности см. в разделе Корзина для покупок.

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

iOS — 2.21.100 (сообщения о нескольких товарах) и 2.21.210 (сообщения об одном товаре);
Android — 2.21.9.15 (сообщения о нескольких товарах) и 2.21.19 (сообщения об одном товаре);
Интернет — веб-клиент, поддерживающий эти функции.

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

Стандартный алгоритм для сообщений

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

пересылать от одного пользователя другому;
открывать повторно в рамках одной переписки.

Сообщения об одном или нескольких товарах нельзя:

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

Ограничения

В отличие от сообщений о товарах, отправленных через приложение WhatsApp Business, в сообщениях, отправленных через облачный API, в настоящее время не отображается значок корзины в заголовке переписки.

Обновление товаров

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

Обновленное свойство	Процесс обновления
Цена товара, его название, описание и изображение.	Вы отправляете сообщение об одном или нескольких товарах, в котором указан товар А. Вы обновляете свойства товара А в своем каталоге. Экраны, на которых отображается этот товар, обновляются сразу же, как только приложение покупателя получает от сервера информацию о внесенном изменении.
Изменение доступности	Вы отправляете клиенту сообщение об одном или нескольких товарах, в котором указан товар Б. Вы продаете все доступные единицы товара Б. Затем вы обновляете каталог, указав, что товар Б более не доступен. Если клиент уже добавил товар Б в корзину, товар удаляется. В корзине для покупок открывается окно с сообщением "Один или несколько товаров в вашей корзине обновлены". Если клиент не добавлял товар Б в корзину, в сообщении об одном или нескольких товарах теперь указывается, что этот товар недоступен.

Обновленное свойство

Процесс обновления

Цена товара, его название, описание и изображение.

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

Изменение доступности

Вы отправляете клиенту сообщение об одном или нескольких товарах, в котором указан товар Б.
Вы продаете все доступные единицы товара Б. Затем вы обновляете каталог, указав, что товар Б более не доступен.
Если клиент уже добавил товар Б в корзину, товар удаляется. В корзине для покупок открывается окно с сообщением "Один или несколько товаров в вашей корзине обновлены".
Если клиент не добавлял товар Б в корзину, в сообщении об одном или нескольких товарах теперь указывается, что этот товар недоступен.

Корзина для покупок

После просмотра товаров покупатель может добавить их в свою корзину и отправить ее вам. Для торговли в WhatsApp корзина покупок:

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

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

После отправки корзины какие-либо изменения невозможны. Клиенты могут отправить новую корзину, если им нужны новые товары или если они хотят изменить свой заказ. Вы не можете отправлять корзины клиентами.

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

Зачем это нужно?

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

Просто и эффективно

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

Индивидуальный подход

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

Повышение эффективности компании

Эффективный канал для стимулирования продаж: тестирование показало, что у компаний, использовавших сообщения о нескольких товарах, показатель конверсии этих продуктов в товары, которые затем были добавлены в отправленные корзины, в среднем составил 7 %.

Никаких шаблонов

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

Когда это следует использовать?

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

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

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

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

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

Начало работы

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

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

Шаг 1. Создайте объект interactive

Сообщения об одном товаре

Для отправки сообщения об одном товаре создайте объект interactive типа product со следующими компонентами:

Обязательные компоненты	Необязательные компоненты
Объект Action — должен содержать catalog_id и product_retailer_id.	Объект Body Объект Footer

Подробнее см. в разделе, посвященном объекту Interactive для сообщений. По окончании процесса объект interactive должен выглядеть следующим образом:

{
  "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"
    }
  }
}

Сообщения о нескольких товарах

Для отправки сообщения о нескольких товарах создайте объект interactive типа product_list со следующими компонентами:

Обязательные компоненты	Необязательные компоненты
Объект Header — должен иметь тип text. Не забудьте добавить объект text с нужным контентом. Объект Body Объект Action — должен содержать catalog_id и разделы. Разделы должны представлять собой массив объектов, описывающий каждый раздел с использованием параметров title и product_items. Каждое значение product_items должно быть массивом, описывающим каждый товар в разделе с указанием product_retailer_id и номером SKU товара.	Объект Footer

Обязательные компоненты

Необязательные компоненты

Объект Header — должен иметь тип text. Не забудьте добавить объект text с нужным контентом.
Объект Body
Объект Action — должен содержать catalog_id и разделы.
- Разделы должны представлять собой массив объектов, описывающий каждый раздел с использованием параметров title и product_items.
  - Каждое значение product_items должно быть массивом, описывающим каждый товар в разделе с указанием product_retailer_id и номером SKU товара.

Объект Footer

{
  "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. Задайте для параметра type значение interactive.

curl -X  POST https://graph.facebook.com/v19.0/FROM_PHONE_NUMBER/messages \
 -H 'Authorization: Bearer ACCESS_TOKEN' \
 - d '{
  "messaging_product": "whatsapp",
  "recipient_type": "individual",
  "to": "PHONE_NUMBER",
  "type": "interactive",
  "interactive": {
  // INTERACTIVE OBJECT GOES HERE    
}'

Все доступные параметры перечислены в справке по обмену сообщениями.

Шаг 3. Отправьте запрос к конечной точке обмена сообщениями

Отправьте запрос POST к конечной точке /PHONE_NUMBER_ID/messages с объектом JSON, созданным на шагах 1 и 2. В случае успешной отправки сообщения вы получите следующий ответ:

{
  "messaging_product": "whatsapp",
  "contacts": [{
      "input": "PHONE_NUMBER",
      "wa_id": "WHATSAPP_ID",
    }]
  "messages": [{
      "id": "wamid.ID",
    }]
}

Шаблоны сообщений о нескольких товарах

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

Платформа WhatsApp Business | Облачный API | API Business Management