> 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/getting-started-with-advocate/advocate-program-rules-explained.md).

# Configurar regras do programa no Advocate

<a href="https://pxa.impact.com/student/activity/2345886?sid=0c0e3e5c-54c9-4435-9bee-ebcdccb7f292&#x26;sid_i=0?utm_source=app.impact.com&#x26;utm_medium=owned-platform&#x26;utm_content=&#x26;utm_campaign=help-center" class="button primary">Faça o curso PXA</a>

Os programas de indicação dependem da combinação de regras e ações para recompensar os participantes adequadamente ou acionar ações (como o envio de um e-mail). Em conjunto, essas regras e ações formam as regras do programa. Uma regra define o que você deseja que o usuário-alvo faça. Nos programas de indicação, as regras podem se aplicar tanto aos defensores da marca quanto aos amigos que eles indicam. Uma ação é acionada quando o participante cumpre uma regra.

<details>

<summary>Regras</summary>

As regras que você define dependem do seu programa e dos resultados que deseja alcançar. Todo programa de indicação exige pelo menos uma regra de conversão. Alguns exemplos de regras:

* O amigo indicado faz uma compra
* O defensor da marca faz 5 indicações
* O amigo indicado se torna um lead qualificado

**Acionadores de regras**

A impact.com usa os eventos que você nos envia como acionadores das regras. Durante a [configuração do programa](https://help.impact.com/brand/pt-br/what-would-you-like-to-learn-about/advocate-program/getting-started-with-advocate/configure-your-advocate-program.md), selecione o acionador da regra e uma chave de evento.

| Acionador                                 | Descrição                                                                                     |
| ----------------------------------------- | --------------------------------------------------------------------------------------------- |
| A indicação é iniciada                    | Quando uma indicação é iniciada.                                                              |
| O amigo faz uma compra                    | Quando o amigo indicado faz uma compra rastreada por um evento.                               |
| O amigo reembolsa uma compra              | Quando o amigo indicado devolve um produto comprado em uma transação rastreada por um evento. |
| O amigo realiza uma ação                  | Quando o amigo indicado realiza uma ação rastreada por um evento, como fazer uma compra.      |
| O segmento e/ou campo do amigo é alterado | Quando um campo ou segmento do amigo indicado é atualizado ou alterado.                       |

<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-52c2fb38ab99941f251d244ee053c56842fd1c2d%2Fc0a9e0fd245d4c823bf495b51eb1f0b15b33d8eb416d9fcd8bd41fa224f93041.jpg?alt=media" alt="" width="563"><figcaption></figcaption></figure></div>

**Condições das regras**

Você pode definir condições para uma regra caso queira que ela seja acionada apenas em situações específicas. Confira alguns exemplos de condições que podem ser aplicadas a uma regra.

* Um amigo indicado faz uma compra cujo valor total é de pelo menos US$ 100.
* O defensor da marca faz 5 indicações que permanecem como assinantes ativos por pelo menos seis meses.
* Um amigo indicado inicia uma assinatura, e o defensor também precisa ser um assinante ativo.

As condições das regras podem se basear em vários tipos de dados dos nossos bancos de dados:

| Dados                                                   | Descrição                                                                                                                                                                                                                                                                                          |
| ------------------------------------------------------- | -------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------- |
| Objeto do usuário (defensor da marca ou amigo indicado) | Inclui informações básicas, como e-mail e nome, além de campos personalizados.                                                                                                                                                                                                                     |
| Evento                                                  | Inclui todos os campos do evento que podem acionar uma regra, como receita, nome do produto ou plano.                                                                                                                                                                                              |
| Regras                                                  | A lógica do programa permite consultar a quantidade de regras e indicações, bem como verificar se esta é a primeira vez que a regra é acionada. Isso é útil para executar programas que concedem recompensas a cada X indicações ou para garantir que uma regra/ação seja acionada apenas uma vez. |
| Horário                                                 | O sistema pode consultar o horário atual e compará-lo com datas importantes da indicação (como quando ela foi iniciada) ou do usuário (como quando ele foi criado).                                                                                                                                |

Uma condição de *horário* determina se a regra é acionada. Para aplicar ações diferentes dependendo de quando ocorre a atividade de indicação, use [ações baseadas em datas](https://help.impact.com/brand/pt-br/what-would-you-like-to-learn-about/advocate-program/advocate-program-settings/date-based-actions-in-advocate-program-rules-explained.md) em vez disso.

</details>

Preencha as seções a seguir para configurar as regras do programa e selecione **Avançar** ao concluir cada seção.

{% stepper %}
{% step %}

### Acessar as regras do programa

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]** <i class="fa-arrow-right">:arrow-right:</i> **Regras do programa** <i class="fa-arrow-right">:arrow-right:</i> **Regras do programa**.
2. Na seção *Regras do programa* , selecione **Adicionar regra**.
   {% endstep %}

{% step %}

### Escolha e configure uma regra do programa

3. Abaixo *O que aciona esta regra?*, no ![](https://526234278-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2FwMLlMoFBtKJa8ptd3zaw%2Fuploads%2Fgit-blob-c2cb550b55c51ea1eeff0acbd6f437a03b621a2c%2F60d033ae8a04c14498d5229c3c0160ac05feea7f605dbd770741793c900469f0.svg?alt=media) **\[Menu suspenso]**, selecione um acionador. Algumas configurações variam de acordo com a regra selecionada.

<details>

<summary>Referência do acionador</summary>

| Acionador                                 | Descrição                                                                                     |
| ----------------------------------------- | --------------------------------------------------------------------------------------------- |
| A indicação é iniciada                    | Quando uma indicação é iniciada.                                                              |
| O amigo faz uma compra                    | Quando o amigo indicado faz uma compra rastreada por um evento.                               |
| O amigo reembolsa uma compra              | Quando o amigo indicado devolve um produto comprado em uma transação rastreada por um evento. |
| O amigo realiza uma ação                  | Quando o amigo indicado realiza uma ação rastreada por um evento, como fazer uma compra.      |
| O segmento e/ou campo do amigo é alterado | Quando um campo ou segmento do amigo indicado é atualizado ou alterado.                       |

</details>

4. Se aplicável, selecione o evento de compra ou ação que acionará a regra ou especifique um campo ou segmento.
5. ![](https://526234278-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2FwMLlMoFBtKJa8ptd3zaw%2Fuploads%2FiZjM1xY8o3v1iR3Zaysd%2FToggle.svg?alt=media\&token=b1550d48-bba9-4e81-8604-bc12370c5caa) **\[Ativado]** **Ações baseadas em data** para aplicar ações diferentes dependendo de quando a atividade de indicação ocorrer. Depois de ativar essa opção, em *Avaliar período* *com base em*, selecione a data que será comparada ao intervalo de datas de cada ação. As datas disponíveis dependem do acionador. Para saber mais, consulte [Ações baseadas em data no Advocate](https://help.impact.com/brand/pt-br/what-would-you-like-to-learn-about/advocate-program/advocate-program-settings/date-based-actions-in-advocate-program-rules-explained.md).
6. ![](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]** **Acionar apenas na primeira vez** para acionar a regra somente na primeira vez que o evento ocorrer para uma determinada indicação.
7. ![](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]** **Converter a indicação** para marcá-la como convertida quando a regra for acionada.
8. Digite um **Nome da regra**. Depois de salva, essa informação não poderá ser alterada.
   {% endstep %}

{% step %}

### Adicionar configurações avançadas (opcional)

9. Selecione **Configurações avançadas** para adicionar limites ou condições à regra.
10. ![](https://526234278-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2FwMLlMoFBtKJa8ptd3zaw%2Fuploads%2FiZjM1xY8o3v1iR3Zaysd%2FToggle.svg?alt=media\&token=b1550d48-bba9-4e81-8604-bc12370c5caa) **\[Ativado]** **Limitar o número de recompensas** para definir o número máximo de recompensas que um indicador pode receber quando uma regra for acionada.
11. Na seção *Se* abaixo, adicione condições a uma regra se quiser que ela seja acionada apenas em situações específicas. Veja alguns exemplos de condições que podem ser aplicadas a uma regra.
    * Um amigo faz uma compra cujo valor total é de pelo menos US$ 100.
    * O defensor da marca faz 5 indicações que permanecem como assinantes ativos por pelo menos seis meses.
    * Um amigo indicado inicia uma assinatura, e o defensor também precisa ser um assinante ativo.

<details>

<summary>Referência de condições</summary>

As condições das regras podem se basear em vários tipos de dados dos nossos bancos de dados:

| Dados                                                   | Descrição                                                                                                                                                                                                                                                                                          |
| ------------------------------------------------------- | -------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------- |
| Objeto do usuário (defensor da marca ou amigo indicado) | Inclui informações básicas, como e-mail e nome, além de campos personalizados.                                                                                                                                                                                                                     |
| Evento                                                  | Inclui todos os campos do evento que podem acionar uma regra, como receita, nome do produto ou plano.                                                                                                                                                                                              |
| Regras                                                  | A lógica do programa permite consultar a quantidade de regras e indicações, bem como verificar se esta é a primeira vez que a regra é acionada. Isso é útil para executar programas que concedem recompensas a cada X indicações ou para garantir que uma regra/ação seja acionada apenas uma vez. |
| Horário                                                 | O sistema pode consultar o horário atual e compará-lo com datas importantes da indicação, como a data em que ela foi iniciada, ou do usuário, como a data de criação da conta.                                                                                                                     |

Uma condição de *horário* determina se a regra é acionada. Para aplicar ações diferentes dependendo de quando ocorre a atividade de indicação, use [ações baseadas em datas](https://help.impact.com/brand/pt-br/what-would-you-like-to-learn-about/advocate-program/advocate-program-settings/date-based-actions-in-advocate-program-rules-explained.md) em vez disso.

</details>
{% endstep %}

{% step %}

### Adicionar uma ação

{% hint style="info" %}
**Limitado**: se você precisar adicionar várias ações ao seu programa, talvez seja necessário fazer upgrade da sua conta. [Entre em contato com o suporte](https://app.impact.com/support/portal.ihtml?createTicket=true&) para fazer upgrade do seu programa de indicações.
{% endhint %}

É possível adicionar critérios tanto às regras quanto às ações, pois várias regras podem se aplicar à mesma ação. Mesmo que as condições de uma regra sejam atendidas, você pode definir condições para a ação a fim de controlar qual recompensa será concedida ou qual e-mail será enviado. Isso só é possível em determinados níveis de programa. Fale com o [suporte](https://app.impact.com/support/portal.ihtml) para saber mais.

12. Selecione um dos blocos de ação. As ações incluem:

* **Recompensa e e-mail:** Conceda uma recompensa e envie um e-mail de notificação ao participante.
* **Somente e-mail:** Envie um e-mail ao participante.
* **Recompensas por nível e e-mail:** Ofereça recompensas diferentes com base no segmento do participante, no valor da compra e em outros critérios.

13. Escolha a quem a ação se aplica:
    * **Indicador**: participante que compartilha o link ou código de indicação para convidar alguém a conhecer sua marca.
    * **Amigo indicado**: participante que usa o link ou código de indicação para se cadastrar ou fazer uma compra.
14. Dê um nome à ação.
15. (Condicional) Se você ativou ações baseadas em datas, ![](https://526234278-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2FwMLlMoFBtKJa8ptd3zaw%2Fuploads%2FiZjM1xY8o3v1iR3Zaysd%2FToggle.svg?alt=media\&token=b1550d48-bba9-4e81-8604-bc12370c5caa) **\[Ative o botão]** **Limitar a ação a um período** e escolha o período em que essa ação se aplica. Se a data selecionada na etapa 5 estiver fora desse período, outra ação será aplicada. Para saber mais, consulte [Ações baseadas em datas no Advocate](https://help.impact.com/brand/pt-br/what-would-you-like-to-learn-about/advocate-program/advocate-program-settings/date-based-actions-in-advocate-program-rules-explained.md).
16. Opcionalmente, selecione **Configurações avançadas** para adicionar condições a uma ação, caso queira que ela seja acionada apenas em situações específicas.

{% hint style="info" %}
**Exemplo:** Você pode definir uma regra de compra realizada com as ações associadas Recompensa e e-mail. Com esse par de regra e ação, seu indicador recebe uma notificação por e-mail e uma recompensa sempre que um amigo indicado por ele faz uma compra.
{% endhint %}

<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%2FRJnDay3QTI9kGA02BlLJ%2FScreenshot%202026-08-25%20at%2008.21.15.png?alt=media&amp;token=fc9ab230-f10c-496d-8d25-70e6175e16f9" alt="" width="563"><figcaption></figcaption></figure></div>
{% endstep %}

{% step %}

### Adicionar uma recompensa (condicional)

Se você selecionou **Recompensa e e-mail** ou **Recompensa escalonada e e-mail**, será necessário configurar a recompensa. Para ver as instruções de configuração, consulte a seção *Criar uma recompensa* em [Configurar seu programa Advocate](https://help.impact.com/brand/pt-br/what-would-you-like-to-learn-about/advocate-program/getting-started-with-advocate/configure-your-advocate-program.md).
{% endstep %}

{% step %}

### Revise sua regra

Antes de salvar, a tela *Revisar* resume a regra.

17. Opcionalmente, atualize a regra:
    1. Selecione ![](https://526234278-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2FwMLlMoFBtKJa8ptd3zaw%2Fuploads%2Fut4jbWXPGIqKlOpfrxol%2Fadvocate_edit.svg?alt=media\&token=3a645b22-237b-429e-be28-5a4d92fab66c) **\[Editar]** ao lado de qualquer linha para alterá-la.
    2. Selecione ![](https://526234278-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2FwMLlMoFBtKJa8ptd3zaw%2Fuploads%2FE2111giEEN8AgK2AkYBQ%2F%5BAdd%5D.svg?alt=media\&token=e4bac353-65cf-4aba-83f2-84825bc825d3) **\[Adicionar ação]** para anexar outra ação sem voltar às etapas anteriores.
18. Selecione **Salvar** quando terminar.

<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%2FYW2FIPxQ7QjzZegAfE4B%2FScreenshot%202026-05-15%20at%2011.31.37.png?alt=media&amp;token=bfa99c0a-4c10-49e8-894d-8182801d6e34" alt="" width="563"><figcaption></figcaption></figure></div>
{% endstep %}
{% endstepper %}

## Exemplos de regras e ações

Você pode pensar em regras e ações como uma sequência de declarações “se-então”. Vamos ver alguns exemplos.

| Resultado desejado                                                                                                                                                                    | Se (regra)                                    | Então (ação)                                                                                   |
| ------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------- | --------------------------------------------- | ---------------------------------------------------------------------------------------------- |
| Recompensar o indicador com um vale-presente de US$ 20 a cada 5 leads qualificados indicados                                                                                          | O amigo indicado se torna um lead qualificado | Recompensa e e-mail                                                                            |
| Recompensar o amigo indicado com um crédito de US$ 100 no cadastro inicial e o indicador com um crédito de US$ 500 se a oportunidade no Salesforce estiver marcada como “Closed Won”. | O amigo indicado conclui o cadastro inicial   | <ul><li>Recompensa e e-mail (indicador)</li><li>Recompensa e e-mail (amigo indicado)</li></ul> |
| Enviar um e-mail de notificação ao indicador quando a pessoa que ele indicou concluir uma demonstração com sucesso.                                                                   | O amigo indicado conclui uma demonstração     | Somente por e-mail                                                                             |


---

# 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 by asking a question.

Perform an HTTP GET request on the following URL with the `ask` and `goal` query parameters:

```
GET https://help.impact.com/brand/pt-br/what-would-you-like-to-learn-about/advocate-program/getting-started-with-advocate/advocate-program-rules-explained.md?ask=<question>&goal=<user_goal>
```

`ask` is the immediate question: it should be specific, self-contained, and written in natural language.
`goal` is what the user is ultimately trying to achieve, the reason they need the answer. Sharing it helps GitBook give you a better, more relevant answer. A goal is most helpful when it describes the outcome the user wants rather than restating the question. For example, with `ask=how do I create an API token`, a goal like `automate deployments from our CI pipeline` lets GitBook tailor the answer to that use case.

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.
