Примеры сообщений WhatsApp

Что это такое

Отправляйте шаблонные, медиа-, интерактивные, торговые сообщения, сообщения Flow и вызовы с примерами запросов с пояснениями.

Перед началом работы

Сохраните ключ API YCloud в секрете на стороне сервера.
Подключите WhatsApp Business Account и номер телефона, используемые в запросе.
Создайте и подтвердите любой шаблон, на который ссылается запрос на отправку сообщений.
Замените каждый плейсхолдер значением из своего аккаунта.

Как это работает

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

Запрос

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

Ответ

Успешный ответ на отправку подтверждает, что YCloud принял запрос сообщения; используйте получение сообщений или Webhook whatsapp.message.updated, чтобы узнать окончательный статус доставки.

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

Выберите пример

Шаблонные сообщения

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

Сообщения произвольного формата

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

Интерактивные сообщения

Добавляйте списки, кнопки, Flows, товары, звонки и карусели.

Торговые сообщения

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

Приведенные ниже примеры применимы как к API Send a WhatsApp message directly, так и к API Enqueue a WhatsApp message. Начало работы с шаблонными сообщениями — простой способ инициировать диалог. Как только клиент ответит на шаблонное сообщение компании, компания сможет отправлять клиенту сообщения любого типа в течение 24 часов.

Примеры шаблонных сообщений

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

Шаблонное сообщение аутентификации с кнопками одноразового пароля

В этом случае у вас есть шаблон аутентификации с кнопкой копирования кода, шаблон аутентификации с кнопкой в одно касание или шаблон аутентификации без касания (zero-tap), и вы отправляете шаблонное сообщение, которое:

Содержит одноразовый пароль или код подтверждения для доставки клиенту.
Содержит кнопку копирования кода , кнопку автозаполнения в одно касание или вовсе не содержит кнопок при использовании zero-tap.

ZERO-TAP

Запрос

curl 'https://api.ycloud.com/v2/whatsapp/messages/sendDirectly' \
-H 'Content-Type: application/json' \
-H 'X-API-Key: {{YOUR-API-KEY}}' \
-d '{
  "from": "{{BUSINESS-PHONE-NUMBER}}",
  "to": "{{CUSTOMER-PHONE-NUMBER}}",
  "type": "template",
  "template": {
    "name": "otp_one_tap",
    "language": {
      "code": "{{LANGUAGE-CODE}}",
      "policy": "deterministic"
    },
    "components": [
      {
        "type": "body",
        "parameters": [
          {
            "type": "text",
            "text": "797011"
          }
        ]
      },
      {
        "type": "button",
        "sub_type": "url",
        "index": "0",
        "parameters": [
          {
            "type": "text",
            "text": "797011"
          }
        ]
      }
    ]
  }
}'

Ответ

Успешный запрос возвращает объект сообщения YCloud. Начальный статус accepted подтверждает отправку запроса, а не окончательную доставку.

{
  "id": "MESSAGE_ID",
  "status": "accepted"
}

Сохраните id и сопоставляйте последующие события whatsapp.message.updated.

Объяснение

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

Шаблонное сообщение с переменными

В этом случае у вас есть сервисный шаблон с переменными в теле, и вы отправляете шаблонное сообщение, которое:

Содержит текст с 3 переменными в теле.

Запрос

curl 'https://api.ycloud.com/v2/whatsapp/messages/sendDirectly' \
-H 'Content-Type: application/json' \
-H 'X-API-Key: {{YOUR-API-KEY}}' \
-d '{
  "from": "{{BUSINESS-PHONE-NUMBER}}",
  "to": "{{CUSTOMER-PHONE-NUMBER}}",
  "type": "template",
  "template": {
    "name": "order_confirmation",
    "language": {
      "code": "{{LANGUAGE-CODE}}",
      "policy": "deterministic"
    },
    "components": [
      {
        "type": "body",
        "parameters": [
          {
            "type": "text",
            "text": "ORDER-TITLE"
          },
          {
            "type": "text",
            "text": "9.9 USD"
          },
          {
            "type": "text",
            "text": "February 25"
          }
        ]
      }
    ]
  }
}'

Ответ

{
  "id": "MESSAGE_ID",
  "status": "accepted"
}

Сохраните id и сопоставляйте последующие события whatsapp.message.updated.

Объяснение

Убедитесь, что соответствующий шаблон был одобрен.
Установите правильный type для отправляемых сообщений. В данном случае type установлен на template, а components и parameters запроса на отправку сообщений должны соответствовать шаблону.

Шаблонное сообщение с изображением и кнопками Quick Reply

В этом случае у вас есть маркетинговый шаблон с изображением и кнопками Quick Reply, и вы отправляете шаблонное сообщение, которое:

Содержит изображение в заголовке.
Содержит текст с 1 переменной в теле.
Содержит текст в нижнем колонтитуле.
Содержит 2 кнопки Quick Reply. Максимальное количество кнопок Quick Reply — 3.

Запрос

curl 'https://api.ycloud.com/v2/whatsapp/messages/sendDirectly' \
-H 'Content-Type: application/json' \
-H 'X-API-Key: {{YOUR-API-KEY}}' \
-d '{
  "from": "{{BUSINESS-PHONE-NUMBER}}",
  "to": "{{CUSTOMER-PHONE-NUMBER}}",
  "type": "template",
  "template": {
    "name": "marketing_friday",
    "language": {
      "code": "{{LANGUAGE-CODE}}",
      "policy": "deterministic"
    },
    "components": [
      {
        "type": "header",
        "parameters": [
          {
            "type": "image",
            "image": {
              "link": "https://oss-ycloud-publicread.oss-ap-southeast-1.aliyuncs.com/api-docs/sample/sample.jpg"
            }
          }
        ]
      },
      {
        "type": "body",
        "parameters": [
          {
            "type": "text",
            "text": "Lucy"
          }
        ]
      },
      {
        "type": "button",
        "sub_type": "quick_reply",
        "index": 0,
        "parameters": [
          {
            "type": "payload",
            "payload": "more_about_marketing_friday"
          }
        ]
      },
      {
        "type": "button",
        "sub_type": "quick_reply",
        "index": 1,
        "parameters": [
          {
            "type": "payload",
            "payload": "unsubscribe_marketing_notifications"
          }
        ]
      }
    ]
  }
}'

Ответ

{
  "id": "MESSAGE_ID",
  "status": "accepted"
}

Сохраните id и сопоставляйте последующие события whatsapp.message.updated.

Объяснение

Параметр caption (используется для описания указанного медиафайла image, video или document) не поддерживается в сообщениях template или interactive.
Дополнительные сведения об ограничениях для медиафайлов в заголовке см. в разделе Поддерживаемые типы медиа.
Используйте payload для отслеживания кликов пользователей по кнопкам. Полезная нагрузка (payload) кнопки не видна, но будет передана при нажатии пользователем на кнопку; см. также Входящее сообщение по нажатию кнопки шаблона.

Шаблонное сообщение с видео и кнопками с призывом к действию (Call To Action)

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

Содержит видео в заголовке.
Содержит текст с 1 переменной в основном тексте.
Содержит текст в нижнем колонтитуле (footer).
Содержит 2 кнопки с призывом к действию: 1 кнопку PHONE_NUMBER и 1 кнопку URL. Кнопка URL может содержать не более 1 переменной в конце URL.

Запрос

curl 'https://api.ycloud.com/v2/whatsapp/messages/sendDirectly' \
-H 'Content-Type: application/json' \
-H 'X-API-Key: {{YOUR-API-KEY}}' \
-d '{
  "from": "{{BUSINESS-PHONE-NUMBER}}",
  "to": "{{CUSTOMER-PHONE-NUMBER}}",
  "type": "template",
  "template": {
    "name": "marketing_friday_more",
    "language": {
      "code": "{{LANGUAGE-CODE}}",
      "policy": "deterministic"
    },
    "components": [
      {
        "type": "header",
        "parameters": [
          {
            "type": "video",
            "video": {
              "link": "https://oss-ycloud-publicread.oss-ap-southeast-1.aliyuncs.com/api-docs/sample/sample.mp4"
            }
          }
        ]
      },
      {
        "type": "body",
        "parameters": [
          {
            "type": "text",
            "text": "The Friday"
          }
        ]
      },
      {
        "type": "button",
        "sub_type": "url",
        "index": 0,
        "parameters": [
          {
            "type": "text",
            "text": "qptHJVK2EjU"
          }
        ]
      }
    ]
  }
}'

Ответ

Успешный запрос возвращает объект сообщения YCloud. Начальный статус accepted подтверждает отправку, а не окончательную доставку.

{
  "id": "MESSAGE_ID",
  "status": "accepted"
}

Сохраните id для последующего сопоставления с событиями whatsapp.message.updated.

Пояснение

Параметр caption (используется для описания указанного медиафайла image, video или document) не поддерживается в сообщениях template или interactive.

Шаблонное сообщение с купоном

В этом случае у вас есть шаблон купона, и вы отправляете шаблонное сообщение:

Содержит текст с 2 переменными в основном тексте.
Содержит 1 кнопку «Копировать код».

Запрос

