# Criar Recompensas em Dinheiro em Massa com Advocate

Embora muitas recompensas sejam acionadas automaticamente por regras do programa (como uma conversão de indicação), às vezes você pode precisar recompensar participantes por ações manuais ou offline — como concluir uma pesquisa ou vencer um concurso.

Os valores de **Recompensas em massa** A ferramenta de importação permite que você emita dinheiro, pontos ou cartões-presente para vários defensores de uma vez, fazendo upload de um arquivo CSV. Este recurso inclui um mecanismo de segurança de execução de teste para garantir que seus dados estejam corretos antes que quaisquer fundos sejam desembolsados.

### Prepare seu arquivo de importação

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

Para começar, você precisará de um arquivo CSV ou JSONL contendo 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 detalhes da recompensa (por exemplo, valor, unidade, tipo) no arquivo. Como alternativa, recomendamos definir isso como *padrões globais* na plataforma durante o processo de importação para simplificar seu arquivo.

#### Referência de colunas do arquivo

<table data-header-hidden><thead><tr><th width="297.484375">Coluna</th><th>Descrição</th><th>Obrigatoriedade</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 a ser recompensado (por exemplo, 50).</td><td>Condicional<br>(Não obrigatório se um 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 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 padrão global estiver definido)</p><p><br></p></td></tr><tr><td><code>discountPercent</code></td><td>O valor a ser recompensado como desconto</td><td>Condicional<br>(Não obrigatório se um 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>Usada como uma 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 o cliente não poderá ver.</td><td>Opcional</td></tr></tbody></table>

{% stepper %}
{% step %}

#### Configure as configurações de importação

1. No menu de navegação à esquerda, selecione ![](/files/160944180402269557074f48f2ece20bc35e8b4d) **\[Engage] → 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="/files/841268fcde107cf69ef7422e37a9f94c2f6938e5" alt=""><figcaption></figcaption></figure></div>

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

Para economizar tempo e reduzir erros no seu arquivo CSV, você pode definir valores predefinidos que se aplicam a cada linha da sua 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 relatórios.
* **Duração da pendência da recompensa**: ![](/files/56148a29d7f42673dde9884eb52356c45eca06c3) **\[Ativar]** para adicionar uma margem de segurança (por exemplo, 30 dias) antes que a recompensa fique disponível para o usuário. Isso permite tempo para retratações, 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 seu arquivo CSV.
{% endhint %}
{% endstep %}

{% step %}

#### Fazer upload e executar teste

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

1. Na seção *Faça upload do seu arquivo CSV ou JSONL de usuários da importação* selecione **Escolher arquivo**.
2. Selecione **Executar importação de teste** para iniciar o estado de teste.
3. O sistema processará o arquivo **sem** criar recompensas.

<div data-with-frame="true"><figure><img src="/files/47673830f1e376f12c4b3ad51abf2c4463241ea8" alt=""><figcaption></figcaption></figure></div>
{% endstep %}

{% step %}

#### Revisar e finalizar

Quando a execução de teste for concluída, você verá uma entrada de status na lista de Importações e exportações. E-mails podem ser enviados como parte do processo de revisão (cartões-presente, configuração de pagamento etc.).

1. **Revisar**: Se houver erros (indicados com ![](/files/e07ffa470893aae433dd5a76a0cf9047019cd41e) **\[Exclaimation]**), selecione **Baixar relatório de erros** para corrigir seu arquivo e tentar novamente. Além disso, selecione **Baixar relatório** para obter um registro de todas as recompensas que serão criadas. Haja erro ou não, isso é recomendado para revisão.
2. **Confirmar**: Se o teste for bem-sucedido (indicado com um ![](/files/1623f7df38ae1287d8e2034c2fff7e35a0a9c769) **\[Checkmark]**), selecione **Executar importação**.
3. Um modal de confirmação aparecerá resumindo o impacto total (por exemplo, “Ao executar esta importação, 412 recompensas serão criadas”). Selecione **Executar importação** para confirmar e desembolsar as recompensas.

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

<div data-with-frame="true"><figure><img src="/files/fa81cea88b70969228a750026cf8e2b0b450b58d" alt=""><figcaption></figcaption></figure></div>
{% endstep %}
{% endstepper %}


---

# Agent Instructions: 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:

```
GET https://help.impact.com/brand/pt-br/sobre-o-que-voce-gostaria-de-aprender/advocate-program/advocate-rewards/criar-recompensas-em-dinheiro-em-massa-com-o-advocate.md?ask=<question>
```

The question should be specific, self-contained, and written in natural language.
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.