> ## 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.

# Uso da ferramenta de cupons

Carregue códigos de cupom, limite a um código por cliente e distribua os códigos por meio de um Agente baseado em regras, Caixa de entrada ou Campanha.

## Cenários de uso

Escanear para resgatar um cupom, onde os clientes usam um código QR para resgatar um cupom na sua conta comercial.

## Tutorial

### Etapa 1: Criar uma campanha de cupons

#### Etapa 1.1: Ativar a funcionalidade de cupons

Acesso: [Integrações](https://www.ycloud.com/console/#/app/integrations/all), clique no botão Instalar para ativar

<Frame caption="Find Coupons in Integrations. This example shows the installed state.">
  <img src="https://mintcdn.com/lchnan/TsMGu8UTNQaUw-Rc/product-assets/english-help-demo-2026-09-23/integrations-enabled.png?fit=max&auto=format&n=TsMGu8UTNQaUw-Rc&q=85&s=a0961446037aeff5bf3bde303b607643" alt="Página de integrações com Cupons instalados" width="3024" height="1656" data-path="product-assets/english-help-demo-2026-09-23/integrations-enabled.png" />
</Frame>

#### Etapa 1.2: Criar uma campanha de cupons

Navegue pela barra lateral esquerda em Integrações > [Cupons](https://www.ycloud.com/console/#/app/integrations/coupon/list) até a página de Cupons

Clique em \[+ Novos cupons]

<Frame caption="Select New Coupons to create a campaign.">
  <img src="https://mintcdn.com/lchnan/TsMGu8UTNQaUw-Rc/product-assets/english-help-demo-2026-09-23/coupon-list.png?fit=max&auto=format&n=TsMGu8UTNQaUw-Rc&q=85&s=fbca628682d11096d68bb7fe5013c187" alt="Lista de campanhas de cupom e ação Novos cupons" width="3024" height="1656" data-path="product-assets/english-help-demo-2026-09-23/coupon-list.png" />
</Frame>

#### Etapa 1.3: Configurar informações da campanha

* Tipo de cupom: Tipo de código (código de cupom). Atualmente, apenas este tipo é suportado; para outros tipos, entre em contato conosco.
* Nome da campanha: Nome da campanha de cupons
* Observações da campanha: Observações sobre a campanha, opcional.
* Limite de resgate: Cada pessoa pode resgatar apenas uma vez.
* Duração da campanha: Defina o período da campanha. Os cupons deixarão de ser enviados fora desse intervalo de tempo.

Após confirmar que as informações estão corretas, clique em **OK**.

<Frame caption="Set the campaign name, description and validity period, then click OK.">
  <img src="https://mintcdn.com/lchnan/TsMGu8UTNQaUw-Rc/product-assets/english-help-demo-2026-09-23/coupon-create.png?fit=max&auto=format&n=TsMGu8UTNQaUw-Rc&q=85&s=9b4956cb07d14ce47488db3f90505c26" alt="Criação de campanha de cupons com nome, validade e limite de resgate" width="3024" height="1656" data-path="product-assets/english-help-demo-2026-09-23/coupon-create.png" />
</Frame>

#### Etapa 1.4: Carregar códigos de cupom

Clique no botão de upload

<Frame caption="Open the campaign and click Upload coupons.">
  <img src="https://mintcdn.com/lchnan/TsMGu8UTNQaUw-Rc/product-assets/english-help-demo-2026-09-23/coupon-upload-entry.png?fit=max&auto=format&n=TsMGu8UTNQaUw-Rc&q=85&s=dfd32cc7854239e7dcb11693f93469dc" alt="Detalhes da nova campanha de cupons com ação de Upload de cupons" width="3024" height="1656" data-path="product-assets/english-help-demo-2026-09-23/coupon-upload-entry.png" />
</Frame>

Faça o upload da planilha de códigos de cupom. Você pode clicar no botão de modelo para baixar um modelo.

<Info>
  Observação: Na planilha do Excel enviada, o Código deve estar na primeira coluna. A YCloud removerá automaticamente os códigos de cupom duplicados.
</Info>

<Frame caption="Use an XLSX file with a code column.">
  <img src="https://mintcdn.com/lchnan/TsMGu8UTNQaUw-Rc/product-assets/english-help-demo-2026-09-23/coupon-upload-form.png?fit=max&auto=format&n=TsMGu8UTNQaUw-Rc&q=85&s=3e0bb03dae714fdb64331b69e5a391f6" alt="Caixa de diálogo de upload de cupom com download de modelo e requisito da coluna de código" width="3024" height="1656" data-path="product-assets/english-help-demo-2026-09-23/coupon-upload-form.png" />
</Frame>

Após o upload, clique em Salvar

<Frame caption="Check the valid and duplicate counts, then click Save.">
  <img src="https://mintcdn.com/lchnan/TsMGu8UTNQaUw-Rc/product-assets/english-help-demo-2026-09-23/coupon-upload-preview.png?fit=max&auto=format&n=TsMGu8UTNQaUw-Rc&q=85&s=d92de3bb10d3f4c01bce3b76b81b0378" alt="Três códigos de cupom válidos analisados de um arquivo XLSX" width="3024" height="1656" data-path="product-assets/english-help-demo-2026-09-23/coupon-upload-preview.png" />
</Frame>

<Frame caption="Saved codes appear in the Unclaimed tab.">
  <img src="https://mintcdn.com/lchnan/TsMGu8UTNQaUw-Rc/product-assets/english-help-demo-2026-09-23/coupon-codes-saved.png?fit=max&auto=format&n=TsMGu8UTNQaUw-Rc&q=85&s=f349371f4dafc2101b59f77ee7b742ed" alt="Três códigos de cupom de demonstração não resgatados salvos" width="3024" height="1656" data-path="product-assets/english-help-demo-2026-09-23/coupon-codes-saved.png" />
</Frame>

### Etapa 2: Configurar o processo de resgate em um Agente baseado em regras

#### Etapa 2.1: Criar um Agente baseado em regras

Abra um Agente baseado em regras existente ou consulte [Criar um Flow](/pt/documentation/agents/rule-based-agent/create-a-flow) para configurar um.

#### Etapa 2.2: Criar um Flow

Selecione o Agente baseado em regras e, em seguida, selecione **Criar Flow**.

<Frame caption="Open the rule-based agent and click Create a flow.">
  <img src="https://mintcdn.com/lchnan/TsMGu8UTNQaUw-Rc/product-assets/english-help-demo-2026-09-23/rule-demo-flow-list-annotated.svg?fit=max&auto=format&n=TsMGu8UTNQaUw-Rc&q=85&s=972fcc6559b08de5043e5d0f2f812fe5" alt="Criar um flow no agente baseado em regras de demonstração" width="3024" height="1656" data-path="product-assets/english-help-demo-2026-09-23/rule-demo-flow-list-annotated.svg" />
</Frame>

#### Etapa 2.3: Configurar a palavra-chave do Flow

Defina a Palavra-chave como a palavra-chave de resgate.

Exemplo: se você quiser que os clientes recebam um cupom ao enviar "**Claim New User Coupon**", defina a Palavra-chave como **Claim New User Coupon**.

<Frame caption="Set the claim keyword in the trigger.">
  <img src="https://mintcdn.com/lchnan/TsMGu8UTNQaUw-Rc/product-assets/english-help-demo-2026-09-23/coupon-flow-keyword.png?fit=max&auto=format&n=TsMGu8UTNQaUw-Rc&q=85&s=356ec3d87964a9aebeddc3ba32435c57" alt="Correspondência exata para a palavra-chave Claim New User Coupon" width="3024" height="1656" data-path="product-assets/english-help-demo-2026-09-23/coupon-flow-keyword.png" />
</Frame>

#### Etapa 2.4: Configurar o cupom enviado

Adicione um componente Enviar mensagem no Flow

<Frame caption="Add a text message and insert the coupon variable.">
  <img src="https://mintcdn.com/lchnan/TsMGu8UTNQaUw-Rc/product-assets/english-help-demo-2026-09-23/coupon-flow-message.png?fit=max&auto=format&n=TsMGu8UTNQaUw-Rc&q=85&s=ccc103824d4f0ffe89794ff6463392e6" alt="Resposta de texto com uma variável de cupom" width="3024" height="1656" data-path="product-assets/english-help-demo-2026-09-23/coupon-flow-message.png" />
</Frame>

Na mensagem, clique na variável de cupom e selecione a campanha de cupons a ser inserida.

<Frame caption="Select the coupon campaign from the Coupons menu.">
  <img src="https://mintcdn.com/lchnan/TsMGu8UTNQaUw-Rc/product-assets/english-help-demo-2026-09-23/coupon-flow-selector.png?fit=max&auto=format&n=TsMGu8UTNQaUw-Rc&q=85&s=c5357fb929697ee6b0bacd042c4d97dc" alt="Seletor de cupons exibindo Docs Demo - Welcome Coupon" width="3024" height="1656" data-path="product-assets/english-help-demo-2026-09-23/coupon-flow-selector.png" />
</Frame>

Após a edição bem-sucedida, conecte os componentes Palavra-chave e Enviar mensagem. Em seguida, salve o Flow

<Frame caption="Connect the trigger to the coupon reply and save the flow. This example remains inactive.">
  <img src="https://mintcdn.com/lchnan/TsMGu8UTNQaUw-Rc/product-assets/english-help-demo-2026-09-23/coupon-flow-complete.png?fit=max&auto=format&n=TsMGu8UTNQaUw-Rc&q=85&s=5e007401ed70b6c03f9401dd0a17b1e4" alt="Flow inativo baseado em regras conectando uma palavra-chave de resgate a uma resposta de cupom" width="3024" height="1656" data-path="product-assets/english-help-demo-2026-09-23/coupon-flow-complete.png" />
</Frame>

### Etapa 3: Gerar um código QR para compartilhamento (Opcional, apenas para cenário de resgate por código QR)

Gere um código QR para o número, defina a palavra-chave como: **Claim New User Coupon**. [Consulte o tutorial detalhado de configuração de link de conversa](/pt/documentation/channels/whatsapp-accounts-management/phone-number-management/chat-links)

<Frame caption="Use the same custom message as the rule-based flow keyword: Claim New User Coupon.">
  <img src="https://mintcdn.com/lchnan/rmZYWVwRdpR7TJaI/product-assets/english-help-context-2026-09-23/coupon-qr-keyword.png?fit=max&auto=format&n=rmZYWVwRdpR7TJaI&q=85&s=9cc56625e6c5f5cd974af5382b3ded0a" alt="Configuração do código QR usando Claim New User Coupon como mensagem personalizada" width="3024" height="1656" data-path="product-assets/english-help-context-2026-09-23/coupon-qr-keyword.png" />
</Frame>


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