> 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/manage-advocate-participants/import-advocate-participants-in-bulk.md).

# Importar participantes do Advocate em massa

O Advocate aceita importações enviadas nos formatos `.csv` ou `.jsonl` . Consulte nosso [arquivo de importação CSV de exemplo](https://assets.ctfassets.net/s68ib1kj8k5n/7LOYwhDlsI22uuaIMaWImE/71cefe860edc71c0968c8065e1d6e953/sample-user-upload.csv) e [arquivo de importação JSONL de exemplo](https://assets.ctfassets.net/s68ib1kj8k5n/5rD1ZiKEjqStp54qjDB90N/48918dfa8b53a935c7c83ea5fbf3af77/userImportSample.jsonl) para ver a estrutura de arquivo necessária para sua importação.

{% hint style="info" %}
**Observação:** Recomendamos que cada importação não exceda 500.000 entradas.
{% endhint %}

#### Importar participantes em massa

1. No menu de navegação à esquerda, selecione ![](https://impact-1.gitbook.io/docs/emvxfLrwrlacc4y3y02Y/~gitbook/image?url=https%3A%2F%2F4048883401-files.gitbook.io%2F%7E%2Ffiles%2Fv0%2Fb%2Fgitbook-x-prod.appspot.com%2Fo%2Fspaces%252FwMLlMoFBtKJa8ptd3zaw%252Fuploads%252Fgit-blob-230534471fef5f40808e921e41ee44e4a06ded03%252Fe6cb9548999afdc1ed3ce4942e4cb5b45b5cecbd323267aac2a7cd1915fccc09.svg%3Falt%3Dmedia\&width=300\&dpr=3\&quality=100\&sign=71dd50ef\&sv=2) **\[Engage] → Participantes**.
2. Selecione **Importar usuários**.
3. Em *Tipo de importação*, selecione **Usuários**.
4. Adicione seu arquivo de importação selecionando **Selecionar arquivo**.
5. **\[Opcional]** Para adicionar ou remover os participantes importados de um segmento de usuários específico, selecione o segmento na lista suspensa.

{% hint style="info" %}
**Observação:** Esta seleção se aplica a *todos os* participantes incluídos neste arquivo de importação.
{% endhint %}

6. Selecione **Iniciar importação**.

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.

#### Campos

As importações de usuários em massa são compatíveis com campos padrão e campos personalizados no arquivo enviado. **Os campos diferenciam maiúsculas de minúsculas.**

{% tabs %}
{% tab title="Campos padrão" %}
Os campos padrão são processados com a mesma validação usada na [chamada da API Open Endpoint User Upsert](https://integrations.impact.com/integration-guides/for-brands/advocate/advocate-api/api-open-endpoints):

| Campo                     | Tipo    | Descrição                                                                                                                                                                                                                                                                                                                                                                                                                        |
| ------------------------- | ------- | -------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------- |
| accountId (Obrigatório)   | string  | O identificador exclusivo da conta à qual este participante pertence.                                                                                                                                                                                                                                                                                                                                                            |
| id (Obrigatório)          | string  | O identificador exclusivo fornecido para este participante.                                                                                                                                                                                                                                                                                                                                                                      |
| firstName                 | string  | O primeiro nome do participante.                                                                                                                                                                                                                                                                                                                                                                                                 |
| lastName                  | string  | O sobrenome do participante.                                                                                                                                                                                                                                                                                                                                                                                                     |
| email                     | string  | O endereço de e-mail do participante.                                                                                                                                                                                                                                                                                                                                                                                            |
| referable                 | boolean | <p>Indicador usado pelo impact.com para determinar se um participante pode ser indicado.</p><p><strong>Observação:</strong> O indicador deve ser escrito usando apenas <em>um</em> <code>r</code> para que o status seja modificado com sucesso.</p>                                                                                                                                                                             |
| localidade                | string  | A localidade do participante, usada para [internacionalização](https://help.impact.com/brand/pt-br/what-would-you-like-to-learn-about/advocate-program/advocate-program-settings/translate-and-localize-your-advocate-program.md). A localidade deve estar no formato `language_COUNTRY` em que o código do idioma deve estar em letras minúsculas e o código do país, em letras maiúsculas. O separador deve ser um sublinhado. |
| countryCode               | string  | A localidade do participante, usada para [internacionalização](https://help.impact.com/brand/pt-br/what-would-you-like-to-learn-about/advocate-program/advocate-program-settings/translate-and-localize-your-advocate-program.md). O código do país do usuário (por exemplo, CA).                                                                                                                                                |
| referredBy.code           | string  | O código de indicação do defensor do cliente que indicou este participante.                                                                                                                                                                                                                                                                                                                                                      |
| referralCodes.{programId} | string  | O código de indicação personalizado que este participante pode compartilhar para o programa especificado (gerado automaticamente se não for informado).                                                                                                                                                                                                                                                                          |
| sharelinks.{programId}    | string  | O link de compartilhamento personalizado que este participante pode compartilhar para o programa especificado (gerado automaticamente se não for informado).                                                                                                                                                                                                                                                                     |
| dateCreated               | string  | A data em que este participante foi criado no seu programa Advocate.                                                                                                                                                                                                                                                                                                                                                             |
| imageUrl                  | string  | Usado opcionalmente em widgets, e-mails e temas. Se você fornecer uma URL absoluta para a imagem de perfil, o tamanho mínimo da imagem será de 80 px × 80 px.                                                                                                                                                                                                                                                                    |
| dateUsTaxFormSubmitted    | inteiro | A data em que o formulário fiscal W-9 de um participante foi marcado como coletado. Usado para a conformidade com o W-9 no seu tenant, se configurado.                                                                                                                                                                                                                                                                           |
| customFields.{fieldName}  | string  | Use esta estrutura para incluir um campo personalizado à sua escolha.                                                                                                                                                                                                                                                                                                                                                            |
| {% endtab %}              |         |                                                                                                                                                                                                                                                                                                                                                                                                                                  |

{% tab title="Campos personalizados" %}
[Campos de usuário personalizados](https://help.impact.com/brand/pt-br/what-would-you-like-to-learn-about/advocate-program/manage-advocate-participants/custom-and-calculated-fields/custom-fields-for-advocate-explained.md) permitem incluir dados específicos dos seus participantes. Você pode configurar as metas do seu programa para serem acionadas com base nas informações de um campo de usuário personalizado.

{% hint style="info" %}
**Exemplo**: recompense os participantes quando renovarem a assinatura. Primeiro, inclua o campo personalizado `customFields.subscriptionPaid` com o valor **sim**. Em seguida, configure a meta para ser convertida quando `customFields.subscriptionPaid` for igual a **sim**.
{% endhint %}

Adicione campos personalizados ao cabeçalho da coluna neste formato: `customFields.yourCustomFieldName`.

{% hint style="info" %}
**Observação:** Os campos personalizados não aceitam valores de matriz ou objeto.
{% endhint %}
{% endtab %}
{% endtabs %}

**Resultados**

Enviaremos uma notificação por e-mail quando a importação for concluída. Você pode baixar os resultados da importação em ![](https://impact-1.gitbook.io/docs/emvxfLrwrlacc4y3y02Y/~gitbook/image?url=https%3A%2F%2F4048883401-files.gitbook.io%2F%7E%2Ffiles%2Fv0%2Fb%2Fgitbook-x-prod.appspot.com%2Fo%2Fspaces%252FwMLlMoFBtKJa8ptd3zaw%252Fuploads%252Fgit-blob-230534471fef5f40808e921e41ee44e4a06ded03%252Fe6cb9548999afdc1ed3ce4942e4cb5b45b5cecbd323267aac2a7cd1915fccc09.svg%3Falt%3Dmedia\&width=300\&dpr=3\&quality=100\&sign=71dd50ef\&sv=2) **\[Engage] → Relatórios → Importações e exportações** no seu programa Advocate.

{% hint style="warning" %}
**Aviso:** Os links para download expiram após 30 dias.
{% endhint %}

{% tabs %}
{% tab title="Upload concluído com sucesso" %}
Se a importação for concluída com sucesso, um arquivo com as informações dos participantes será gerado e enviado a você por e-mail. As informações incluídas nesses resultados são as mesmas do nosso [relatório de detalhes do usuário](https://help.impact.com/brand/pt-br/what-would-you-like-to-learn-about/advocate-program/advocate-reporting-and-analytics/advocate-program-reports-explained.md).
{% endtab %}

{% tab title="Erros" %}
Se ocorrer algum erro durante a importação, será gerado um arquivo adicional. Esse arquivo de erros inclui uma entrada para cada erro ocorrido, com o número da linha do registro (no arquivo de importação original) que falhou e as mensagens de erro associadas.

| recordNumber | message                                         | apiErrorCode | statusCode |
| ------------ | ----------------------------------------------- | ------------ | ---------- |
| 2            | Esta solicitação exige um id válido e não vazio | BAD\_REQUEST | 400        |

Na improvável eventualidade de ocorrer um erro no sistema e a importação ser interrompida, ela aparecerá como **aborted** e não será retomada. Entre em contato com nossa equipe de suporte se precisar de mais ajuda.
{% endtab %}
{% endtabs %}


---

# 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/manage-advocate-participants/import-advocate-participants-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.
