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

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

• сообщения с каталогом — сообщения в произвольной форме, содержащие кнопку, при нажатии которой открывается ваш каталог товаров в 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": {
        "thumbnail_product_retailer_id": "<THUMBNAIL_PRODUCT_RETAILER_ID>"
      }
    },

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

Свойства

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

{
  "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 основных действия, описанных ниже.

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

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

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

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

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

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

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

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

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

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

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

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

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

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

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

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

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

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

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

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

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

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

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

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

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

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

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

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

Когда это можно использовать

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

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

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

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

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

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

Перед отправкой каждого сообщения вам необходимо получить ID WhatsApp получателя, выполнив вызов к узлу /contacts.

Рекомендуем настроить Webhooks для получения статуса сообщений и уведомлений о входящих сообщениях. Это позволит вам отслеживать как отправку сообщений, так и ответы от покупателей.

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

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

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

В итоге интерактивный объект должен выглядеть примерно так:

"interactive": {
    "type": "product",
    "body": {
      "text": "text-body-content"
    },
    "footer": {
      "text": "text-footer-content"
    },
    "action": {
      "catalog_id": "catalog-id",
      "product_retailer_id": "product-SKU-in-catalog"
    }
}

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

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

В итоге объект interactive должен выглядеть примерно так:

"interactive": 
    {
    "type": "product_list",
    "header":{
       "type": "text",
        "text": "text-header-content"
     },
     "body":{
        "text": "text-body-content"
      },
     "footer":{
        "text":"text-footer-content"
     },
     "action":{
        "catalog_id":"catalog-id",
        "sections": [
             {
             "title": "the-section-title",             
             "product_items": [
                  { "product_retailer_id": "product-SKU-in-catalog" },
                  { "product_retailer_id": "product-SKU-in-catalog" },
                            ...
              ]},
              {
              "title": "the-section-title",
              "product_items": [
                 { "product_retailer_id": "product-SKU-in-catalog" }
                           ...
              ]},
               ...
       ]
     },  
    }

Отсутствующие элементы

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

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

• сообщения отправляются успешно;
• элементы без совпадения отклоняются и
• компания получает сообщение об ошибке с просьбой обновить каталог.

Шаг 2. Добавьте общие параметры сообщений

После завершения создания интерактивного объекта добавьте другие параметры, которые являются частью сообщения: recipient_type, to и type. Не забудьте установить для параметра type значение interactive.

{
  "recipient_type": "individual",
  "to" : "whatsapp-id", // WhatsApp ID of the recipient
  "type": "interactive",
  "interactive":{
    // The interactive object  
   }
  }

Параметры, общие для всех типов сообщений, см. в этом разделе.

Шаг 3. Выполните вызов POST к /messages

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

{
  "messages": [{
    "id": "{message-id}"
  }]
  }

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

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