> 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/redeem-rewards-in-bulk.md).

# Resgatar recompensas em massa

As recompensas normalmente são resgatadas por meio de uma das suas integrações com a Advocate. Se você precisar conceder recompensas manualmente em um sistema externo, então poderá usar este processo de resgate em massa de recompensas para atualizar os saldos de recompensas disponíveis dos seus participantes.

{% hint style="success" %}
**Observação:** Esse processo não emitirá recompensas específicas — como crédito, cartões-presente ou códigos de cupom — para os participantes. Em vez disso, ele atualiza seus registros para exibir com precisão os saldos de recompensas dos participantes depois que você tiver resgatado as recompensas por meio de outro sistema.
{% endhint %}

{% stepper %}
{% step %}
**Etapa 1: Baixe um relatório de saldos de recompensas disponíveis por usuário**

Este relatório lista todos os participantes com saldos de recompensas disponíveis em cada programa. Você pode usar este relatório para conceder recompensas manualmente em um sistema externo.

1. No menu de navegação à esquerda, selecione ![](https://res.cloudinary.com/product-enablement/image/upload/v1768905009/Accessibility%20Icons/engage-v2.svg) **\[Engage] → Relatórios → Importações e exportações**.
2. Selecione **Criar relatório**.
3. Em *Escolha um tipo de relatório*, selecione **Saldos de recompensas disponíveis por usuário**.
4. Opcionalmente, selecione uma unidade de recompensa específica para restringir a lista de participantes. Isso pode ser útil se você quiser limitar o relatório gerado a uma unidade de recompensa específica que foi paga por meio de um serviço externo.
5. Selecione o formato do relatório (.CSV ou Excel).
6. Selecione **Criar relatório**.

Um link para o relatório gerado será enviado para o endereço de e-mail associado a esta conta.
{% endstep %}

{% step %}
**Etapa 2: Atualize o relatório**

Depois de conceder manualmente as recompensas no seu sistema externo, você precisará atualizar o *saldos de recompensas disponíveis por usuário* relatório. Isso permitirá que a Advocate saiba quais participantes tiveram suas recompensas concedidas.

1. Usando um aplicativo de planilha, abra o *saldos de recompensas disponíveis por usuário* relatório.
2. Para cada participante para o qual você concedeu manualmente uma recompensa, atualize o `valueToRedeem` campo. Apenas números positivos são aceitos.
3. Salve o relatório no formato .CSV.

**Observações sobre resgate**

* Os saldos de recompensas precisam ser resgatados nas mesmas unidades (*por exemplo*. `CENTAVOS` ou `REAIS/USD`) em que o saldo é exibido (*ou seja* Não é possível resgatar dólares em valores de centavos).
* Apenas alterações no `valueToRedeem` campo serão processadas durante uma importação.
* As recompensas individuais dentro de um saldo de recompensas serão resgatadas na ordem em que expiram (`dateExpires`), e depois quando foram disponibilizadas ao participante (`dateGiven`).
* Apenas recompensas com status de `AVAILABLE` serão resgatadas.
* Frações da unidade fracionária serão truncadas no resgate (*por exemplo* o resgate de "10,556 USD" só resgatará "10,55 USD").
  {% endstep %}

{% step %}
**Etapa 3: Envie o relatório atualizado**

Por fim, você precisará enviar seu *saldos de recompensas disponíveis por usuário* relatório com os saldos de recompensas atuais de volta para a Advocate.

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 e exportações**.
2. Selecione ![](https://526234278-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2FwMLlMoFBtKJa8ptd3zaw%2Fuploads%2Fgit-blob-06e12321258e7eb7ac63ef7e73640b29fcf2baad%2Fcff634f1183ca82d3b56ab55dd636140372687d8dbc6520872cdbe5010347326.svg?alt=media) **Importar**.
3. Em *Tipo de importação*, selecione **Atualizar saldos de recompensas do usuário**.
4. Para adicionar seu relatório atualizado, selecione **Escolher arquivo**.
5. Selecione **Importar**.

Quando a importação for concluída, um e-mail de confirmação será enviado. As importações podem levar até 30 minutos, dependendo da fila e do tamanho do arquivo.
{% 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/redeem-rewards-in-bulk.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.