curl 'https://api.ycloud.com/v2/whatsapp/messages/sendDirectly' \
-H 'Content-Type: application/json' \
-H 'X-API-Key: {{YOUR-API-KEY}}' \
-d '{
  "from": "{{BUSINESS-PHONE-NUMBER}}",
  "to": "{{CUSTOMER-PHONE-NUMBER}}",
  "type": "template",
  "template": {
    "name": "marketing_coupon",
    "language": {
      "code": "{{LANGUAGE-CODE}}",
      "policy": "deterministic"
    },
    "components": [
      {
        "type": "body",
        "parameters": [
          {
            "type": "text",
            "text": "Tom"
          },
          {
            "type": "text",
            "text": "25OFF"
          }
        ]
      },
      {
        "type": "button",
        "sub_type": "copy_code",
        "index": 0,
        "parameters": [
          {
            "type": "coupon_code",
            "coupon_code": "25OFF"
          }
        ]
      }
    ]
  }
}'

Ответ

{
  "id": "MESSAGE_ID",
  "status": "accepted"
}

Сохраните id для последующего сопоставления с событиями whatsapp.message.updated.

Пояснение

Длина кода купона ограничена 20 символами.
Текст кнопки нельзя изменить.

Шаблонное сообщение с геопозицией

В этом случае у вас есть шаблон с геопозицией, и вы отправляете шаблонное сообщение с геопозицией:

Запрос

curl 'https://api.ycloud.com/v2/whatsapp/messages/sendDirectly' \
-H 'Content-Type: application/json' \
-H 'X-API-Key: {{YOUR-API-KEY}}' \
-d '{
  "from": "{{BUSINESS-PHONE-NUMBER}}",
  "to": "{{CUSTOMER-PHONE-NUMBER}}",
  "type": "template",
  "template": {
    "name": "location_header",
    "language": {
      "code": "{{LANGUAGE-CODE}}",
      "policy": "deterministic"
    },
    "components": [
      {
        "type": "header",
        "parameters": [
          {
            "type": "location",
            "location": {
              "latitude": 37.483307,
              "longitude": 122.148981,
              "name": "Pablo Morales",
              "address": "1 Hacker Way, Menlo Park, CA 94025"
            }
          }
        ]
      }
    ]
  }
}'

Ответ

{
  "id": "MESSAGE_ID",
  "status": "accepted"
}

Сохраните id для последующего сопоставления с событиями whatsapp.message.updated.

Пояснение

latitude и longitude являются обязательными.

Шаблонное сообщение с ограниченным по времени предложением

В этом случае у вас есть шаблон с ограниченным по времени предложением, и вы отправляете шаблонное сообщение с ограниченным по времени предложением (LTO):

Содержит изображение в заголовке.
Отображает дату окончания действия и обратный отсчет таймера для промокода.
Содержит текст с 2 переменными в основном тексте.
Содержит 2 кнопки: 1 кнопку COPY_CODE и 1 кнопку URL.

Запрос

curl 'https://api.ycloud.com/v2/whatsapp/messages/sendDirectly' \
-H 'Content-Type: application/json' \
-H 'X-API-Key: {{YOUR-API-KEY}}' \
-d '{
  "from": "{{BUSINESS-PHONE-NUMBER}}",
  "to": "{{CUSTOMER-PHONE-NUMBER}}",
  "type": "template",
  "template": {
    "name": "limited_time_offer_caribbean_pkg_2023",
    "language": {
      "code": "{{LANGUAGE-CODE}}",
      "policy": "deterministic"
    },
    "components": [
      {
        "type": "header",
        "parameters": [
          {
            "type": "image",
            "image": {
              "link": "https://oss-ycloud-publicread.oss-ap-southeast-1.aliyuncs.com/api-docs/sample/sample.jpg"
            }
          }
        ]
      },
      {
        "type": "limited_time_offer",
        "parameters": [
          {
            "type": "limited_time_offer",
            "limited_time_offer": {
              "expiration_time_ms": 1698118200000
            }
          }
        ]
      },
      {
        "type": "body",
        "parameters": [
          {
            "type": "text",
            "text": "Tom"
          },
          {
            "type": "text",
            "text": "C025"
          }
        ]
      },
      {
        "type": "button",
        "sub_type": "copy_code",
        "index": "0",
        "parameters": [
          {
            "type": "coupon_code",
            "coupon_code": "C025"
          }
        ]
      },
      {
        "type": "button",
        "sub_type": "url",
        "index": "1",
        "parameters": [
          {
            "type": "text",
            "text": "param025"
          }
        ]
      }
    ]
  }
}'

Ответ

{
  "id": "MESSAGE_ID",
  "status": "accepted"
}

Сохраните id для последующего сопоставления с событиями whatsapp.message.updated.

Пояснение

Сопоставьте поля запроса с выбранным типом сообщения и используйте возвращенный ID сообщения для отслеживания статуса.

Шаблонное сообщение с каруселью

В этом случае у вас есть шаблон карусели, и вы отправляете шаблонное сообщение с каруселью:

Содержит текст с 2 переменными в основном тексте.
Содержит 2 карточки карусели с возможностью горизонтальной прокрутки.

Запрос

curl 'https://api.ycloud.com/v2/whatsapp/messages/sendDirectly' \
-H 'Content-Type: application/json' \
-H 'X-API-Key: {{YOUR-API-KEY}}' \
-d '{
  "from": "{{BUSINESS-PHONE-NUMBER}}",
  "to": "{{CUSTOMER-PHONE-NUMBER}}",
  "type": "template",
  "template": {
    "name": "summer_carousel_promo_2023",
    "language": {
      "code": "{{LANGUAGE-CODE}}",
      "policy": "deterministic"
    },
    "components": [
      {
        "type": "body",
        "parameters": [
          {
            "type": "text",
            "text": "C015"
          },
          {
            "type": "text",
            "text": "15%"
          }
        ]
      },
      {
        "type": "carousel",
        "cards": [
          {
            "card_index": 0,
            "components": [
              {
                "type": "header",
                "parameters": [
                  {
                    "type": "image",
                    "image": {
                      "link": "https://oss-ycloud-publicread.oss-ap-southeast-1.aliyuncs.com/api-docs/sample/sample.jpg"
                    }
                  }
                ]
              },
              {
                "type": "body",
                "parameters": [
                  {
                    "type": "text",
                    "text": "C015"
                  },
                  {
                    "type": "text",
                    "text": "15%"
                  }
                ]
              },
              {
                "type": "button",
                "sub_type": "quick_reply",
                "index": 0,
                "parameters": [
                  {
                    "type": "payload",
                    "payload": "summer_lemons_2023"
                  }
                ]
              },
              {
                "type": "button",
                "sub_type": "url",
                "index": 1,
                "parameters": [
                  {
                    "type": "text",
                    "text": "summer_lemons_2023"
                  }
                ]
              }
            ]
          },
          {
            "card_index": 1,
            "components": [
              {
                "type": "header",
                "parameters": [
                  {
                    "type": "image",
                    "image": {
                      "link": "https://oss-ycloud-publicread.oss-ap-southeast-1.aliyuncs.com/api-docs/sample/sample.jpg"
                    }
                  }
                ]
              },
              {
                "type": "body",
                "parameters": [
                  {
                    "type": "text",
                    "text": "20OFFEXOTIC"
                  },
                  {
                    "type": "text",
                    "text": "20%"
                  }
                ]
              },
              {
                "type": "button",
                "sub_type": "quick_reply",
                "index": 0,
                "parameters": [
                  {
                    "type": "payload",
                    "payload": "summer_blues_2023"
                  }
                ]
              },
              {
                "type": "button",
                "sub_type": "url",
                "index": 1,
                "parameters": [
                  {
                    "type": "text",
                    "text": "summer_blues_2023"
                  }
                ]
              }
            ]
          }
        ]
      }
    ]
  }
}'

Ответ

{
  "id": "MESSAGE_ID",
  "status": "accepted"
}

Сохраните id для последующего сопоставления с событиями whatsapp.message.updated.

Пояснение

Пузыри сообщений (message bubbles) содержат только текст и поддерживают переменные. Максимальное количество символов для переменных не ограничено, но они учитываются в общем лимите сообщения в 1024 символа.
Основной текст карточки поддерживает переменные. Максимальное количество символов для переменных не ограничено, но они учитываются в общем лимите текста карточки в 160 символов.

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

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

Запрос

curl 'https://api.ycloud.com/v2/whatsapp/messages/sendDirectly' \
-H 'Content-Type: application/json' \
-H 'X-API-Key: {{YOUR-API-KEY}}' \
-d '{
  "from": "{{BUSINESS-PHONE-NUMBER}}",
  "to": "{{CUSTOMER-PHONE-NUMBER}}",
  "type": "template",
  "template": {
    "name": "intro_catalog_offer",
    "language": {
      "code": "{{LANGUAGE-CODE}}"
    },
    "components": [
      {
        "type": "body",
        "parameters": [
          {
            "type": "text",
            "text": "100"
          },
          {
            "type": "text",
            "text": "400"
          },
          {
            "type": "text",
            "text": "3"
          }
        ]
      },
      {
        "type": "button",
        "sub_type": "catalog",
        "index": 0,
        "parameters": [
          {
            "type": "action",
            "action": {
              "thumbnail_product_retailer_id": "2lc20305pt"
            }
          }
        ]
      }
    ]
  }
}'

