1MSG

Отправить Товар

POST
/sendProduct

Отправка товара или списка товаров в новый или существующий чат (Только с открытым диалоговым окном). Нужен только один параметр адресата - chatId, phone или bsuid. В BSUID-centric режиме chatId может быть [email protected], bsuid@lid, [email protected] или username@username. Поле phone принимает телефон или BSUID; bsuid можно передать отдельным полем.

Сначала вам необходимо загрузить свой инвентарь в Facebook. Для этого вы можете использовать API или Facebook Commerce Manager. Если у вас уже настроен каталог Facebook, мы рекомендуем вам использовать этот каталог для коммерческих случаев использования WhatsApp.

Вы не можете отправлять товары клиентам Business WhatsApp.

Authorization

JWT token
querytoken<token>

Request Body

  1. body
action*

Объект, содержащий информацию о товаре или каталоге. Может иметь следующий параметры:

catalog_id - идентификатор каталога

product_retailer_id - идентификатор товара. Только для отправки одного товара.

sections - Используется для отправки нескольких товаров, массив, содержащий объекты с информацией о наборах товаров. См пример ниже.

Пример: {"catalog_id":"{{catalog_id}}","sections":[{"title":"the-section-title","product_items":[{"product_retailer_id":"{{SKU-1}}"},{"product_retailer_id":"{{SKU-2}}"}]},{"title":"the-section-title2","product_items":[{"product_retailer_id":"{{SKU-1}}"}]}]}

body?string

Текст сообщения. Пример: Some text.

footer?string

Располагается под текстом сообщения. Пример: Footer.

header?string

Заголовок каталога. Пример: Header.

Обязателен при отправке каталога (нескольких товаров).

chatId?string

Обязателен, если не указаны phone и bsuid

ID чата из списка сообщений. Примеры: [email protected], RU.1504711984690866@lid, username@username или [email protected] (группа). Используется вместо параметра phone.

phone?string

Обязателен, если не указаны chatId и bsuid

Идентификатор получателя. Принимает номер телефона с кодом страны или BSUID, например RU.1504711984690866.

Для chatId используйте полные ID чатов: [email protected], bsuid@lid, username@username или [email protected].

bsuid?string

Необязательная альтернатива phone/chatId

BSUID получателя без суффикса @lid. Пример: RU.1504711984690866.

Response Body

Server response example

application/json
  1. response
sent?boolean
id?string

Уникальный идентификатор сообщения

message?string

Уведомление о статусе отправки сообщения

description?string

Комментарий к результату отправки

curl -X POST 'https://api.1msg.io/123/sendProduct' \  -H 'Content-Type: application/json' \  -d '{  "body": "Have a look at this",  "action": {    "catalog_id": "407921857496983",    "product_retailer_id": "product-1"  },  "phone": "12020721369"}'
{  "sent": true,  "id": "gBGGeRhGZTEfAgkJCh2wAz4ZH-8",  "message": "Sent to [email protected]",  "description": "Message has been sent to the provider"}