Cuentas
Cargar el padrón de usuarios por CSV desde el panel, y leer el resultado de cada carga
Para el primer onboarding masivo no tiene sentido llamar a la API de a un usuario: el padrón ya existe. El Control Center tiene una carga por CSV para eso.
No es un módulo propio del menú. Se llega desde Audiencias, con Ver cargas, o creando una carga nueva desde ahí.
El flujo
- Desde Audiencias, abrí Nueva carga de cuentas.
- Subí un CSV con las columnas
email, name, externalId. Solo se acepta.csv. - Opcionalmente, asociá la carga a una audiencia: ninguna, una existente, o una nueva creada en el momento con nombre y descripción.
- El archivo se valida antes de procesarse. Si la validación pasa, la carga se encola.
Estados de una carga
| Estado | Qué significa |
|---|---|
| Pendiente de subida | La carga se creó, el archivo todavía no llegó. |
| Validando | Se está verificando el formato y el contenido. |
| Procesando | El archivo pasó la validación y se están creando las cuentas. |
| Completado | Terminó. |
| Validación fallida | El archivo no pasó la validación; no se creó ninguna cuenta. |
| Abortado (errores) | Se superó el umbral de filas con error y la carga se detuvo. |
| Abortado (sin progreso) | La carga se quedó sin avanzar y el sistema la cortó. |
| Abortado por el usuario | Alguien la canceló desde el panel. |
El resultado
El listado muestra, por carga: estado, fecha, quién la inició, y cuántas filas fueron procesadas, creadas, actualizadas y fallidas.
Una fila que trae un externalId que ya existe actualiza esa cuenta en vez de duplicarla — por eso "creadas" y "actualizadas" se cuentan por separado.
Las filas fallidas se pueden ver en detalle, con el motivo de cada una, y el archivo original se puede descargar para corregirlo y volver a subirlo.
La carga masiva también se puede automatizar por API, pero esos endpoints no forman parte de la vista de integración publicada. Si necesitás automatizarla, coordinalo con el equipo de UIN.
Cuándo usar cada camino
| Camino | Cuándo |
|---|---|
| CSV desde el Control Center | Carga inicial del padrón, o incorporaciones masivas puntuales. |
POST /accounts/resolve | En caliente, la primera vez que un usuario aparece. Es el camino normal una vez que estás en régimen. |
| API de carga masiva | Si la incorporación masiva es recurrente y querés automatizarla. |