Шаблон Акции по времени (Limited-Time Offer)

Limited-Time Offer Templates — это маркетинговые шаблоны WhatsApp, которые позволяют отправлять сообщения с ограниченными по времени акциями. Такие шаблоны показывают дату истечения предложения и работающий таймер обратного отсчета прямо в сообщении, стимулируя клиентов успеть воспользоваться предложением до его окончания.

После истечения даты нельзя скопировать код.

Основные особенности

• Категория: только MARKETING.

• Поддержка таймера обратного отсчета и expiration details, если включено.

• Footer (подвал) не поддерживается.

• При просмотре в WhatsApp Web или Desktop приложение таймер/предложение не отображается — пользователю будет показано общее уведомление.

Создание шаблона "Limited-Time Offer"

Создание шаблона описано в документации API в методе /addTemplate.

Пример создания шаблона "Limited-Time Offer"

POST https://api.1msg.io/{{channel}}/addTemplate
Content-Type: application/json
Body:{
  "name": "limited_time_offer_caribbean_pkg_2023",
  "category": "MARKETING",
  "language": "en_US",
  "components": [
    {
      "type": "header",
      "format": "image",
      "example": {
        "header_handle": [
          "https://placehold.co/800x600.jpg"
        ]
      }
    },
    {
      "type": "limited_time_offer",
      "limited_time_offer": {
        "text": "Expiring offer!",
        "has_expiration": true
      }
    },
    {
      "type": "body",
      "text": "Good news, {{1}}! Use code {{2}} to get 25% off all Caribbean Destination packages!",
      "example": {
        "body_text": [
          [
            "Pablo",
            "CARIBE25"
          ]
        ]
      }
    },
    {
      "type": "buttons",
      "buttons": [
        {
          "type": "copy_code",
          "example": "CARIBE25"
        },
        {
          "type": "url",
          "text": "Book now!",
          "url": "https://awesomedestinations.com/offers?code={{1}}",
          "example": [
            "https://awesomedestinations.com/offers?code=n3mtql"
          ]
        }
      ]
    }
  ]
}

Отправить шаблон "Limited-Time Offer"

Отправка шаблона описана в документации API в методе /sendTemplate.

Пример отправки шаблона "Limited-Time Offer"

expiration_time_ms — показывает дату истечения акции. После этой даты нельзя скопировать код.

POST https://api.1msg.io/{{channel}}/sendTemplate
Content-Type: application/json
Body: {
  "template": "limited_time_offer_caribbean_pkg_2023",
  "language": {
    "policy": "deterministic",
    "code": "en_US"
  },
  "namespace": "{{namespace}}",
  "params": [
    {
      "type": "header",
      "parameters": [
        {
          "type": "image",
          "image": {
            "link": "https://placehold.co/800x600.jpg"
          }
        }
      ]
    },
    {
      "type": "body",
      "parameters": [
        {
          "type": "text",
          "text": "Pablo"
        },
        {
          "type": "text",
          "text": "CARIBE25"
        }
      ]
    },
    {
      "type": "limited_time_offer",
      "parameters": [
        {
          "type": "limited_time_offer",
          "limited_time_offer": {
            "expiration_time_ms": 1798562800000
          }
        }
      ]
    },
    {
      "type": "button",
      "sub_type": "copy_code",
      "index": 0,
      "parameters": [
        {
          "type": "coupon_code",
          "coupon_code": "CARIBE25"
        }
      ]
    },
    {
      "type": "button",
      "sub_type": "url",
      "index": 1,
      "parameters": [
        {
          "type": "text",
          "text": "n3mtql"
        }
      ]
    }
  ],
  "phone": "XXXXXXXXXXX"
}