> ## 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 código de cupom
> Permita que os clientes copiem um código de oferta a partir de uma mensagem de marketing.
Um modelo de código de cupom é uma mensagem de marketing com um botão que copia um código promocional para a área de transferência do cliente.
Fonte: [Exemplo oficial da Meta](https://developers.facebook.com/documentation/business-messaging/whatsapp/templates/marketing-templates/coupon-templates/).
## Torne a oferta compreensível
Inclua o benefício, onde o código pode ser usado e as condições importantes. Por exemplo:
> Economize 15% em malas de viagem selecionadas com o código TRAVEL15. Válido até 30 de setembro em pedidos acima de \$50. Consulte os itens elegíveis e os termos completos em nossa página de ofertas.
Este é um texto ilustrativo, não uma afirmação de que toda promoção ou produto é elegível.
Decida se o código é compartilhado, de uso único ou específico para o cliente. Seu sistema de promoções — não o WhatsApp — aplica o pedido mínimo, produtos elegíveis, limite de resgate e expiração.
## Configurar o modelo
1. Selecione a WABA desejada e um modelo de **Marketing** .
2. Escreva o corpo e forneça exemplos realistas para as variáveis.
3. Adicione o botão suportado para copiar código.
4. Adicione um destino ou instruções explicando onde resgatar a oferta.
5. Envie e aguarde a aprovação.
O modelo define o botão e o exemplo para análise. A solicitação de envio fornece o código promocional real. Se o corpo também exibir o código, forneça o mesmo valor em ambos os locais.
Para envio via API, o botão usa o subtipo `copy_code` com um parâmetro do tipo `coupon_code`. Isso difere do comportamento especial de envio de botão OTP dos modelos de autenticação.
Exemplo de **componente de botão no momento do envio apenas**:
```json theme={"theme":{"light":"github-light","dark":"github-dark"}}
{
"type": "button",
"sub_type": "copy_code",
"index": 0,
"parameters": [
{ "type": "coupon_code", "coupon_code": "TRAVEL15" }
]
}
```
Use a posição real do botão baseada em zero; `0` significa o primeiro botão. Este fragmento não inclui o envelope de mensagem obrigatório nem quaisquer parâmetros do corpo.
## Limites e comportamento do cliente
A documentação atual de modelos de cupom da Meta especifica um botão de copiar código, um rótulo de botão controlado pelo sistema e um máximo de 20 caracteres para o código de exemplo. O campo OpenAPI da YCloud não declara seu próprio limite máximo de comprimento de código; se o seu editor aplicar um limite inferior, use esse limite suportado e confirme qualquer divergência antes do envio.
A Meta também documenta que esse formato não é compatível com o cliente web do WhatsApp. Teste a experiência no celular; não aprove o design apenas a partir de uma conversa no desktop.
Use um código curto e inequívoco. Evite expor credenciais de conta, códigos de autenticação ou informações pessoais como códigos promocionais.
## Teste o resgate, não apenas a cópia
Verifique se o valor copiado corresponde ao corpo, se a página da oferta o aceita, se carrinhos elegíveis e não elegíveis se comportam corretamente e se códigos expirados ou já utilizados são rejeitados de forma adequada.
Monitore a entrega de mensagens e o resgate real separadamente. A interação com o botão de cópia não é prova de uma compra.
Continue com [Modelos de marketing](/pt/documentation/whatsapp-business-platform/messaging/message-templates/marketing-templates), [Gerenciar modelos](/pt/api-reference/guides/whatsapp-platform/manage-whatsapp-templates) e [Enviar mensagens do WhatsApp](/pt/api-reference/guides/whatsapp-platform/send-whatsapp-message).
Fonte: [Modelos de código de cupom da Meta](https://developers.facebook.com/docs/whatsapp/business-management-api/message-templates/coupon-templates/).
This documentation is built and hosted on [Mintlify](https://mintlify.com), a developer documentation platform.