> ## Documentation Index
> Fetch the complete documentation index at: https://knowledge.flowella.io/llms.txt
> Use this file to discover all available pages before exploring further.

# Modelos de código de cupão WhatsApp: botões de copiar

> Como funcionam os modelos de código de cupão WhatsApp, os seus limites, onde define o código real ao enviar a partir do Flowella e um exemplo para copiar.

Um modelo de código de cupão é um modelo de marketing com um botão de **copiar código**. Quando o cliente toca nele, o WhatsApp copia o seu código de desconto para a área de transferência, pronto a colar no checkout. O código que introduz ao criar o modelo é apenas um exemplo para a revisão da Meta. Define o código real em cada envio, por isso cada cliente pode receber um diferente.

> [!NOTE]
>
> **No Flowella.** Suportado em parte. O editor adiciona um botão **Copy coupon code** aos modelos Marketing, e pode enviar o código real a partir da Caixa de entrada, de um envio de teste ou da [API do Flowella](https://knowledge.flowella.io/pt/api-reference/introduction.md). O envio em massa e as ações de workflow do HubSpot não permitem definir um código, por isso não podem enviar modelos de cupão.

## Limites

| Regra | Limite |
| - | - |
| Categoria | Apenas Marketing |
| Botões de copiar código por modelo | 1 |
| Comprimento do código | Até 20 caracteres |
| Texto do botão | Definido pelo WhatsApp. Não o pode alterar. |
| Outros botões | Permitidos em conjunto, por exemplo um botão de resposta rápida ou de URL, dentro do total de 10 botões |
| WhatsApp Web e desktop | O botão não é suportado aí. O cliente precisa da app do telemóvel. |

> [!NOTE]
>
> **No Flowella.** O código de exemplo do editor aceita apenas letras e números, até 20 caracteres. No envio, o Flowella aceita qualquer código até 20 caracteres.

## O que é definido e quando

| Quando cria o modelo | Quando o envia |
| - | - |
| Cabeçalho, texto do corpo e botões | O código de cupão real para o botão de copiar código |
| Um código de exemplo, para a revisão | Valores para as variáveis do corpo, como o nome do cliente ou o código mostrado no texto |

Se o corpo também mostrar o código, por exemplo `Use code {{2}} at checkout`, preencha essa variável com o mesmo valor do botão, caso contrário o cliente vê dois códigos diferentes.

## Criar um no Flowella

**1. Crie um modelo Marketing**

Na página **Templates**, clique em **New template**, depois em **Build your own** e **Standard message**. Defina a categoria como **Marketing**.

**2. Escreva o corpo**

Explique a oferta, quando termina e como usar o código. Reserve as variáveis para os detalhes que mudam de cliente para cliente.

**3. Adicione o botão**

Adicione um botão **Copy coupon code** e introduza um exemplo em **Coupon code**, como `WINTER25`. Para facilitar o opt-out, adicione um botão **Quick Reply** com uma palavra-chave de opt-out, como `Stop`. Consulte [Como funcionam os opt-outs por palavra-chave](https://knowledge.flowella.io/pt/app/opt-outs.md#how-keyword-opt-outs-work).

**4. Publique**

Clique em **Publish Template**. A Meta revê-o como qualquer modelo de marketing.

## Exemplo prático

Um modelo de saldos de inverno, com uma variável do corpo para o nome próprio e outra para o código:

```text theme={null}
Our winter sale is on

Hi {{1}}, enjoy 25% off your next order with code {{2}}. Tap the button to copy it, then paste it at checkout. Ends 31 January.

[Copy code button]   [Stop]
```

| Campo | Exemplo para a revisão | Valor real no envio |
| - | - | - |
| `{{1}}` | `Priya` | O nome próprio do contacto |
| `{{2}}` | `WINTER25` | O código que emite, por exemplo `WINTER-7F3K` |
| Botão de código de cupão | `WINTER25` | O mesmo código, `WINTER-7F3K` |

## Enviar o código real

* **Caixa de entrada**: quando escolhe o modelo numa conversa, preencha o código em **Coupon code buttons**.
* **Envio de teste**: preencha **Coupon code buttons** no painel de teste do modelo.
* **API**: chame `POST /v1/templates/send` e passe o código em `buttonParameters`, com o índice do botão de copiar código e `subType` definido como `copy_code`. Use isto para enviar códigos únicos a partir do seu próprio sistema, com um valor para cada destinatário.

Se não for indicado nenhum código, o Flowella recusa o envio antes de chegar à Meta e pede um código de cupão.

## Boas práticas

* **Use códigos de utilização única** sempre que possível, para que uma captura de ecrã partilhada não esgote a oferta.
* **Indique a data de validade** no corpo. Um modelo de cupão não tem contagem decrescente. Para isso, a Meta oferece [modelos de oferta por tempo limitado](https://knowledge.flowella.io/pt/whatsapp/templates/limited-time-offer-templates.md), que o Flowella não suporta.
* **Lembre-se dos utilizadores do WhatsApp Web.** Não podem usar o botão, por isso mostre também o código no corpo.

## Relacionado

> [card] [Modelos de marketing](https://knowledge.flowella.io/pt/whatsapp/templates/marketing-templates.md)
>
> Opt-in, limites e outros tipos de marketing.

> [card] [Referência de modelos](https://knowledge.flowella.io/pt/app/template-reference.md#buttons)
>
> Todos os tipos de botão e limites do editor.

> [card] [Testar um modelo](https://knowledge.flowella.io/pt/app/templates.md#test-a-template)
>
> Envie primeiro um modelo de cupão para si.

> [card] [Variáveis de modelo](https://knowledge.flowella.io/pt/app/template-variables.md)
>
> Preencha nomes e códigos.

Verificado com a documentação da Meta a 18 de novembro de 2026: [Coupon code templates](https://developers.facebook.com/documentation/business-messaging/whatsapp/templates/marketing-templates/coupon-templates) e [Template components](https://developers.facebook.com/documentation/business-messaging/whatsapp/templates/components).


This documentation is built and hosted on [Mintlify](https://mintlify.com), a developer documentation platform.