Ответ

{
  "id": "MESSAGE_ID",
  "status": "accepted"
}

Сохраните id для последующего сопоставления с событиями whatsapp.message.updated.

Пояснение

Параметр thumbnail_product_retailer_id является необязательным. Номер SKU обозначается как Content ID в Commerce Manager. Миниатюра этого товара будет использоваться в качестве изображения в заголовке сообщения. Если объект parameters опущен, будет использовано изображение первого товара из вашего каталога.

Шаблонное сообщение MPM

В этом случае у вас есть шаблон MPM, и вы отправляете сообщение, чтобы поделиться товарами с клиентами. В этом примере отправляется утвержденный шаблон с именем «abandoned_cart», а также подставляются переменная (имя клиента) в заголовок шаблона и промокод в тело шаблона. Он также определяет два раздела («Popular Bundles» и «Premium Packages») и указывает товары (всего 3), которые должны быть добавлены в эти разделы.

Запрос

curl 'https://api.ycloud.com/v2/whatsapp/messages/sendDirectly' \
-H 'Content-Type: application/json' \
-H 'X-API-Key: {{YOUR-API-KEY}}' \
-d '{
  "from": "{{BUSINESS-PHONE-NUMBER}}",
  "to": "{{CUSTOMER-PHONE-NUMBER}}",
  "type": "template",
  "template": {
    "name": "abandoned_cart",
    "language": {
      "code": "{{LANGUAGE-CODE}}"
    },
    "components": [
      {
        "type": "header",
        "parameters": [
          {
            "type": "text",
            "text": "Pablo"
          }
        ]
      },
      {
        "type": "body",
        "parameters": [
          {
            "type": "text",
            "text": "10OFF"
          }
        ]
      },
      {
        "type": "button",
        "sub_type": "mpm",
        "index": 0,
        "parameters": [
          {
            "type": "action",
            "action": {
              "thumbnail_product_retailer_id": "2lc20305pt",
              "sections": [
                {
                  "title": "Popular Bundles",
                  "product_items": [
                    {
                      "product_retailer_id": "2lc20305pt"
                    },
                    {
                      "product_retailer_id": "nseiw1x3ch"
                    }
                  ]
                },
                {
                  "title": "Premium Packages",
                  "product_items": [
                    {
                      "product_retailer_id": "n6k6x0y7oe"
                    }
                  ]
                }
              ]
            }
          }
        ]
      }
    ]
  }
}'

Ответ

{
  "id": "MESSAGE_ID",
  "status": "accepted"
}

Сохраните id и сопоставляйте последующие события whatsapp.message.updated.

Пояснение

Клиенты должны использовать WhatsApp версии 2.22.24 или выше.
Шаблонные сообщения MPM нельзя пересылать другим клиентам.
Когда клиент добавляет один или несколько товаров в корзину и оформляет заказ, мы отправляем вам вебхук с описанием заказа. См. также Входящее сообщение с заказом.

Шаблонное сообщение Flow

WhatsApp Flows — это способ создания структурированных сценариев взаимодействия для бизнес-коммуникаций. С помощью Flows компании могут определять, настраивать и персонализировать сообщения с интерактивными элементами, обеспечивающими клиентам более удобную структуру общения.

В этом случае вы отправляете сообщение с использованием шаблона Flow:

Запрос

curl 'https://api.ycloud.com/v2/whatsapp/messages/sendDirectly' \
-H 'Content-Type: application/json' \
-H 'X-API-Key: {{YOUR-API-KEY}}' \
-d '{
  "from": "{{BUSINESS-PHONE-NUMBER}}",
  "to": "{{CUSTOMER-PHONE-NUMBER}}",
  "type": "template",
  "template": {
    "name": "TEMPLATE_NAME",
    "language": {
      "code": "{{LANGUAGE-CODE}}"
    },
    "components": [
      {
        "type": "button",
        "sub_type": "flow",
        "index": 0,
        "parameters": [
          {
            "type": "action",
            "action": {
              "flow_token": "<FLOW_TOKEN>",
              "flow_action_data": {
                "data1": "value1"
              }
            }
          }
        ]
      }
    ]
  }
}'

Ответ

{
  "id": "MESSAGE_ID",
  "status": "accepted"
}

Сохраните id и сопоставляйте последующие события whatsapp.message.updated.

Пояснение

flow_action_data — это объект JSON с полезной нагрузкой данных для первого экрана. См. также Отправка шаблона с Flow — WhatsApp Business Platform.
Инструкции по отправке интерактивного сообщения с Flow см. в разделе Интерактивное сообщение Flow.
Инструкции по получению ответов Flow см. в разделе Входящее интерактивное сообщение с ответом Flow.

Шаблонное сообщение с деталями заказа

Шаблонное сообщение с деталями заказа позволяет компаниям отправлять информацию о заказе в виде предварительно настроенных параметров компонента кнопки с призывом к действию Open order details. Оно позволяет бизнесу передавать любую интеграцию платежей (например, UPI Intent, Payment Gateway или Payment Links) в параметрах кнопки. Ниже приведен пример отправки Payment Gateway в параметрах шаблонного сообщения с деталями заказа для предложения клиенту совершить оплату.

Запрос

curl 'https://api.ycloud.com/v2/whatsapp/messages/sendDirectly' \
-H 'Content-Type: application/json' \
-H 'X-API-Key: {{YOUR-API-KEY}}' \
-d '{
  "from": "{{BUSINESS-PHONE-NUMBER}}",
  "to": "{{CUSTOMER-PHONE-NUMBER}}",
  "type": "template",
  "template": {
    "name": "order_details_example",
    "language": {
      "policy": "deterministic",
      "code": "{{LANGUAGE-CODE}}"
    },
    "components": [
      {
        "type": "header",
        "parameters": [
          {
            "type": "text",
            "text": "<HEADER_TEXT>",
          }
        ]
      },
      {
        "type": "button",
        "sub_type": "order_details",
        "index": 0,
        "parameters": [
          {
            "type": "action",
            "action": {
              "order_details": {
                "currency": "INR",
                "order": {
                  "discount": {
                    "offset": 100,
                    "value": 250
                  },
                  "items": [
                    {
                      "amount": {
                        "offset": 100,
                        "value": 400
                      },
                      "name": "<ORDER_ITEM_NAME>",
                      "quantity": 1,
                      "retailer_id": "<ORDER_ITEM_RETAILER_ID>",
                      "country_of_origin": "<ORIGIN_COUNTRY>",
                      "importer_name": "<IMPORTER_NAME>",
                      "importer_address": {
                        "address_line1": "<IMPORTER_ADDRESS>",
                        "city": "<CITY>",
                        "country_code": "<COUNTRY>",
                        "postal_code": "<ZIP_CODE>"
                      }
                    }
                  ],
                  "shipping": {
                    "offset": 100,
                    "value": 0
                  },
                  "status": "pending",
                  "subtotal": {
                    "offset": 100,
                    "value": 400
                  },
                  "tax": {
                    "offset": 100,
                    "value": 500
                  }
                },
                "payment_settings": [
                  {
                    "type": "payment_gateway",
                    "payment_gateway": {
                      "type": "billdesk",
                      "configuration_name": "<payment-config-id>",
                      "billdesk": {
                        "additional_info1": "additional_info1-value",
                        "additional_info2": "additional_info2-value",
                        "additional_info3": "additional_info3-value",
                        "additional_info4": "additional_info4-value",
                        "additional_info5": "additional_info5-value",
                        "additional_info6": "additional_info6-value",
                        "additional_info7": "additional_info7-value",
                      }
                    }
                  }
                ],
                "reference_id": "<reference_id_value>",
                "total_amount": {
                  "offset": 100,
                  "value": 650
                },
                "type": "digital-goods"
              }
            }
          }
        ]
      }
    ]
  }
}'

Ответ

{
  "id": "MESSAGE_ID",
  "status": "accepted"
}

Сохраните id и сопоставляйте последующие события whatsapp.message.updated.

Пояснение

Чтобы узнать больше о параметрах template, см. также Отправка шаблонного сообщения с деталями заказа.
Перед отправкой шаблонных сообщений с деталями заказа создайте шаблон с деталями заказа.
Вы будете получать уведомления через Webhook при попытке оплаты клиентом и изменении статуса платежа. См. Обновление платежной транзакции.
Если с момента последнего ответа клиента на рабочий номер компании прошло не более 24 часов, вместо этого можно отправить интерактивное сообщение с деталями заказа.

Шаблонное сообщение со статусом заказа

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

Запрос

curl 'https://api.ycloud.com/v2/whatsapp/messages/sendDirectly' \
-H 'Content-Type: application/json' \
-H 'X-API-Key: {{YOUR-API-KEY}}' \
-d '{
  "from": "{{BUSINESS-PHONE-NUMBER}}",
  "to": "{{CUSTOMER-PHONE-NUMBER}}",
  "type": "template",
  "template": {
    "name": "order_status_template",
    "language": {
      "policy": "deterministic",
      "code": "{{LANGUAGE-CODE}}"
    },
    "components": [
      {
        "type": "order_status",
        "parameters": [
          {
            "type": "order_status",
            "order_status": {
              "reference_id": "<reference_id_value>",
              "order": {
                "status": "processing | partially_shipped | shipped | completed | canceled",
                "description": "<OPTIONAL_DESCRIPTION>"
              }
            }
          }
        ]
      }
    ]
  }
}'

