# Criar Recompensas em Lote com o Advocate

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

A **ferramenta de Importação em Massa de Recompensas** permite emitir dinheiro, pontos ou cartões-presente para vários defensores de uma vez enviando um arquivo CSV. Este recurso inclui um mecanismo de simulação (dry run) para garantir que seus dados estejam corretos antes de quaisquer fundos serem liberados.

### Prepare Seu Arquivo de Importação

{% hint style="success" %}
**Observação**: Se você utilizar as configurações globais de importação, então você só precisará enviar uma `lista de userId` .
{% 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, no mínimo, incluir `lista de userId` para identificar o usuário.
* **Colunas Opcionais**: Você pode incluir detalhes da recompensa (por exemplo, valor, unidade, tipo) no arquivo. Alternativamente, recomendamos definir esses valores 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>Requisito</th></tr></thead><tbody><tr><td><code>lista de userId</code></td><td>O ID único do usuário.</td><td><mark style="color:$danger;">Obrigatório</mark></td></tr><tr><td><code>assignedCreditInCurrencyBaseUnit</code></td><td>O montante a ser recompensado (por exemplo, 50).</td><td>Condicional<br>(Não é necessário se um padrão global estiver definido)</td></tr><tr><td><code>rewardUnit</code></td><td>A unidade da recompensa (por exemplo, USD, PONTOS).</td><td>Condicional<br>(Não é necessá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 é necessá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 é necessário se um padrão global estiver definido)</td></tr><tr><td><code>dateScheduledFor</code></td><td>Aguardar a recompensa até esta data.</td><td>Opcional</td></tr><tr><td><code>uniqueId</code></td><td>Um identificador único para a transação.</td><td><mark style="color:$success;">Recomendado</mark><br>Usado 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 nota que será visível para o cliente.</td><td>Opcional</td></tr><tr><td><code>internalNote</code></td><td>Adicione uma nota para uso interno que o cliente não poderá ver.</td><td>Opcional</td></tr></tbody></table>

{% stepper %}
{% step %}

### Configurar as Configuraçõ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) **\[Engage] → Relatórios → Importações & 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%2FJZUEnGwGzclqEoxytkpg%2Fimage1.jpg?alt=media&#x26;token=2411fab1-369d-41ac-8061-7cd222024542" alt=""><figcaption></figcaption></figure></div>

#### Definir Valores Pré-definidos (Padrões Globais)

Para economizar tempo e reduzir erros no seu arquivo CSV, você pode definir valores pré-definidos que se aplicam a cada linha da sua importação.

* **Recompensa**: Escolha uma recompensa pré-configurada ou especifique uma unidade manual (por exemplo, "Dinheiro/USD").
* **Programa**: Associe essas recompensas a um programa específico para fins de relatórios.
* **Duração de Recompensa Pendente**: ![](https://526234278-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2FwMLlMoFBtKJa8ptd3zaw%2Fuploads%2Fgit-blob-d0b6669ae76a7bef06a8d6940d7ad5c16bb8d018%2F7cb018d4face8d7cceb880eb5086c812e764fbcfe6f2a0377f88bc7576973070.svg?alt=media) **\[Ativar]** para adicionar uma margem de segurança (por exemplo, 30 dias) antes que a recompensa esteja 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 de Recompensa: USD), você **não** precisa incluir essa coluna no seu arquivo CSV.
{% endhint %}
{% endstep %}

{% step %}

### Carregar e Executar Simulação

Como 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 confiança antes de processar as recompensas.

1. Em *Carregue seu arquivo CSV ou JSONL de usuários para 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="https://526234278-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2FwMLlMoFBtKJa8ptd3zaw%2Fuploads%2F4FJcNAj9poM9VKuQ74dW%2Fimage2.jpg?alt=media&#x26;token=856d4d41-7ca3-47ed-a774-71127c5c0e23" alt=""><figcaption></figcaption></figure></div>
{% endstep %}

{% step %}

### Revisar e Finalizar

Uma vez que a execução de teste esteja completa, você verá uma entrada de status na lista de Importações & 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 ![](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 seu arquivo e tentar novamente. Além disso, selecione **Baixar Relatório** para obter um registro de todas as recompensas que serão criadas. Independentemente de haver erro ou não, é recomendado para revisão.
2. **Confirmar**: Se o teste for bem-sucedido (indicado com 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 verificação]**), 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 distribuir as recompensas.

Se você decidir não prosseguir, pode simplesmente cancelar a execução e então 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&#x26;token=232b052b-b167-4613-81d1-581178951f27" alt=""><figcaption></figcaption></figure></div>
{% endstep %}
{% endstepper %}
