> ## Documentation Index
> Fetch the complete documentation index at: https://docs.ycloud.com/llms.txt
> Use this file to discover all available pages before exploring further.
# Modelos de mensagem de oferta por tempo limitado
> Apresente uma oferta de marketing com prazo determinado e teste o comportamento de expiração antes de enviar.
Um modelo de mensagem de oferta por tempo limitado apresenta uma promoção de marketing com indicação de expiração e, quando configurado, um código de oferta que pode ser copiado.
Fonte: [Exemplo oficial da Meta](https://developers.facebook.com/documentation/business-messaging/whatsapp/templates/marketing-templates/limited-time-offer-templates/).
Use-o quando a oferta tiver um prazo real. A expiração visual da mensagem é um sinal visível para o cliente; seu sistema de promoções deve aplicar as regras reais de resgate.
## Prepare a oferta antes do modelo
Defina:
* O benefício e os produtos ou serviços qualificados.
* O horário de início e término, incluindo o fuso horário comercial.
* Se o código é compartilhado ou específico para cada destinatário.
* A página de destino suportada ou o fluxo de resgate.
* O que os clientes veem se abrirem a oferta após a expiração.
* Quanto tempo reservar para possíveis atrasos na entrega.
Não envie uma oferta minutos antes do prazo final se um cliente razoável não conseguir concluí-la a tempo.
## Configure a estrutura aprovada
No editor de modelos de marketing da YCloud, selecione o formato de oferta por tempo limitado suportado e configure o cabeçalho, corpo, detalhes da oferta e botões disponíveis.
A criação estabelece o componente de oferta e se ele inclui informações de expiração. O envio fornece o valor de expiração ativo e quaisquer variáveis de código, mídia ou corpo.
Se tanto o corpo quanto o botão de cópia contiverem o código, torne-os idênticos. Uma contagem regressiva não corrige datas contraditórias escritas no corpo.
## Use milissegundos para a expiração via API
No contrato de envio da YCloud, o parâmetro de oferta por tempo limitado utiliza `expiration_time_ms`: um **timestamp UNIX absoluto em milissegundos**.
Não se trata de uma duração como “24 horas”, nem de um timestamp UNIX em segundos.
Por exemplo, **30 de setembro de 2026 às 16:00 UTC** possui um timestamp em milissegundos de `1790784000000`. O seguinte é um **fragmento de componente**, e não uma solicitação completa:
```json theme={"theme":{"light":"github-light","dark":"github-dark"}}
{
"type": "limited_time_offer",
"parameters": [
{
"type": "limited_time_offer",
"limited_time_offer": {
"expiration_time_ms": 1790784000000
}
}
]
}
```
Gere esse valor a partir de uma data ciente do fuso horário no seu sistema de envio. Valide-o em relação ao seu banco de dados de promoções e verifique se ele ainda está no futuro antes de enviar.
## Teste os dois lados do prazo final
Teste antes da expiração, próximo da expiração e depois dela. Verifique o prazo exibido, o código copiado, o destino e o resultado do resgate no servidor. A renderização pode variar de acordo com o aplicativo do WhatsApp, portanto inclua as plataformas de telefone usadas pelo seu público.
Se a mensagem parecer expirada imediatamente, inspecione primeiro as unidades de timestamp, a conversão de fuso horário e o prazo de origem. Se o resgate ainda funcionar após a expiração, corrija o sistema de promoções; alterar apenas a exibição da mensagem não aplica as regras da oferta.
## Envie e mensure
Após a aprovação, use um fluxo de trabalho suportado de [Campanha](/pt/documentation/campaign/create-a-whatsapp-marketing-campaign), [Inbox](/pt/documentation/inbox/initiate-new-chat) ou [API](/pt/api-reference/guides/whatsapp-platform/send-whatsapp-message).
Aplique os [controles de entrega e consentimento de marketing](/pt/documentation/whatsapp-business-platform/messaging/message-templates/marketing-templates). Mensure separadamente as mensagens entregues, as visitas de destino e os resgates bem-sucedidos.
Fonte: [Modelos de mensagem de oferta por tempo limitado da Meta](https://developers.facebook.com/docs/whatsapp/business-management-api/message-templates/limited-time-offer-templates/).
This documentation is built and hosted on [Mintlify](https://mintlify.com), a developer documentation platform.