> 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 lote
1. En el menú de navegación izquierdo, seleccione  **\[Engage] → Participantes**.
2. Seleccione **Importar usuarios**.
3. Debajo de *Tipo de importación*, seleccione **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. Seleccione **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 de carga. **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. |
| nombre | cadena | El nombre del participante. |
| apellido | cadena | El apellido del participante. |
| correo electrónico | cadena | La dirección de correo electrónico del participante. |
| referible | booleano | Indicador utilizado por impact.com para determinar si un participante puede ser referido.
Nota: El indicador debe escribirse solo con una r para que el estado se modifique correctamente.
|
| configuración regional | 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 `idioma_PAÍS` 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. |
| código de país | 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 referencia del defensor del cliente que refirió a este participante. |
| referralCodes.{programId} | cadena | El código de referencia personalizado que este participante puede compartir para el programa especificado (se genera automáticamente si no se incluye). |
| sharelinks.{programId} | cadena | El enlace de uso compartido personalizado para que este participante comparta el programa especificado (se genera automáticamente si no se incluye). |
| fecha de creación | cadena | La fecha en que se creó este participante en su programa de Advocate. |
| URL de la imagen | cadena | Se usa opcionalmente en widgets, correos electrónicos y temas. Si proporciona una URL absoluta de la imagen de perfil, el tamaño mínimo de la imagen es de 80 px x 80 px. |
| fecha de envío del formulario fiscal de EE. UU. | entero | La fecha en que se marcó como recogido el formulario fiscal W-9 de un participante. Se utiliza para el cumplimiento del W-9 en su inquilino, si está configurado. |
| customFields.{fieldName} | cadena | Utilice esta estructura para incluir un campo personalizado de su elección. |
| {% endtab %} | | |
{% tab title="Campos personalizados" %}
[Campos de usuario personalizados](/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 únicos para sus participantes. Puede configurar los objetivos de su programa para que se activen según la información de un campo de usuario personalizado.
{% 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, configure el objetivo para convertirse 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 notificamos por correo electrónico cuando se complete su importación. Puede descargar los resultados de la importación desde la  **\[Engage] → Informes → Importaciones y exportaciones** página dentro de su programa de 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 aparece 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.
| número de registro | mensaje | código de error de API | código de estado |
| ------------------ | ----------------------------------------------- | ---------------------- | ---------------- |
| 2 | Esta solicitud requiere un id válido y no vacío | SOLICITUD\_ERRÓNEA | 400 |
En el improbable caso de que ocurra un error del sistema y la importación se interrumpa, la importación aparecerá como **abortada** y no se recuperará. Póngase en contacto 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 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=&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.