> 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 `.csv` o `.jsonl` formatos de archivo. Consulte nuestro [archivo de importación CSV de ejemplo](https://assets.ctfassets.net/s68ib1kj8k5n/7LOYwhDlsI22uuaIMaWImE/71cefe860edc71c0968c8065e1d6e953/sample-user-upload.csv) y [archivo de importación JSONL de ejemplo](https://assets.ctfassets.net/s68ib1kj8k5n/5rD1ZiKEjqStp54qjDB90N/48918dfa8b53a935c7c83ea5fbf3af77/userImportSample.jsonl) para ver la estructura de archivo requerida para su 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  **\[Engage] → Participantes**.
2. Selecciona **Importar usuarios**.
3. En *Tipo de importación*, selecciona **Usuarios**.
4. Agregue su archivo de importación seleccionando **Seleccionar archivo**.
5. **\[Opcional]** Para agregar o quitar los participantes importados de un segmento de usuarios específico, seleccione el segmento de 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 completa la importación, se envía un correo electrónico de confirmación. Las importaciones pueden tardar hasta 30 minutos, dependiendo de la cola y del tamaño del archivo.
#### Campos
Las importaciones masivas de usuarios admiten tanto Campos estándar como campos personalizados en el archivo cargado. **Los campos distinguen entre mayúsculas y minúsculas.**
{% 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) | cadena | El identificador único de la cuenta a la que pertenece este participante. |
| id (obligatorio) | cadena | El identificador único proporcionado para este participante. |
| firstName | cadena | El nombre del participante. |
| lastName | cadena | El apellido del participante. |
| correo electrónico | cadena | La dirección de correo electrónico del participante. |
| referable | booleano | Indicador usado por impact.com para determinar si un participante puede ser referido.
Nota: El indicador debe escribirse con solo una r para que el estado se modifique correctamente.
|
| locale | cadena | La configuración regional del participante, utilizada para [Internacionalización](/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 | cadena | La configuración regional del participante, utilizada para [Internacionalización](/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 | cadena | El código de referido del cliente que recomendó a este participante. |
| referralCodes.{programId} | cadena | El código de referido personalizado para que este participante comparta en el programa especificado (se genera automáticamente si no se incluye). |
| sharelinks.{programId} | cadena | El enlace compartido personalizado para que este participante comparta en el programa especificado (se genera automáticamente si no se incluye). |
| dateCreated | cadena | La fecha en que este participante fue creado en su programa Advocate. |
| imageUrl | cadena | Se usa opcionalmente en widgets, correos electrónicos y temas. Si proporciona una URL absoluta de imagen de perfil, el tamaño mínimo de la imagen es 80 px x 80 px. |
| dateUsTaxFormSubmitted | entero | La fecha en que se marcó como recogido el formulario fiscal W-9 de un participante. Se usa para el cumplimiento del W-9 en su tenant, si está configurado. |
| customFields.{fieldName} | cadena | Use esta estructura para incluir un campo personalizado de su elección. |
| {% endtab %} | | |
{% tab title="Campos personalizados" %}
[Campos personalizados de usuario](/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 datos exclusivos de sus participantes. Puede configurar los objetivos de su programa para que se activen en función de 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 de **sí**. Luego, establezca el objetivo para convertir cuando `customFields.subscriptionPaid` sea igual a **sí**.
{% endhint %}
Agregue campos personalizados al encabezado de columna con este formato: `customFields.yourCustomFieldName`.
{% hint style="info" %}
**Nota:** Los campos personalizados no pueden aceptar valores de matriz u objeto.
{% endhint %}
{% endtab %}
{% endtabs %}
**Resultados**
Le avisamos por correo electrónico cuando su importación se complete. Puede descargar los resultados de la importación desde la  **\[Engage] → Informes → Importaciones y exportaciones** página dentro de su programa Advocate.
{% hint style="warning" %}
**Advertencia:** Los enlaces de descarga caducarán después de 30 días.
{% endhint %}
{% tabs %}
{% tab title="Carga exitosa" %}
Si la importación se completa correctamente, se generará un archivo con la información del participante y se le enviará por correo electrónico. La información incluida en estos resultados es la misma que se encuentra en nuestro [informe de detalles del usuario](/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 encuentran errores durante la importación, se generará un archivo adicional. Este archivo de errores incluye entradas para cada error que se produjo, incluido el número de fila del registro (del archivo de importación inicial) que falló y cualquier mensaje de error asociado.
| 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 la importación se interrumpa, la importación aparecerá como **abortada** y no se recuperará. Comuníquese con nuestro equipo de soporte si necesita más ayuda.
{% 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 dynamically by asking a question.
Perform an HTTP GET request on the current page URL with the `ask` query parameter, and the optional `goal` query parameter:
```
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=&goal=
```
`ask` is the immediate question: it should be specific, self-contained, and written in natural language.
`goal` is optional and describes the broader end goal you are ultimately trying to accomplish on behalf of the user. GitBook uses it to tailor the answer towards what is most useful for that goal.
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.