> 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/es/what-would-you-like-to-learn-about/advocate-program/manage-advocate-participants/import-advocate-participants-in-bulk.md).

# Importar participantes de Advocate en bloque

Advocate acepta importaciones enviadas en formato `.csv` o `.jsonl` . Consulta nuestro [archivo CSV de importación de ejemplo](https://assets.ctfassets.net/s68ib1kj8k5n/7LOYwhDlsI22uuaIMaWImE/71cefe860edc71c0968c8065e1d6e953/sample-user-upload.csv) y el [archivo JSONL de importación de ejemplo](https://assets.ctfassets.net/s68ib1kj8k5n/5rD1ZiKEjqStp54qjDB90N/48918dfa8b53a935c7c83ea5fbf3af77/userImportSample.jsonl) para ver la estructura de archivo requerida para la importación.

{% hint style="info" %}
**Nota:** Recomendamos que cada importación no supere las 500 000 entradas.
{% endhint %}

#### Importar participantes en bloque

1. En el menú de navegación de la izquierda, selecciona ![](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] → Participants**.
2. Selecciona **Importar usuarios**.
3. En *Tipo de importación*, selecciona **Usuarios**.
4. Añade el archivo de importación seleccionando **Seleccionar archivo**.
5. **\[Opcional]** Para añadir los participantes importados a un segmento de usuarios específico o eliminarlos de él, selecciona el segmento en la lista desplegable.

{% hint style="info" %}
**Nota:** Esta selección se aplica a *todos los* participantes incluidos en este archivo de importación.
{% endhint %}

6. Selecciona **Iniciar importación**.

Cuando se complete la importación, se enviará un correo electrónico de confirmación. Las importaciones pueden tardar hasta 30 minutos, según la cola y el tamaño del archivo.

#### Campos

Las importaciones masivas de usuarios admiten tanto campos estándar como campos personalizados en el archivo cargado. **Se distingue entre mayúsculas y minúsculas en los campos.**

{% tabs %}
{% tab title="Campos estándar" %}
Los campos estándar se analizan con la misma validación que nuestra [llamada a la API Open Endpoint User Upsert](https://integrations.impact.com/integration-guides/for-brands/advocate/advocate-api/api-open-endpoints):

| Campo                     | Tipo    | Descripción                                                                                                                                                                                                                                                                                                                                                                                                                                          |
| ------------------------- | ------- | ---------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------- |
| accountId (obligatorio)   | string  | El identificador único de la cuenta a la que pertenece este participante.                                                                                                                                                                                                                                                                                                                                                                            |
| id (obligatorio)          | string  | El identificador único proporcionado para este participante.                                                                                                                                                                                                                                                                                                                                                                                         |
| firstName                 | string  | El nombre del participante.                                                                                                                                                                                                                                                                                                                                                                                                                          |
| lastName                  | string  | El apellido del participante.                                                                                                                                                                                                                                                                                                                                                                                                                        |
| email                     | string  | La dirección de correo electrónico del participante.                                                                                                                                                                                                                                                                                                                                                                                                 |
| referable                 | boolean | <p>Indicador que impact.com utiliza para determinar si se puede recomendar a un participante.</p><p><strong>Nota:</strong> El indicador debe escribirse únicamente con <em>uno</em> <code>r</code> para que el estado se modifique correctamente.</p>                                                                                                                                                                                                |
| configuración regional    | string  | La configuración regional del participante, utilizada para [la internacionalización](https://help.impact.com/brand/es/what-would-you-like-to-learn-about/advocate-program/advocate-program-settings/translate-and-localize-your-advocate-program.md). La configuración regional debe tener el formato `language_COUNTRY` donde el código de idioma debe estar en minúsculas y el código de país, en mayúsculas. El separador debe ser un guion bajo. |
| countryCode               | string  | La configuración regional del participante, utilizada para [la internacionalización](https://help.impact.com/brand/es/what-would-you-like-to-learn-about/advocate-program/advocate-program-settings/translate-and-localize-your-advocate-program.md). El código de país del usuario (p. ej., CA).                                                                                                                                                    |
| referredBy.code           | string  | El código de referido del promotor de clientes que refirió a este participante.                                                                                                                                                                                                                                                                                                                                                                      |
| referralCodes.{programId} | string  | El código de referido personalizado que este participante puede compartir para el programa especificado (se genera automáticamente si no se incluye).                                                                                                                                                                                                                                                                                                |
| sharelinks.{programId}    | string  | El enlace personalizado que este participante puede compartir para el programa especificado (se genera automáticamente si no se incluye).                                                                                                                                                                                                                                                                                                            |
| dateCreated               | string  | La fecha en que se creó este participante en su programa Advocate.                                                                                                                                                                                                                                                                                                                                                                                   |
| imageUrl                  | string  | Se usa opcionalmente en widgets, correos electrónicos y temas. Si proporciona una URL absoluta para la imagen de perfil, el tamaño mínimo de la imagen debe ser de 80 px x 80 px.                                                                                                                                                                                                                                                                    |
| dateUsTaxFormSubmitted    | entero  | La fecha en que se marcó como recopilado el formulario fiscal W-9 del participante. Se usa para el cumplimiento de W-9 en su tenant, si está configurado.                                                                                                                                                                                                                                                                                            |
| customFields.{fieldName}  | string  | Use esta estructura para incluir un campo personalizado de su elección.                                                                                                                                                                                                                                                                                                                                                                              |
| {% endtab %}              |         |                                                                                                                                                                                                                                                                                                                                                                                                                                                      |

{% tab title="Campos personalizados" %}
[Los campos personalizados de usuario](https://help.impact.com/brand/es/what-would-you-like-to-learn-about/advocate-program/manage-advocate-participants/custom-and-calculated-fields/custom-fields-for-advocate-explained.md) permiten incluir datos específicos de sus participantes. Puede configurar los objetivos de su programa para que se activen según la información de un campo personalizado de usuario.

{% hint style="info" %}
**Ejemplo**: Recompense a los participantes cuando renueven su suscripción. Primero, incluya el campo personalizado `customFields.subscriptionPaid` con el valor **sí**. Luego, configure el objetivo para que se complete cuando `customFields.subscriptionPaid` sea igual a **sí**.
{% endhint %}

Agregue los campos personalizados al encabezado de la columna con este formato: `customFields.yourCustomFieldName`.

{% hint style="info" %}
**Nota:** Los campos personalizados no admiten valores de matriz ni de objeto.
{% endhint %}
{% endtab %}
{% endtabs %}

**Resultados**

Le enviaremos un correo electrónico cuando se complete la importación. Puede descargar los resultados de la importación desde la página ![](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] → Informes → Importaciones y exportaciones** de su programa Advocate.

{% hint style="warning" %}
**Advertencia:** Los enlaces de descarga caducan después de 30 días.
{% endhint %}

{% tabs %}
{% tab title="Carga correcta" %}
Si la importación se completa correctamente, se generará un archivo con la información de los participantes y se le enviará por correo electrónico. La información incluida en estos resultados es la misma que aparece en nuestro [informe de detalles de usuario](https://help.impact.com/brand/es/what-would-you-like-to-learn-about/advocate-program/advocate-reporting-and-analytics/advocate-program-reports-explained.md).
{% endtab %}

{% tab title="Errores" %}
Si se produce algún error durante la importación, se generará un archivo adicional. Este archivo de errores incluye una entrada por cada error, con el número de fila del registro (del archivo de importación original) que produjo el error y los mensajes de error asociados.

| recordNumber | message                                         | apiErrorCode | statusCode |
| ------------ | ----------------------------------------------- | ------------ | ---------- |
| 2            | Esta solicitud requiere un id válido y no vacío | BAD\_REQUEST | 400        |

En el improbable caso de que se produzca un error del sistema y se interrumpa la importación, esta aparecerá como **aborted** y no se reanudará. Si necesita más ayuda, póngase en contacto con nuestro equipo de soporte.
{% 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/es/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.
