# Importar Participantes do Advocate em Lote

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 ![](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 é 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 | <p>Bandeira usada pela impact.com para determinar se um participante pode ser referenciado.</p><p><strong>Observação:</strong> A bandeira deve ser soletrada com apenas <em>um</em> <code>r</code> para que o status seja modificado com sucesso.</p>                                                                                                                     |
| locale                    | string  | O locale do participante, usado para [Internacionalização](https://help.impact.com/brand/pt-br/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/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/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 ![](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** 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/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 %}
