> For the complete documentation index, see [llms.txt](https://help.impact.com/llms.txt). Markdown versions of documentation pages are available by appending `.md` to page URLs; this page is available as [Markdown](https://help.impact.com/brand/pt-br/what-would-you-like-to-learn-about/advocate-program/advocate-rewards/referral-promo-codes-for-participants.md).

# Códigos promocionais de indicação para participantes

{% hint style="danger" %}
**Importante**: Uma vez que o recurso seja ativado para o seu programa, ele não pode ser desativado.
{% endhint %}

Os códigos promocionais de indicação são uma ótima maneira de condensar a atribuição e a recompensa em 1 etapa no **início** do processo de indicação. Os vouchers são apresentados pelos defensores do cliente aos amigos indicados e oferecem um desconto. Assim que o amigo indicado usa o código promocional no checkout, o código é atribuído ao defensor do cliente, que recebe a recompensa em seguida.

Você pode criar códigos promocionais de indicação para seus defensores enviando códigos promocionais nas regras do seu programa. Depois que você tiver sua [regras do programa](/brand/pt-br/what-would-you-like-to-learn-about/advocate-program/getting-started-with-advocate/configure-your-advocate-program.md) configuração concluída, navegue até a *Códigos Promocionais* seção para enviar um lote de códigos promocionais de indicação.

{% hint style="success" %}
**Observação**: Este recurso é separado de [recompensas do tanque de combustível](/brand/pt-br/what-would-you-like-to-learn-about/advocate-program/advocate-rewards/fuel-tank-rewards-explained.md). As recompensas do tanque de combustível também usam códigos, mas esses códigos são usados apenas para recompensar o participante — e não para criar uma atribuição entre o defensor e o amigo indicado.
{% endhint %}

#### Configurar códigos promocionais de indicação

1. No menu de navegação à esquerda, selecione ![](https://526234278-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2FwMLlMoFBtKJa8ptd3zaw%2Fuploads%2Fgit-blob-230534471fef5f40808e921e41ee44e4a06ded03%2Fe6cb9548999afdc1ed3ce4942e4cb5b45b5cecbd323267aac2a7cd1915fccc09.svg?alt=media) **\[Engajar] → Regras do Programa**.
2. Role até a *Códigos Promocionais* seção e, em seguida, selecione **Configurar Códigos Promocionais**. Para códigos promocionais de indicação, isso pode ser definido como **Uso múltiplo** ou **Uso único**.
   * Recomenda-se usar códigos de uso único em vez de códigos de uso múltiplo, pois isso pode ajudar a minimizar fraudes.

     <div data-with-frame="true"><figure><img src="https://526234278-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2FwMLlMoFBtKJa8ptd3zaw%2Fuploads%2FGe75pFju4pGaCP0wkeOP%2FScreenshot%202026-05-19%20at%2011.12.14.png?alt=media&amp;token=f17160ae-8f36-484e-accc-7a03b84fe2a1" alt="" width="563"><figcaption></figcaption></figure></div>
3. Selecione o número de códigos que você gostaria de disponibilizar por defensor. Esta opção só está disponível se você tiver selecionado criar **Uso único** códigos promocionais.
   * Um defensor pode ter uma quantidade de códigos atribuídos a ele. O defensor recebe automaticamente outro código promocional quando um que ele tinha é usado.

     <div data-with-frame="true"><figure><img src="https://526234278-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2FwMLlMoFBtKJa8ptd3zaw%2Fuploads%2FTg8TB9rIZdUufsT56vGR%2FScreenshot%202026-05-19%20at%2011.13.16.png?alt=media&amp;token=0697bf68-55a7-4cd5-a1aa-cd0b1a8fe48d" alt="" width="375"><figcaption></figcaption></figure></div>
4. Você pode definir quando deseja ser notificado sobre a baixa de códigos promocionais.
   * Assim que a quantidade de códigos atingir o número que você definiu na seção de notificações, um e-mail será enviado para lembrá-lo de que seus códigos estão acabando. É muito importante garantir que seu programa não chegue a zero, então certifique-se de criar mais códigos quando estiver com poucos para manter seu programa funcionando sem problemas.
5. Selecione **Enviar códigos** para enviar um lote de códigos promocionais de indicação.
   * Você será redirecionado para uma página onde poderá enviar seu lote de códigos em qualquer um dos formatos de arquivo aceitos.

     <div data-with-frame="true"><figure><img src="https://526234278-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2FwMLlMoFBtKJa8ptd3zaw%2Fuploads%2FC01ajR9Orj70bvZ0Zs0M%2FScreenshot%202026-05-19%20at%2011.14.59.png?alt=media&amp;token=44888203-2077-480d-b81a-ca37492a36dc" alt="" width="375"><figcaption></figcaption></figure></div>
6. Selecione **Salvar** assim que você tiver configurado seus códigos promocionais. Um pop-up aparecerá perguntando se você tem certeza de que gostaria de salvar. Depois que você ativar códigos de uso único, a ação não poderá ser desfeita.

   <div data-with-frame="true"><figure><img src="https://526234278-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2FwMLlMoFBtKJa8ptd3zaw%2Fuploads%2FCxnU8l4xOjtmKBqip9jl%2FScreenshot%202026-05-19%20at%2012.16.57.png?alt=media&amp;token=3158ea8d-6b22-4de8-80b5-2e4cc9e4e154" alt="" width="344"><figcaption></figcaption></figure></div>
7. Selecione ![](https://526234278-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2FwMLlMoFBtKJa8ptd3zaw%2Fuploads%2FwXho9QKP3e4iU4ZKUSJ5%2F167ebb8cc30303.svg?alt=media\&token=a046e9f0-63aa-46f6-8a35-f73973fd326c) **\[caixa de seleção]** para aplicar automaticamente um novo modelo de código promocional ao seu widget.
   * Como alternativa, se você já tiver um widget ou microsite existente, pode adicionar manualmente o componente de código promocional de indicação. Você pode fazer isso navegando até **Conteúdo** na barra de navegação à esquerda e depois escolhendo editar seu widget ou microsite. Selecione **Adicionar** à direita para adicionar um componente ao seu widget ou microsite existente. Saiba mais sobre [componentes de widget e microsite](/brand/pt-br/what-would-you-like-to-learn-about/advocate-program/manage-advocate-participant-experiences/widget-and-microsite-components-explained.md).

Depois de enviar seus códigos promocionais de indicação, os códigos serão gerados automaticamente e fornecidos por meio dos [widgets](/brand/pt-br/what-would-you-like-to-learn-about/advocate-program/manage-advocate-participant-experiences/introduction-to-participant-experiences.md#widgets-0-0) ou microsites que você configurou.

Na imagem abaixo, o defensor recebe 5 códigos diferentes entre os quais pode alternar e copiar para compartilhar com os indicados. Se um código já tiver sido copiado antes, você será notificado abaixo do campo do código. Isso ajuda a evitar situações em que você possa enviar o mesmo código para várias pessoas.

<div data-with-frame="true"><figure><img src="https://526234278-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2FwMLlMoFBtKJa8ptd3zaw%2Fuploads%2Fgit-blob-21993c32d4b6f889783325b921cbf28a6bba4c45%2Fd87e360ea05fc772c976e14f0d24ad85084e28eefdd0c1d5c9410098aa3f1a65.jpg?alt=media" alt="" width="375"><figcaption></figcaption></figure></div>

{% hint style="success" %}
**Observação**: Caso seu defensor fique sem códigos e entre em contato com você pedindo mais, você pode criar um manualmente para ele, se quiser fornecer códigos em circunstâncias especiais. Para fazer isso, navegue até **Participantes**. Selecione o participante para o qual você gostaria de gerar um novo código e depois selecione a **Códigos e Links** aba e selecione **Adicionar código de indicação** para gerar um novo código para ele. O código será adicionado ao lote existente dele no widget.
{% endhint %}

#### Atribuição por Hora do Evento

As indicações são atribuídas por meio de upserts de usuário, e isso acontece via chamadas de API, importações de usuários ou até mesmo carregamentos de widget. Códigos promocionais de indicação também podem ser enviados de volta com eventos de compra. Você pode nos passar o evento em `OrderPromoCode` da API de conversões. Saiba mais sobre como criar um [evento de conversão](https://integrations.impact.com/brand-api-reference/reference/conversions/conversions).

#### Veja seus códigos promocionais

Há vários detalhes que você pode visualizar na tela *Ver códigos* . Você pode diferenciar entre códigos de uso único e de uso múltiplo verificando o tipo do código. Você também poderá ver quais códigos já foram usados e visualizar quais defensores foram atribuídos a quais indicações.

{% hint style="success" %}
**Observação**: Códigos de uso único são uma ótima maneira de minimizar as chances de uso fraudulento dos seus códigos promocionais. Enquanto códigos de uso múltiplo costumam ser compartilhados em sites de terceiros, códigos de uso único só podem ser usados uma vez e reduzem a probabilidade de serem espalhados por fontes não confiáveis.
{% endhint %}

1. No menu de navegação à esquerda, selecione ![](https://526234278-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2FwMLlMoFBtKJa8ptd3zaw%2Fuploads%2Fgit-blob-230534471fef5f40808e921e41ee44e4a06ded03%2Fe6cb9548999afdc1ed3ce4942e4cb5b45b5cecbd323267aac2a7cd1915fccc09.svg?alt=media) **\[Engage] →** **Recompensas → Gerenciador de Códigos**.
2. Selecione o participante para o qual você gostaria de ver os códigos.
3. Na *Ver códigos* na tela, você encontrará todas as informações relevantes sobre que tipo de códigos foram emitidos, quais foram usados e muito mais.

   <div data-with-frame="true"><figure><img src="https://526234278-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2FwMLlMoFBtKJa8ptd3zaw%2Fuploads%2F5G6QGfUR6MiONqv2ki1N%2FScreenshot%202026-05-19%20at%2012.12.21.png?alt=media&amp;token=e2c4241a-5bb5-430e-8c42-cde9a31f2938" alt=""><figcaption></figcaption></figure></div>


---

# Agent Instructions
This documentation is published with GitBook. GitBook is the documentation platform designed so that both humans and AI agents can read, navigate, and reason over technical content effectively. Learn more at gitbook.com.

## Querying This Documentation
If you need additional information that is not directly available in this page, you can query the documentation dynamically by asking a question.

Perform an HTTP GET request on the current page URL with the `ask` query parameter, and the optional `goal` query parameter:

```
GET https://help.impact.com/brand/pt-br/what-would-you-like-to-learn-about/advocate-program/advocate-rewards/referral-promo-codes-for-participants.md?ask=<question>&goal=<endgoal>
```

`ask` is the immediate question: it should be specific, self-contained, and written in natural language.
`goal` is optional and describes the broader end goal you are ultimately trying to accomplish on behalf of the user. GitBook uses it to tailor the answer towards what is most useful for that goal.

The response will contain a direct answer to the question and relevant excerpts and sources from the documentation.

Use this mechanism when the answer is not explicitly present in the current page, you need clarification or additional context, or you want to retrieve related documentation sections.