Ответ

{
  "id": "MESSAGE_ID",
  "status": "accepted"
}

Сохраните id и сопоставляйте последующие события whatsapp.message.updated.

Пояснение

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

Примеры сообщений в свободной форме

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

Текстовое сообщение

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

Содержит только обычный текст.
Содержит URL и включает окно предпросмотра в текстовых сообщениях за счет установки preview_url в значение true.
Указывает сообщение (context.message_id), на которое вы отвечаете.

Запрос

curl 'https://api.ycloud.com/v2/whatsapp/messages/sendDirectly' \
-H 'Content-Type: application/json' \
-H 'X-API-Key: {{YOUR-API-KEY}}' \
-d '{
  "from": "{{BUSINESS-PHONE-NUMBER}}",
  "to": "{{CUSTOMER-PHONE-NUMBER}}",
  "type": "text",
  "text": {
    "body": "*Learn* how to format your messages: https://faq.whatsapp.com/539178204879377",
    "preview_url": true
  },
  "context": {
    "message_id": "wamid.BgNODYxN..."
  }
}'

Ответ

{
  "id": "MESSAGE_ID",
  "status": "accepted"
}

Сохраните id и сопоставляйте последующие события whatsapp.message.updated.

Пояснение

До того, как клиент ответит на ваше сообщение, вы можете отправлять только шаблонные сообщения.
Используйте context.message_id, чтобы указать сообщение, на которое вы отвечаете. Обратите внимание, что это исходный идентификатор сообщения на платформе WhatsApp, начинающийся с wamid., а не идентификатор сообщения в YCloud. wamid можно найти как в объекте YCloud whatsappMessage (когда статус меняется на sent), так и в объекте whatsappInboundMessage. Эта функция также применима к другим типам сообщений, за исключением сообщений template и sticker.
Текст сообщения WhatsApp поддерживает форматирование текста, такое как курсив, полужирный, ~~зачеркнутый~~, моноширинный, маркированный список, нумерованный список, цитата и встроенный код. См. также Как форматировать сообщения.

Сообщение с изображением

В этом случае вы отправляете сообщение с изображением:

Содержит URL-адрес изображения.
Содержит подпись с описанием изображения.

Запрос

curl 'https://api.ycloud.com/v2/whatsapp/messages/sendDirectly' \
-H 'Content-Type: application/json' \
-H 'X-API-Key: {{YOUR-API-KEY}}' \
-d '{
  "from": "{{BUSINESS-PHONE-NUMBER}}",
  "to": "{{CUSTOMER-PHONE-NUMBER}}",
  "type": "image",
  "image": {
    "link": "https://oss-ycloud-publicread.oss-ap-southeast-1.aliyuncs.com/api-docs/sample/sample.jpg",
    "caption": "Describes the specified media."
  }
}'

Ответ

{
  "id": "MESSAGE_ID",
  "status": "accepted"
}

Сохраните id и сопоставляйте последующие события whatsapp.message.updated.

Пояснение

Поддерживаемые типы изображений: image/jpeg, image/png. Изображения должны быть 8-битными, в формате RGB или RGBA.
Требуется встроенный цветовой профиль. См. также Как встроить профиль, Встраивание цветового профиля в Adobe Photoshop.
Ограничение размера изображения: 5 МБ.
См. также Поддерживаемые типы медиафайлов.

Видеосообщение

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

Содержит URL-адрес видео.
Содержит подпись с описанием видео.

Запрос

curl 'https://api.ycloud.com/v2/whatsapp/messages/sendDirectly' \
-H 'Content-Type: application/json' \
-H 'X-API-Key: {{YOUR-API-KEY}}' \
-d '{
  "from": "{{BUSINESS-PHONE-NUMBER}}",
  "to": "{{CUSTOMER-PHONE-NUMBER}}",
  "type": "video",
  "video": {
    "link": "https://oss-ycloud-publicread.oss-ap-southeast-1.aliyuncs.com/api-docs/sample/sample.mp4",
    "caption": "Describes the specified media."
  }
}'

Ответ

{
  "id": "MESSAGE_ID",
  "status": "accepted"
}

Сохраните id и сопоставляйте последующие события whatsapp.message.updated.

Пояснение

Поддерживаемые типы видео: video/mp4, video/3gpp.
- Поддерживаются только видеокодек H.264 и аудиокодек AAC.
- Мы поддерживаем видео с одной аудиодорожкой или без звука.
- Формат файлов MP4 основан на базовом медиаформате ISO, который напрямую произошел от формата файлов QuickTime, разработанного компанией Apple. Однако видеофайлы QuickTime не поддерживаются, даже если вы изменили расширение файла с.mov на .mp4.
Ограничение размера видео: 16 МБ.
См. также Поддерживаемые типы медиафайлов.

Аудиосообщение

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

Содержит URL-адрес аудио.

Запрос

curl 'https://api.ycloud.com/v2/whatsapp/messages/sendDirectly' \
-H 'Content-Type: application/json' \
-H 'X-API-Key: {{YOUR-API-KEY}}' \
-d '{
  "from": "{{BUSINESS-PHONE-NUMBER}}",
  "to": "{{CUSTOMER-PHONE-NUMBER}}",
  "type": "audio",
  "audio": {
    "link": "https://oss-ycloud-publicread.oss-ap-southeast-1.aliyuncs.com/api-docs/sample/sample.mp3"
  }
}'

Ответ

{
  "id": "MESSAGE_ID",
  "status": "accepted"
}

Сохраните id и сопоставляйте последующие события whatsapp.message.updated.

Пояснение

Поддерживаемые типы аудио: audio/aac, audio/mp4, audio/mpeg, audio/amr, audio/ogg (только кодеки opus, базовый audio/ogg не поддерживается).
Ограничение размера аудио: 16 МБ.
См. также Поддерживаемые типы медиафайлов.
caption можно использовать для медиасообщений типа image, video и document, но параметр не поддерживается для аудиосообщений.

Сообщение с документом

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

Содержит URL-адрес документа.
Содержит подпись с описанием документа.
Задает имя файла документа.

Запрос

curl 'https://api.ycloud.com/v2/whatsapp/messages/sendDirectly' \
-H 'Content-Type: application/json' \
-H 'X-API-Key: {{YOUR-API-KEY}}' \
-d '{
  "from": "{{BUSINESS-PHONE-NUMBER}}",
  "to": "{{CUSTOMER-PHONE-NUMBER}}",
  "type": "document",
  "document": {
    "link": "https://oss-ycloud-publicread.oss-ap-southeast-1.aliyuncs.com/api-docs/sample/sample.pdf",
    "caption": "Describes the specified media.",
    "filename": "Sample.pdf"
  }
}'

Ответ

{
  "id": "MESSAGE_ID",
  "status": "accepted"
}

Сохраните id и сопоставляйте последующие события whatsapp.message.updated.

Пояснение

Поддерживаемые типы документов: text/plain, application/pdf, application/vnd.ms-powerpoint, application/msword, application/vnd.ms-excel, application/vnd.openxmlformats-officedocument.wordprocessingml.document, application/vnd.openxmlformats-officedocument.presentationml.presentation, application/vnd.openxmlformats-officedocument.spreadsheetml.sheet.
Ограничение размера документа: 100 МБ.
См. также Поддерживаемые типы медиафайлов.
filename поддерживается только для сообщений с документами и не поддерживается для любых других медиасообщений.

Сообщение со стикером

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

Содержит URL-адрес стикера.

Запрос

curl 'https://api.ycloud.com/v2/whatsapp/messages/sendDirectly' \
-H 'Content-Type: application/json' \
-H 'X-API-Key: {{YOUR-API-KEY}}' \
-d '{
  "from": "{{BUSINESS-PHONE-NUMBER}}",
  "to": "{{CUSTOMER-PHONE-NUMBER}}",
  "type": "sticker",
  "sticker": {
    "link": "https://whatsticker.online/stickers_asset/ws-pack-196906m7W4ngr/c8e072f92595.webp"
  }
}'

Ответ

{
  "id": "MESSAGE_ID",
  "status": "accepted"
}

Сохраните id и сопоставляйте последующие события whatsapp.message.updated.

Пояснение

Поддерживаемые типы стикеров: image/webp. Ожидаемое разрешение: 512x512.
Ограничение размера стикера: 100 КБ для статичных стикеров и 500 КБ для анимированных стикеров.
См. также Поддерживаемые типы медиафайлов.

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

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

Содержит 1 контакт с адресами, днем рождения, адресами электронной почты, именем, номерами телефонов и т. д.

Запрос

