# Importar participantes do Advocate em massa
Advocate aceita importações enviadas em `.csv` ou `.jsonl` formatos de arquivo. 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 exigida 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  **\[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 é enviado. As importações podem levar até 30 minutos, dependendo da fila e do tamanho do arquivo.
#### Campos
Importações em massa de usuários suportam tanto Campos Padrão quanto 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 analisados com a mesma validação que nossa [chamada de API Open Endpoint User Upsert](https://integrations.impact.com/impact-brand/docs/api-open-endpoints):
| Campo | Tipo | Descrição |
| ------------------------- | ------- | --------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------- |
| accountId (Obrigatório) | string | O identificador único da conta à qual este participante pertence. |
| id (Obrigatório) | string | O identificador único 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 | Bandeira usada pela impact.com para determinar se um participante pode ser referenciado.
Observação: A bandeira deve ser soletrada com apenas um r para que o status seja modificado com sucesso.
|
| locale | string | O locale do participante, usado para [Internacionalização](https://help.impact.com/brand/pt-br/sobre-o-que-voce-gostaria-de-aprender/advocate-program/advocate-program-settings/translate-and-localize-your-advocate-program). O locale deve ter o formato `language_COUNTRY` onde o código de idioma deve estar em minúsculas e o código do país deve estar em maiúsculas. O separador deve ser um underscore. |
| countryCode | string | O locale do participante, usado para [Internacionalização](https://help.impact.com/brand/pt-br/sobre-o-que-voce-gostaria-de-aprender/advocate-program/advocate-program-settings/translate-and-localize-your-advocate-program). O código do país do usuário (ex.: 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 para este participante compartilhar no programa especificado (gerado automaticamente se não incluído). |
| sharelinks.{programId} | string | O link de compartilhamento personalizado para este participante compartilhar no programa especificado (gerado automaticamente se não incluído). |
| dateCreated | string | A data em que este participante foi criado em seu programa Advocate. |
| imageUrl | string | Opcionalmente usado em widgets, e-mails e temas. Se você fornecer uma URL absoluta de imagem de perfil, o tamanho mínimo da imagem é 80px x 80px. |
| dateUsTaxFormSubmitted | integer | A data em que o formulário W-9 do participante foi marcado como coletado. Usado para conformidade com W-9 em seu tenant, se configurado. |
| customFields.{fieldName} | string | Use esta estrutura para incluir um campo personalizado de sua escolha. |
| {% endtab %} | | |
{% tab title="Campos personalizados" %}
[Campos personalizados do usuário](https://help.impact.com/brand/pt-br/sobre-o-que-voce-gostaria-de-aprender/advocate-program/manage-advocate-participants/custom-and-calculated-fields/custom-fields-for-advocate-explained) permitem dados únicos para seus participantes. Você pode definir as metas do seu programa para serem acionadas com base nas informações em um campo de usuário personalizado.
{% hint style="info" %}
**Exemplo**: Recompense participantes quando renovarem a assinatura do clube. Primeiro, inclua o campo personalizado `customFields.subscriptionPaid` com o valor **sim**. Em seguida, defina a meta para converter quando `customFields.subscriptionPaid` for igual a **sim**.
{% endhint %}
Adicione campos personalizados no cabeçalho da coluna neste formato: `customFields.yourCustomFieldName`.
{% hint style="info" %}
**Observação:** Campos personalizados não podem aceitar valores de array ou objeto.
{% endhint %}
{% endtab %}
{% endtabs %}
**Resultados**
Notificamos você por e-mail quando sua importação for concluída. Você pode baixar os resultados da importação em  **\[Engage] → Relatórios → Importações e Exportações** página dentro do seu programa Advocate.
{% hint style="warning" %}
**Aviso:** Os links de download expirarão após 30 dias.
{% endhint %}
{% tabs %}
{% tab title="Upload bem-sucedido" %}
Se a importação for concluída com sucesso, um arquivo com as informações dos participantes será gerado e enviado por e-mail para você. As informações incluídas nesses resultados são as mesmas encontradas em nosso [relatório de detalhes do usuário](https://help.impact.com/brand/pt-br/sobre-o-que-voce-gostaria-de-aprender/advocate-program/advocate-reporting-and-analytics/advocate-program-reports-explained).
{% endtab %}
{% tab title="Erros" %}
Se ocorrerem erros durante a importação, um arquivo adicional será gerado. Esse arquivo de erros inclui entradas para cada erro ocorrido, incluindo o número da linha do registro (do arquivo de importação inicial) que falhou e quaisquer mensagens de erro associadas.
| recordNumber | message | apiErrorCode | statusCode |
| ------------ | ------------------------------------------------ | ------------ | ---------- |
| 2 | Esta solicitação requer um id válido e não vazio | BAD\_REQUEST | 400 |
No caso improvável de ocorrer um erro de sistema e a importação ser interrompida, a importação aparecerá como **abortada** e não será recuperada. Entre em contato com nossa equipe de Suporte se precisar de mais assistência.
{% endtab %}
{% endtabs %}