> 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/create-bulk-cash-rewards-with-advocate.md).

# Criar recompensas em dinheiro em massa com o Advocate

Embora muitas recompensas sejam acionadas automaticamente por regras do programa (como uma conversão por indicação), às vezes pode ser necessário recompensar participantes por ações manuais ou offline, como preencher uma pesquisa ou vencer um concurso.

A ferramenta de importação de **Recompensas em massa** permite conceder dinheiro, pontos ou cartões-presente a vários defensores da marca de uma só vez, fazendo upload de um arquivo CSV. Esse recurso inclui um mecanismo de segurança de simulação para garantir que os dados estejam corretos antes que qualquer valor seja distribuído.

### Preparar o arquivo de importação

{% hint style="success" %}
**Observação**: se você usar as configurações globais de importação, basta enviar uma lista de `userId` .
{% endhint %}

Para começar, você precisará de um arquivo CSV ou JSONL com a lista de usuários que deseja recompensar.

* **Colunas obrigatórias**: seu arquivo deve incluir, no mínimo, `userId` para identificar o usuário.
* **Colunas opcionais**: você pode incluir os detalhes da recompensa (por exemplo, valor, unidade e tipo) no arquivo. Como alternativa, recomendamos definir esses dados como *valores padrão globais* na plataforma durante o processo de importação, para simplificar o arquivo.

#### Referência das colunas do arquivo

<table data-header-hidden><thead><tr><th width="297.484375">Coluna</th><th>Descrição</th><th>Requisito</th></tr></thead><tbody><tr><td><code>userId</code></td><td>O ID exclusivo do usuário.</td><td><mark style="color:$danger;">Obrigatório</mark></td></tr><tr><td><code>assignedCreditInCurrencyBaseUnit</code></td><td>O valor da recompensa (por exemplo, 50).</td><td>Condicional<br>(Não obrigatório se um valor padrão global estiver definido)</td></tr><tr><td><code>rewardUnit</code></td><td>A unidade da recompensa (por exemplo, USD, POINTS).</td><td>Condicional<br>(Não obrigatório se um valor padrão global estiver definido)</td></tr><tr><td><code>globalRewardKey</code></td><td>A chave de uma recompensa pré-configurada a ser concedida.</td><td><p>Condicional<br>(Não obrigatório se um valor padrão global estiver definido)</p><p><br></p></td></tr><tr><td><code>discountPercent</code></td><td>O valor a ser concedido como desconto</td><td>Condicional<br>(Não obrigatório se um valor padrão global estiver definido)</td></tr><tr><td><code>dateScheduledFor</code></td><td>Adie a recompensa até esta data.</td><td>Opcional</td></tr><tr><td><code>uniqueId</code></td><td>Um identificador exclusivo para a transação.</td><td><mark style="color:$success;">Recomendado</mark><br>Usado como chave de segurança para evitar recompensas duplicadas caso o arquivo seja executado novamente.</td></tr><tr><td><code>customerNote</code></td><td>Adicione uma observação que ficará visível para o cliente.</td><td>Opcional</td></tr><tr><td><code>internalNote</code></td><td>Adicione uma observação para uso interno, que não ficará visível para o cliente.</td><td>Opcional</td></tr></tbody></table>

{% stepper %}
{% step %}

#### Configurar as definições de importaçã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] → Relatórios → Importações e exportações**.
2. No canto superior direito, selecione **Importar**.
3. Em *Tipo de importação*, selecione **Recompensas**.

<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%2FNCv4EHK61ypIahnjieFB%2FScreenshot%202026-05-19%20at%2010.12.35.png?alt=media&amp;token=1b2a3fe3-f3ba-4bff-9612-a47317c223f7" alt=""><figcaption></figcaption></figure></div>

**Definir valores predefinidos (padrões globais)**

Para economizar tempo e reduzir erros no arquivo CSV, você pode definir valores predefinidos que se aplicam a todas as linhas da importação.

* **Recompensa**: escolha uma recompensa pré-configurada ou especifique uma unidade manual (por exemplo, "Cash/USD").
* **Programa**: associe essas recompensas a um programa específico para fins de geração de relatórios.
* **Período de espera da recompensa**: ![](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) **\[Ativar]** para adicionar um período de segurança (por exemplo, 30 dias) antes que a recompensa fique disponível para o usuário. Isso permite fazer estornos, se necessário.

{% hint style="success" %}
**Observação**: se você definir um valor aqui (por exemplo, unidade da recompensa: USD), você **não** precisa incluir essa coluna no arquivo CSV.
{% endhint %}
{% endstep %}

{% step %}

#### Fazer upload e executar uma simulação

Como as recompensas em dinheiro são definitivas e não podem ser revertidas, o sistema exige uma simulação (importação de teste) para que você possa revisar os detalhes com segurança antes de processar as recompensas.

1. Em *Fazer upload do arquivo CSV ou JSONL dos usuários a importar* selecione **Escolher arquivo**.
2. Selecione **Executar importação de teste** para iniciar o modo de teste.
3. O sistema processará o arquivo **sem** criar recompensas.

<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%2FXzOTAlFdV9PBePeTWjd2%2FScreenshot%202026-05-19%20at%2010.15.36.png?alt=media&amp;token=859ccc75-e655-4002-b915-b8225028ddff" alt=""><figcaption></figcaption></figure></div>
{% endstep %}

{% step %}

#### Revisar e finalizar

Após a conclusão da execução de teste, uma entrada de status será exibida na lista de importações e exportações. E-mails podem ser enviados durante o processo de revisão (cartões-presente, configuração de pagamentos etc.).

1. **Revisar**: se houver erros (indicados por ![](https://526234278-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2FwMLlMoFBtKJa8ptd3zaw%2Fuploads%2F42gbg9NHA1obODpwpxh1%2Ficons8-high-importance-16.png?alt=media\&token=80a809ae-ca8e-43d4-af95-a416a44c8ec3) **\[Exclamação]**), selecione **Baixar relatório de erros** para corrigir o arquivo e tentar novamente. Além disso, selecione **Baixar relatório** para obter um registro de todas as recompensas que serão criadas. Recomenda-se revisar esse relatório, haja erros ou não.
2. **Confirmar**: se o teste for bem-sucedido (indicado por um ![](https://526234278-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2FwMLlMoFBtKJa8ptd3zaw%2Fuploads%2FvdMZSNCvTeUSIm6qrJ5o%2Ficons8-check-16.png?alt=media\&token=998fe3ad-c8a2-4dbc-bdc0-8f79e246b314) **\[Marca de seleção]**), selecione **Executar importação**.
3. Uma janela de confirmação será exibida com um resumo do impacto total (por exemplo, “Ao executar esta importação, 412 recompensas serão criadas"). Selecione **Executar importação** para confirmar e distribuir as recompensas.

Se decidir não prosseguir, basta cancelar a execução e selecionar Descartar para excluir a execução de teste.

<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%2FNa7x8cn8GL73umRhPqxk%2Fimage3.jpg?alt=media&amp;token=232b052b-b167-4613-81d1-581178951f27" alt=""><figcaption></figcaption></figure></div>
{% endstep %}
{% endstepper %}


---

# 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/advocate-rewards/create-bulk-cash-rewards-with-advocate.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.