curl 'https://api.ycloud.com/v2/whatsapp/messages/sendDirectly' \
-H 'Content-Type: application/json' \
-H 'X-API-Key: {{YOUR-API-KEY}}' \
-d '{
  "from": "{{BUSINESS-PHONE-NUMBER}}",
  "to": "{{CUSTOMER-PHONE-NUMBER}}",
  "type": "contacts",
  "contacts": [
    {
      "addresses": [
        {
          "street": "<ADDRESS_STREET>",
          "city": "<ADDRESS_CITY>",
          "state": "<ADDRESS_STATE>",
          "zip": "<ADDRESS_ZIP>",
          "country": "<ADDRESS_COUNTRY>",
          "country_code": "<ADDRESS_COUNTRY_CODE>",
          "type": "HOME"
        }
      ],
      "birthday": "2001-01-01",
      "emails": [
        {
          "email": "joe@example.com",
          "type": "WORK"
        }
      ],
      "name": {
        "formatted_name": "<CONTACT_FORMATTED_NAME>",
        "first_name": "<CONTACT_FIRST_NAME>",
        "last_name": "<CONTACT_LAST_NAME>",
        "middle_name": "<CONTACT_MIDDLE_NAME>",
        "suffix": "<CONTACT_SUFFIX>",
        "prefix": "<CONTACT_PREFIX>"
      },
      "org": {
        "company": "<CONTACT_ORG_COMPANY>",
        "department": "<CONTACT_ORG_DEPARTMENT>",
        "title": "<CONTACT_ORG_TITLE>"
      },
      "phones": [
        {
          "phone": "+447901614024",
          "wa_id": "447901614024",
          "type": "WORK"
        }
      ],
      "urls": [
        {
          "url": "<CONTACT_URL>",
          "type": "WORK"
        }
      ]
    }
  ]
}'

Ответ

{
  "id": "MESSAGE_ID",
  "status": "accepted"
}

Сохраните id и сопоставляйте последующие события whatsapp.message.updated.

Пояснение

Поле contacts[].name.formatted_name обязательно.

Сообщение с геопозицией

В этом случае вы отправляете сообщение с геопозицией:

Содержит широту и долготу места.
Содержит название и адрес места.

Запрос

curl 'https://api.ycloud.com/v2/whatsapp/messages/sendDirectly' \
-H 'Content-Type: application/json' \
-H 'X-API-Key: {{YOUR-API-KEY}}' \
-d '{
  "from": "{{BUSINESS-PHONE-NUMBER}}",
  "to": "{{CUSTOMER-PHONE-NUMBER}}",
  "type": "location",
  "location": {
    "latitude": 1.40435,
    "longitude": 103.79304,
    "name": "Singapore Zoo",
    "address": "80 Mandai Lake Road Singapore 72"
  }
}'

Ответ

{
  "id": "MESSAGE_ID",
  "status": "accepted"
}

Сохраните id и сопоставляйте последующие события whatsapp.message.updated.

Пояснение

Поля latitude и longitude обязательны.

Сообщение-реакция

В этом случае вы отправляете сообщение-реакцию в виде эмодзи:

Содержит ID упоминаемого сообщения.
Содержит эмодзи.

Ставит отметку «нравится» ранее отправленному или полученному сообщению.

Запрос

curl 'https://api.ycloud.com/v2/whatsapp/messages/sendDirectly' \
-H 'Content-Type: application/json' \
-H 'X-API-Key: {{YOUR-API-KEY}}' \
-d '{
  "from": "{{BUSINESS-PHONE-NUMBER}}",
  "to": "{{CUSTOMER-PHONE-NUMBER}}",
  "type": "reaction",
  "reaction": {
    "message_id": "wamid.BgNODYxN...",
    "emoji": "👍"
  }
}'

Ответ

{
  "id": "MESSAGE_ID",
  "status": "accepted"
}

Сохраните id и сопоставляйте последующие события whatsapp.message.updated.

Пояснение

Поле message_id — это исходный ID сообщения на платформе WhatsApp, начинающийся с wamid..
Установите для emoji значение "", если хотите удалить эмодзи.
Сообщения-реакции не поддерживают уведомления о прочтении.

Интерактивное сообщение со списком

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

Содержит текст заголовка, текст основного тела и текст нижнего колонтитула.
Устанавливает для interactive.type значение list, а также содержит кнопку с 2 разделами, где в каждом разделе по 2 строки.

Получатель может выбрать пункт из списка, нажав на кнопку:

Запрос

curl 'https://api.ycloud.com/v2/whatsapp/messages/sendDirectly' \
-H 'Content-Type: application/json' \
-H 'X-API-Key: {{YOUR-API-KEY}}' \
-d '{
  "from": "{{BUSINESS-PHONE-NUMBER}}",
  "to": "{{CUSTOMER-PHONE-NUMBER}}",
  "type": "interactive",
  "interactive": {
    "type": "list",
    "header": {
      "type": "text",
      "text": "<HEADER_TEXT>"
    },
    "body": {
      "text": "<BODY_TEXT>"
    },
    "footer": {
      "text": "<FOOTER_TEXT>"
    },
    "action": {
      "button": "<BUTTON_TEXT>",
      "sections": [
        {
          "title": "<LIST_SECTION_1_TITLE>",
          "rows": [
            {
              "id": "<LIST_SECTION_1_ROW_1_ID>",
              "title": "<SECTION_1_ROW_1_TITLE>",
              "description": "<SECTION_1_ROW_1_DESC>"
            },
            {
              "id": "<LIST_SECTION_1_ROW_2_ID>",
              "title": "<SECTION_1_ROW_2_TITLE>",
              "description": "<SECTION_1_ROW_2_DESC>"
            }
          ]
        },
        {
          "title": "<LIST_SECTION_2_TITLE>",
          "rows": [
            {
              "id": "<LIST_SECTION_2_ROW_1_ID>",
              "title": "<SECTION_2_ROW_1_TITLE>",
              "description": "<SECTION_2_ROW_1_DESC>"
            },
            {
              "id": "<LIST_SECTION_2_ROW_2_ID>",
              "title": "<SECTION_2_ROW_2_TITLE>",
              "description": "<SECTION_2_ROW_2_DESC>"
            }
          ]
        }
      ]
    }
  }
}'

Ответ

{
  "id": "MESSAGE_ID",
  "status": "accepted"
}

Сохраните id и сопоставляйте последующие события whatsapp.message.updated.

Пояснение

Для интерактивных сообщений типа list необходимо задать кнопку и от 1 до 10 разделов. Суммарно во всех разделах может быть до 10 строк.

Интерактивное сообщение с кнопками

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

Содержит основной текст.
Устанавливает для interactive.type значение button, а также содержит 2 кнопки быстрого ответа.

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

Запрос

curl 'https://api.ycloud.com/v2/whatsapp/messages/sendDirectly' \
-H 'Content-Type: application/json' \
-H 'X-API-Key: {{YOUR-API-KEY}}' \
-d '{
  "from": "{{BUSINESS-PHONE-NUMBER}}",
  "to": "{{CUSTOMER-PHONE-NUMBER}}",
  "type": "interactive",
  "interactive": {
    "type": "button",
    "body": {
      "text": "<BUTTON_TEXT>"
    },
    "action": {
      "buttons": [
        {
          "type": "reply",
          "reply": {
            "id": "<UNIQUE_BUTTON_ID_1>",
            "title": "<BUTTON_TITLE_1>"
          }
        },
        {
          "type": "reply",
          "reply": {
            "id": "<UNIQUE_BUTTON_ID_2>",
            "title": "<BUTTON_TITLE_2>"
          }
        }
      ]
    }
  }
}'

Ответ

{
  "id": "MESSAGE_ID",
  "status": "accepted"
}

Сохраните id и сопоставляйте последующие события whatsapp.message.updated.

Пояснение

Для интерактивных сообщений типа buttons можно задать не более 3 кнопок быстрого ответа.

Интерактивное сообщение с CTA URL

В этом случае вы отправляете интерактивное сообщение с кнопкой-призывом к действию (CTA URL):

Содержит заголовок, основной текст и нижний колонтитул.
Содержит кнопку со ссылкой (URL).

Запрос

curl 'https://api.ycloud.com/v2/whatsapp/messages/sendDirectly' \
-H 'Content-Type: application/json' \
-H 'X-API-Key: {{YOUR-API-KEY}}' \
-d '{
  "from": "{{BUSINESS-PHONE-NUMBER}}",
  "to": "{{CUSTOMER-PHONE-NUMBER}}",
  "type": "interactive",
  "interactive": {
    "type": "cta_url",
    "header": {
      "type": "image",
      "image": {
        "link": "https://oss-ycloud-publicread.oss-ap-southeast-1.aliyuncs.com/api-docs/sample/sample.jpg"
      }
    },
    "body": {
      "text": "<BODY_TEXT>"
    },
    "footer": {
      "text": "<FOOTER_TEXT>"
    },
    "action": {
      "name": "cta_url",
      "parameters": {
        "display_text": "See Docs",
        "url": "https://developers.facebook.com/docs/whatsapp"
      }
    }
  }
}'

Ответ

{
  "id": "MESSAGE_ID",
  "status": "accepted"
}

Сохраните id и сопоставляйте последующие события whatsapp.message.updated.

Пояснение

Текст кнопки должен быть длиной не более 20 байт.
Поля body и action обязательны. Поля header и footer необязательны.

Интерактивное сообщение с одним товаром

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

