> For the complete documentation index, see [llms.txt](https://help.1msg.io/docs/llms.txt). Markdown versions of documentation pages are available by appending `.md` to page URLs; this page is available as [Markdown](https://help.1msg.io/docs/russkii/api-1msg/shablony-waba/shablon-akcii-po-vremeni-limited-time-offer.md).

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

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

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

<figure><img src="https://1775018921-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2FoCNwQHK1ya1FkEe495Vr%2Fuploads%2Fx39L87oGH9ld9DVzFCoa%2Fimage.png?alt=media&amp;token=71c0e34e-cf80-4015-b704-ddb2b7b5d7a0" alt=""><figcaption></figcaption></figure>

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

* **Категория:** только `MARKETING`.
* Поддержка **таймера обратного отсчета** и **expiration details**, если включено.
* **Footer (подвал)** не поддерживается.
* При просмотре в WhatsApp Web или Desktop приложение таймер/предложение **не отображается** — пользователю будет показано общее уведомление.

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

Создание шаблона описано[ в документации API ](https://1msg-docs.web.app/ru#tag/Shablony/operation/addTemplate)в методе /addTemplate.

<details>

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

```json
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"
          ]
        }
      ]
    }
  ]
}


```

</details>

## Отправить шаблон "**Limited-Time Offer**" <a href="#kak-otpravit-shablon-katalog" id="kak-otpravit-shablon-katalog"></a>

Отправка шаблона описана [ в документации API ](https://1msg-docs.web.app/ru#tag/Shablony/operation/sendTemplate)в методе /sendTemplate.

<details>

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

expiration\_time\_ms — показывает дату истечения акции. После этой даты нельзя скопировать код.&#x20;

```json
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"
}


        
```

</details>