# Importar participantes de Advocate en masa
Advocate acepta importaciones enviadas en `.csv` o `.jsonl` formatos de archivo. Consulte nuestro [archivo de importación CSV de muestra](https://assets.ctfassets.net/s68ib1kj8k5n/7LOYwhDlsI22uuaIMaWImE/71cefe860edc71c0968c8065e1d6e953/sample-user-upload.csv) y [archivo de importación JSONL de muestra](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 izquierdo, seleccione  **\[Engage] → Participants**.
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 eliminar 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 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 Standard Fields como campos personalizados en el archivo cargado. **Los campos distinguen entre mayúsculas y minúsculas.**
{% tabs %}
{% tab title="Standard Fields" %}
Los campos estándar se analizan con la misma validación que nuestra [llamada API Open Endpoint User Upsert](https://integrations.impact.com/impact-brand/docs/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. |
| email | cadena | La dirección de correo electrónico del participante. |
| referable | booleano | Marca utilizada por impact.com para determinar si un participante puede ser referido.
Nota: La marca 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 debe estar 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 (por ejemplo, CA). |
| referredBy.code | cadena | El código de referencia del customer advocate que refirió a este participante. |
| referralCodes.{programId} | cadena | El código de referencia personalizado para que este participante comparta para el programa especificado (se genera automáticamente si no se incluye). |
| sharelinks.{programId} | cadena | El enlace de compartición personalizado para que este participante comparta para 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 el Formulario de impuestos W-9 de un participante se marcó como recopilado. Se usa para el cumplimiento W-9 en su tenant, si está configurado. |
| customFields.{fieldName} | cadena | Use esta estructura para incluir el campo personalizado que elija. |
| {% endtab %} | | |
{% tab title="Campos personalizados" %}
[Los 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 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 de **sí**. Luego, establezca el objetivo para convertir cuando `customFields.subscriptionPaid` sea igual a **sí**.
{% endhint %}
Agregue campos personalizados al encabezado de la columna en este formato: `customFields.yourCustomFieldName`.
{% hint style="info" %}
**Nota:** Los campos personalizados no pueden aceptar valores de matriz u objeto.
{% endhint %}
{% endtab %}
{% endtabs %}
**Resultados**
Le notificaremos por correo electrónico cuando su importación esté completa. Puede descargar los resultados de la importación desde la página de  **\[Engage] → Informes → Importaciones y exportaciones** en su programa Advocate.
{% hint style="warning" %}
**Advertencia:** Los enlaces de descarga expirarán después de 30 días.
{% endhint %}
{% tabs %}
{% tab title="Carga exitosa" %}
Si la importación se completa correctamente, se generará y le enviará por correo electrónico un archivo con la información de los participantes. La información incluida en estos resultados es la misma que se encuentra en nuestro [informe de detalles de 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 ocurrió, 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 ocurra un error del sistema y la importación se interrumpa, entonces 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: 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:
```
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=
```
The question should be specific, self-contained, and written in natural language.
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.