Содержит основной текст и текст нижнего колонтитула.
Устанавливает для interactive.type значение product, а также содержит действие с информацией о товаре.

Запрос

curl 'https://api.ycloud.com/v2/whatsapp/messages/sendDirectly' \
-H 'Content-Type: application/json' \
-H 'X-API-Key: {{YOUR-API-KEY}}' \
-d '{
  "from": "{{BUSINESS-PHONE-NUMBER}}",
  "to": "{{CUSTOMER-PHONE-NUMBER}}",
  "type": "interactive",
  "interactive": {
    "type": "product",
    "body": {
      "text": "<OPTIONAL_BODY_TEXT>"
    },
    "footer": {
      "text": "<OPTIONAL_FOOTER_TEXT>"
    },
    "action": {
      "catalog_id": "367025965434465",
      "product_retailer_id": "<ID_TEST_ITEM_1>"
    }
  }
}'

Ответ

{
  "id": "MESSAGE_ID",
  "status": "accepted"
}

Сохраните id и сопоставляйте последующие события whatsapp.message.updated.

Пояснение

Чтобы получить ID товара и каталога, перейдите в Meta Commerce Manager.
См. также Share Products With Customers.

Интерактивное сообщение с несколькими товарами

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

Содержит основной текст и текст нижнего колонтитула.
Устанавливает для interactive.type значение product_list, а также содержит несколько товаров.

Запрос

curl 'https://api.ycloud.com/v2/whatsapp/messages/sendDirectly' \
-H 'Content-Type: application/json' \
-H 'X-API-Key: {{YOUR-API-KEY}}' \
-d '{
  "from": "{{BUSINESS-PHONE-NUMBER}}",
  "to": "{{CUSTOMER-PHONE-NUMBER}}",
  "type": "interactive",
  "interactive": {
    "type": "product_list",
    "header": {
      "type": "text",
      "text": "<YOUR_TEXT_HEADER_CONTENT>"
    },
    "body": {
      "text": "<YOUR_TEXT_BODY_CONTENT>"
    },
    "footer": {
      "text": "<YOUR_TEXT_FOOTER_CONTENT>"
    },
    "action": {
      "catalog_id": "146265584024623",
      "sections": [
        {
          "title": "<SECTION1_TITLE>",
          "product_items": [
            {
              "product_retailer_id": "<YOUR_PRODUCT1_SKU_IN_CATALOG>"
            },
            {
              "product_retailer_id": "<YOUR_SECOND_PRODUCT1_SKU_IN_CATALOG>"
            }
          ]
        },
        {
          "title": "<SECTION2_TITLE>",
          "product_items": [
            {
              "product_retailer_id": "<YOUR_PRODUCT2_SKU_IN_CATALOG>"
            },
            {
              "product_retailer_id": "<YOUR_SECOND_PRODUCT2_SKU_IN_CATALOG>"
            }
          ]
        }
      ]
    }
  }
}'

Ответ

{
  "id": "MESSAGE_ID",
  "status": "accepted"
}

Сохраните id и сопоставляйте последующие события whatsapp.message.updated.

Пояснение

Чтобы получить ID товара и каталога, перейдите в Meta Commerce Manager.

Интерактивное сообщение с каталогом

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

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

Запрос

curl 'https://api.ycloud.com/v2/whatsapp/messages/sendDirectly' \
-H 'Content-Type: application/json' \
-H 'X-API-Key: {{YOUR-API-KEY}}' \
-d '{
  "from": "{{BUSINESS-PHONE-NUMBER}}",
  "to": "{{CUSTOMER-PHONE-NUMBER}}",
  "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!"
    }
  }
}'

Ответ

При успешном запросе возвращается объект сообщения YCloud. Начальный статус accepted подтверждает отправку, а не окончательную доставку.

{
  "id": "MESSAGE_ID",
  "status": "accepted"
}

Сохраните id и сопоставляйте последующие события whatsapp.message.updated.

Пояснение

У вас должны быть товары, загруженные в Meta, в каталоге электронной коммерции, подключенном к вашему WhatsApp Business Account.
Включите корзину покупок и каталог товаров отдельно для каждого бизнес-номера телефона. По умолчанию корзина покупок включена, а значок витрины скрыт для всех бизнес-номеров телефонов, связанных с WhatsApp Business Account. Используйте эндпоинт Update commerce settings, чтобы включить или отключить эти функции.

Интерактивное сообщение с запросом местоположения (Location Request)

Сообщения с запросом местоположения представляют собой сообщения свободной формы, содержащие основной текст и кнопку отправки местоположения. Когда пользователь WhatsApp нажимает кнопку, открывается экран отправки геопозиции, с помощью которого он может поделиться своим местоположением. example-messaging-location-request-sharing-response.png

example-messaging-location-request-sharing-response.png

Запрос

curl 'https://api.ycloud.com/v2/whatsapp/messages/sendDirectly' \
-H 'Content-Type: application/json' \
-H 'X-API-Key: {{YOUR-API-KEY}}' \
-d '{
  "from": "{{BUSINESS-PHONE-NUMBER}}",
  "to": "{{CUSTOMER-PHONE-NUMBER}}",
  "type": "interactive",
  "interactive": {
    "type": "location_request_message",
    "body": {
      "text": "<BODY_TEXT>"
    },
    "action": {
      "name": "send_location"
    }
  }
}'

Ответ

{
  "id": "MESSAGE_ID",
  "status": "accepted"
}

Сохраните id и сопоставляйте последующие события whatsapp.message.updated.

Пояснение

Основной текст (т. е. interactive.body) обязателен и не должен превышать 1024 символов. Заголовок (header) и нижний колонтитул (footer) не поддерживаются.
Как только пользователь поделится своим местоположением, срабатывает вебхук whatsapp.inbound_message.received, содержащий данные о местоположении пользователя. См. также Входящее сообщение с местоположением.

Интерактивное сообщение Flow

Вы можете отправить сообщение с Flow в диалоге, инициированном пользователем, используя сообщение с призывом к действию (CTA):

Запрос

curl 'https://api.ycloud.com/v2/whatsapp/messages/sendDirectly' \
-H 'Content-Type: application/json' \
-H 'X-API-Key: {{YOUR-API-KEY}}' \
-d '{
  "from": "{{BUSINESS-PHONE-NUMBER}}",
  "to": "{{CUSTOMER-PHONE-NUMBER}}",
  "type": "interactive",
  "interactive": {
    "type": "flow",
    "header": {
      "type": "text",
      "text": "Flow message header"
    },
    "body": {
      "text": "Flow message body"
    },
    "footer": {
      "text": "Flow message footer"
    },
    "action": {
      "name": "flow",
      "parameters": {
        "flow_message_version": "3",
        "flow_token": "AQAAAAACS5FpgQ_cAAAAAD0QI3s.",
        "flow_id": "1",
        "flow_cta": "Book!",
        "flow_action": "navigate",
        "flow_action_payload": {
          "screen": "<SCREEN_ID>",
          "data": {
            "product_name": "name",
            "product_description": "description",
            "product_price": 100
          }
        }
      }
    }
  }
}'

Ответ

{
  "id": "MESSAGE_ID",
  "status": "accepted"
}

Сохраните id и сопоставляйте последующие события whatsapp.message.updated.

Пояснение

Для отправки сообщения с Flow мы добавили новый тип объекта interactive под названием flow. Дополнительные сведения см. в разделе Параметры интерактивного сообщения.
Инструкции по отправке шаблонного сообщения с Flow см. в разделе Шаблонное сообщение Flow.
Инструкции по получению ответа Flow см. в разделе Входящее интерактивное ответное сообщение Flow.

Интерактивное сообщение с деталями заказа (Order Details)

Сообщение типа order_details — это новый вид сообщения interactive, который всегда содержит одни и те же 4 основных компонента: header, body, footer и action. В компоненте action компания указывает всю информацию, необходимую клиенту для совершения оплаты.

Запрос

curl 'https://api.ycloud.com/v2/whatsapp/messages/sendDirectly' \
-H 'Content-Type: application/json' \
-H 'X-API-Key: {{YOUR-API-KEY}}' \
-d '{
  "from": "{{BUSINESS-PHONE-NUMBER}}",
  "to": "{{CUSTOMER-PHONE-NUMBER}}",
  "type": "interactive",
  "interactive": {
    "type": "order_details",
    "header": {
      "type": "image",
      "image": {
        "link": "https://the-url",
        "provider": {
          "name": "provider-name"
        }
      }
    },
    "body": {
      "text": "your-text-body-content"
    },
    "footer": {
      "text": "your-text-footer-content"
    },
    "action": {
      "name": "review_and_pay",
      "parameters": {
        "reference_id": "reference-id-value",
        "type": "digital-goods",
        "payment_settings": [
          {
            "type": "payment_gateway",
            "payment_gateway": {
              "type": "billdesk",
              "configuration_name": "payment-config-id",
              "billdesk": {
                "additional_info1": "additional_info1-value",
                "additional_info2": "additional_info2-value",
                "additional_info3": "additional_info3-value",
                "additional_info4": "additional_info4-value",
                "additional_info5": "additional_info5-value",
                "additional_info6": "additional_info6-value",
                "additional_info7": "additional_info7-value",
              }
            }
          }
        ],
        "currency": "INR",
        "total_amount": {
          "value": 21000,
          "offset": 100
        },
        "order": {
          "status": "pending",
          "catalog_id": "the-catalog_id",
          "expiration": {
            "timestamp": "utc_timestamp_in_seconds",
            "description": "cancellation-explanation"
          },
          "items": [
            {
              "retailer_id": "1234567",
              "name": "Product name, for example bread",
              "amount": {
                "value": 10000,
                "offset": 100
              },
              "quantity": 1,
              "sale_amount": {
                "value": 100,
                "offset": 100
              }
            }
          ],
          "subtotal": {
            "value": 20000,
            "offset": 100
          },
          "tax": {
            "value": 1000,
            "offset": 100,
            "description": "optional_text"
          },
          "shipping": {
            "value": 1000,
            "offset": 100,
            "description": "optional_text"
          },
          "discount": {
            "value": 1000,
            "offset": 100,
            "description": "optional_text",
            "discount_program_name": "optional_text"
          }
        }
      }
    }
  }
}'

Ответ

{
  "id": "MESSAGE_ID",
  "status": "accepted"
}

Сохраните id и сопоставляйте последующие события whatsapp.message.updated.

Пояснение

Чтобы узнать больше о параметрах interactive, см. раздел Отправка интерактивного сообщения с деталями заказа.
Если с момента последнего ответа клиента на ваш бизнес-номер телефона прошло более 24 часов, отправьте взамен шаблонное сообщение с деталями заказа.

Интерактивное сообщение со статусом заказа (Order Status)

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

Запрос

curl 'https://api.ycloud.com/v2/whatsapp/messages/sendDirectly' \
-H 'Content-Type: application/json' \
-H 'X-API-Key: {{YOUR-API-KEY}}' \
-d '{
  "from": "{{BUSINESS-PHONE-NUMBER}}",
  "to": "{{CUSTOMER-PHONE-NUMBER}}",
  "type": "interactive",
  "interactive": {
    "type": "order_status",
    "body": {
      "text": "your-text-body-content"
    },
    "action": {
      "name": "review_order",
      "parameters": {
        "reference_id": "reference-id-value",
        "order": {
          "status": "processing | partially_shipped | shipped | completed | canceled",
          "description": "optional-text"
        }
      }
    }
  }
}'

Ответ

{
  "id": "MESSAGE_ID",
  "status": "accepted"
}

Сохраните id и сопоставляйте последующие события whatsapp.message.updated.

Пояснение

Чтобы узнать больше о параметрах interactive, см. раздел Отправка обновлений статуса заказа.
Если с момента последнего ответа клиента на ваш бизнес-номер телефона прошло более 24 часов, отправьте взамен шаблонное сообщение с деталями заказа.
Вы получите уведомление через webhooks, когда клиент предпримет попытку оплаты и статус платежа изменится. См. раздел Платежная транзакция обновлена.

Интерактивное сообщение с голосовым звонком (Voice Call)

Бизнес вызывает этот API для отправки сообщения клиентам, чтобы сообщить о возможности звонка в службу поддержки с помощью встроенной кнопки внутри сообщения. Когда пользователь нажимает эту кнопку, инициируется звонок в WhatsApp на бизнес-номер, отправивший это сообщение. Это поведение аналогично нажатию значка телефона/звонка в заголовке чата. Кнопка не поддерживает звонки в WhatsApp на другой номер телефона.

Запрос

curl 'https://api.ycloud.com/v2/whatsapp/messages/sendDirectly' \
-H 'Content-Type: application/json' \
-H 'X-API-Key: {{YOUR-API-KEY}}' \
-d '{
  "from": "{{BUSINESS-PHONE-NUMBER}}",
  "to": "{{CUSTOMER-PHONE-NUMBER}}",
  "type": "interactive",
  "interactive": {
    "type": "voice_call",
    "body": {
      "text": "You can call us on WhatsApp now for faster service!"
    },
    "action": {
      "name": "voice_call",
      "parameters": {
        "display_text": "Call on WhatsApp"
      }
    }
  }
}'

Ответ

{
  "id": "MESSAGE_ID",
  "status": "accepted"
}

Сохраните id и сопоставляйте последующие события whatsapp.message.updated.

Пояснение

Сопоставьте поля запроса с выбранным типом сообщения и используйте возвращенный ID сообщения для сопоставления статусов.

Интерактивные сообщения-карусели с медиа

Интерактивное медиасообщение-карусель позволяет компаниям отправлять карточки с изображениями или видео, прокручиваемые по горизонтали, каждая из которых содержит кнопку с призывом к действию, прямо в чатах WhatsApp. Этот формат дает пользователям возможность просматривать несколько предложений или материалов в одном сообщении, обеспечивая богатый и вовлекающий опыт взаимодействия через WhatsApp Business API и мобильные клиенты.

interactive.type должно быть carousel
interactive.action.cards необходимо добавить в сообщение как минимум 2 объекта карточек и не более 10.
Тип каждой карточки должен быть установлен на cta_url
все карточки должны иметь одинаковый тип заголовка (image или video)
необходимо добавить тело сообщения (interactive.body) в сообщение (максимум 1024 символа). Заголовок, подвал или кнопки вне карточек не допускаются.
все карточки должны иметь одинаковую структуру (заголовок, тело, действие).
тело карточки необязательно, но содержит максимум 160 символов и до 2 переносов строк.

f657ef005148593d05cc1ded201de7731d11b51200fd4900ad2584533ddd282d-interactive_media_carousel_message.jpg

Запрос

curl 'https://api.ycloud.com/v2/whatsapp/messages/sendDirectly' \
-H 'Content-Type: application/json' \
-H 'X-API-Key: {{YOUR-API-KEY}}' \
-d '{
  "from": "{{BUSINESS-PHONE-NUMBER}}",
  "to": "{{CUSTOMER-PHONE-NUMBER}}",
  "type": "interactive",
  "interactive": {
    "type": "carousel",
    "body": {
      "text": "Check out our latest offers!"
    },
    "action": {
      "cards": [
        {
          "card_index": 0,
          "type": "cta_url",
          "header": {
            "type": "image",
            "image": {
              "link": "https://oss-ycloud-publicread.oss-ap-southeast-1.aliyuncs.com/api-docs/sample/sample.jpg"
            }
          },
          "body": {
            "text": "Exclusive deal #1"
          },
          "action": {
            "name": "cta_url",
            "parameters": {
              "display_text": "Shop now",
              "url": "https://shop.example.com/deal1"
            }
          }
        },
        {
          "card_index": 1,
          "type": "cta_url",
          "header": {
            "type": "image",
            "image": {
              "link": "https://oss-ycloud-publicread.oss-ap-southeast-1.aliyuncs.com/api-docs/sample/sample.jpg"
            }
          },
          "body": {
            "text": "Exclusive deal #2"
          },
          "action": {
            "name": "cta_url",
            "parameters": {
              "display_text": "Shop now",
              "url": "https://shop.example.com/deal2"
            }
          }
        }
      ]
    }
  }
}'

Ответ

При успешном запросе возвращается объект сообщения YCloud. Начальный статус accepted подтверждает отправку, но не окончательную доставку.

{
  "id": "MESSAGE_ID",
  "status": "accepted"
}

Сохраните id для последующего сопоставления с событиями whatsapp.message.updated.

Пояснение

Интерактивные медиасообщения-карусели с кнопками быстрого ответа

Карточки должны содержать либо одну кнопку URL, либо одну или несколько кнопок быстрого ответа. Типы и количество кнопок должны совпадать во всех карточках (например, если вы определили карточку с 2 кнопками быстрого ответа, все карточки должны содержать ровно по 2 кнопки быстрого ответа).

a604f0105ba6b8dfa01f317ce10c2cb3961f1564a6cf12c9bede2eac57a11808-carousel_quick_reply.png

Запрос

curl 'https://api.ycloud.com/v2/whatsapp/messages/sendDirectly' \
-H 'Content-Type: application/json' \
-H 'X-API-Key: {{YOUR-API-KEY}}' \
-d '{
  "from": "{{BUSINESS-PHONE-NUMBER}}",
  "to": "{{CUSTOMER-PHONE-NUMBER}}",
  "type": "interactive",
  "interactive": {
    "type": "carousel",
    "body": {
      "text": "Check out our latest offers!"
    },
    "action": {
      "cards": [
        {
          "card_index": 0,
          "type": "cta_url",
          "header": {
            "type": "image",
            "image": {
              "link": "https://oss-ycloud-publicread.oss-ap-southeast-1.aliyuncs.com/api-docs/sample/sample.jpg"
            }
          },
          "body": {
            "text": "Exclusive deal #1"
          },
          "action": {
            "buttons": [
              {
                "type": "quick_reply",
                "quick_reply": {
                  "id": "learn-zebra-haworthia",
                  "title": "Learn more"
                }
              },
              {
                "type": "quick_reply",
                "quick_reply": {
                  "id": "fav-zebra-haworthia",
                  "title": "Add to favorites"
                }
              }
            ]
          }
        },
        {
          "card_index": 1,
          "type": "cta_url",
          "header": {
            "type": "image",
            "image": {
              "link": "https://oss-ycloud-publicread.oss-ap-southeast-1.aliyuncs.com/api-docs/sample/sample.jpg"
            }
          },
          "body": {
            "text": "Exclusive deal #2"
          },
          "action": {
            "buttons": [
              {
                "type": "quick_reply",
                "quick_reply": {
                  "id": "learn-zebra-haworthia",
                  "title": "Learn more"
                }
              },
              {
                "type": "quick_reply",
                "quick_reply": {
                  "id": "fav-zebra-haworthia",
                  "title": "Add to favorites"
                }
              }
            ]
          }
        }
      ]
    }
  }
}'

Ответ

{
  "id": "MESSAGE_ID",
  "status": "accepted"
}

Сохраните id для последующего сопоставления с событиями whatsapp.message.updated.

Пояснение

Сообщение с кнопкой оформления заказа

После одобрения шаблона кнопки оформления заказа вы можете отправить его в шаблонном сообщении

Запрос

curl 'https://api.ycloud.com/v2/whatsapp/messages/sendDirectly' \
-H 'Content-Type: application/json' \
-H 'X-API-Key: {{YOUR-API-KEY}}' \
-d '{
  "from": "{{BUSINESS-PHONE-NUMBER}}",
  "to": "{{CUSTOMER-PHONE-NUMBER}}",
  "type": "template",
  "template": {
    "name": "item_back_in_stock_v1",
    "language": {
      "code": "{{LANGUAGE-CODE}}",
      "policy": "deterministic",

    },
    "components": [
      {
        "type": "header",
        "parameters": [
          {
            "type": "image",
            "image": {
              "id": "12312312", <!-- Only if using uploaded media -->
              "link": "https://oss-ycloud-publicread.oss-ap-southeast-1.aliyuncs.com/api-docs/sample/sample.jpg" <!-- Only if using hosted media (not recommended) -->
            }
          }
        ]
      },
      {
        "type": "body",
        "parameters": [
          {
            "type": "text",
            "text": "Nidhi"
          },
          {
            "type": "text",
            "text": "Blue Elf Aloe"
          }
        ]
      },
      {
        "type": "button",
        "sub_type": "order_details",
        "index": 0,
        "parameters": [
          {
            "type": "action",
            "action": {
              "order_details": {
                "reference_id": "abc.123_xyz-1",
                "type": "physical-goods",
                "currency": "INR",
                "payment_settings": [
                  {
                    "type": "payment_gateway",
                    "payment_gateway": {
                      "type": "razorpay",
                      "configuration_name": "prod-razor-pay-config-05"
                    }
                  }
                ],
                "shipping_info": {
                  "country": "IN",
                  "addresses": [
                    {
                      "name": "Nidhi Tripathi",
                      "phone_number": "919000090000",
                      "address": "Bandra Kurla Complex",
                      "city": "Mumbai",
                      "state": "Maharastra",
                      "in_pin_code": "400051",
                      "house_number": "12",
                      "tower_number": "5",
                      "building_name": "One BKC",
                      "landmark_area": "Near BKC Circle"
                    }
                  ]
                },
                "order": {
                  "items": [
                    {
                      "amount": {
                        "offset": 100,
                        "value": 200000
                      },
                      "sale_amount": {
                        "offset": 100,
                        "value": 150000
                      },
                      "name": "Blue Elf Aloe",
                      "quantity": 1,
                      "country_of_origin": "India",
                      "importer_name": "Lucky Shrub Imports and Exports",
                      "importer_address": {
                        "address_line1": "One BKC",
                        "address_line2": "Bandra Kurla Complex",
                        "city": "Mumbai",
                        "zone_code": "MH",
                        "postal_code": "400051",
                        "country_code": "IN"
                      }
                    }
                  ],
                  "subtotal": {
                    "offset": 100,
                    "value": 150000
                  },
                  "shipping": {
                    "offset": 100,
                    "value": 20000
                  },
                  "tax": {
                    "offset": 100,
                    "value": 10000
                  },
                  "discount": {
                    "offset": 100,
                    "value": 15000,
                    "description": "Additional 10% off"
                  },
                  "status": "pending",
                  "expiration": {
                    "timestamp": "1726627150"
                  }
                },
                "total_amount": {
                  "offset": 100,
                  "value": 165000
                }
              }
            }
          }
        ]
      }
    ]
  }
}'

Ответ

{
  "id": "MESSAGE_ID",
  "status": "accepted"
}

Сохраните id для последующего сопоставления с событиями whatsapp.message.updated.

Пояснение

Шаблонное сообщение с GIF

В этом случае вы отправляете шаблонное сообщение с GIF:

Содержит URL GIF-анимации.

d29ea20d56e36017614121fc2079e5c513d6f922c3713a2c963e3dfca7570c0c-Feishu20260128-162503.gif

Запрос

curl 'https://api.ycloud.com/v2/whatsapp/messages/sendDirectly' \
-H 'Content-Type: application/json' \
-H 'X-API-Key: {{YOUR-API-KEY}}' \
-d '{
  "from": "{{BUSINESS-PHONE-NUMBER}}",
  "to": "{{CUSTOMER-PHONE-NUMBER}}",
  "type": "template",
  "template": {
    "name": "marketing_friday_more",
    "language": {
      "code": "{{LANGUAGE-CODE}}",
      "policy": "deterministic"
    },
    "components": [
      {
        "type": "header",
        "parameters": [
          {
            "type": "gif",
            "gif": {
              "link": "https://oss-ycloud-publicread.oss-ap-southeast-1.aliyuncs.com/api-docs/sample/sample.mp4"
            }
          }
        ]
      }
    ]
  }
}'

Ответ

{
  "id": "MESSAGE_ID",
  "status": "accepted"
}

Сохраните id для последующего сопоставления с событиями whatsapp.message.updated.

​Что это такое

​Перед началом работы

​Как это работает

​Запрос

​Ответ

​Выберите пример

Шаблонные сообщения

Сообщения произвольного формата

Интерактивные сообщения

Торговые сообщения

​Примеры шаблонных сообщений

​Шаблонное сообщение аутентификации с кнопками одноразового пароля

​Запрос

​Ответ

​Объяснение

​Шаблонное сообщение с переменными

​Запрос

​Ответ

​Объяснение

​Шаблонное сообщение с изображением и кнопками Quick Reply

​Запрос

​Ответ

​Объяснение

​Шаблонное сообщение с видео и кнопками с призывом к действию (Call To Action)

​Запрос

​Ответ

​Пояснение

​Шаблонное сообщение с купоном

​Запрос

​Ответ

​Пояснение

​Шаблонное сообщение с геопозицией

​Запрос

​Ответ

​Пояснение

​Шаблонное сообщение с ограниченным по времени предложением

​Запрос

​Ответ

​Пояснение

​Шаблонное сообщение с каруселью

​Запрос

​Ответ

​Пояснение

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

​Запрос

​Ответ

​Пояснение

​Шаблонное сообщение MPM

​Запрос

​Ответ

​Пояснение

​Шаблонное сообщение Flow

​Запрос

​Ответ

​Пояснение

​Шаблонное сообщение с деталями заказа

​Запрос

​Ответ

​Пояснение

​Шаблонное сообщение со статусом заказа

​Запрос

​Ответ

​Пояснение

​Примеры сообщений в свободной форме

​Текстовое сообщение

​Запрос

​Ответ

​Пояснение

​Сообщение с изображением

​Запрос

​Ответ

​Пояснение

​Видеосообщение

​Запрос

​Ответ

​Пояснение

​Аудиосообщение

​Запрос

​Ответ

​Пояснение

Что это такое

Перед началом работы

Как это работает

Запрос

Ответ

Выберите пример

Примеры шаблонных сообщений

Шаблонное сообщение аутентификации с кнопками одноразового пароля

Запрос

Ответ

Объяснение

Шаблонное сообщение с переменными

Запрос

Ответ

Объяснение

Шаблонное сообщение с изображением и кнопками Quick Reply

Запрос

Ответ

Объяснение

Шаблонное сообщение с видео и кнопками с призывом к действию (Call To Action)

Запрос

Ответ

Пояснение

Шаблонное сообщение с купоном

Запрос

Ответ

Пояснение

Шаблонное сообщение с геопозицией

Запрос

Ответ

Пояснение

Шаблонное сообщение с ограниченным по времени предложением

Запрос

Ответ

Пояснение

Шаблонное сообщение с каруселью

Запрос

Ответ

Пояснение

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

Запрос

Ответ

Пояснение

Шаблонное сообщение MPM

Запрос

Ответ

Пояснение

Шаблонное сообщение Flow

Запрос

Ответ

Пояснение

Шаблонное сообщение с деталями заказа

Запрос

Ответ

Пояснение

Шаблонное сообщение со статусом заказа

Запрос

Ответ

Пояснение

Примеры сообщений в свободной форме

Текстовое сообщение

Запрос

Ответ

Пояснение

Сообщение с изображением

Запрос

Ответ

Пояснение

Видеосообщение

Запрос

Ответ

Пояснение

Аудиосообщение

Запрос

Ответ

Пояснение

Сообщение с документом

Запрос

Ответ

Пояснение