Acciones masivas

Las acciones masivas son cómo cambias muchos registros de miembros a la vez. En lugar de abrir 200 perfiles para establecer el mismo campo personalizado, seleccionas los 200 desde la lista de miembros y ejecutas una sola acción. El trabajo se ejecuta en segundo plano, puedes ver la barra de progreso, y cualquier fila que falle vuelve con un error reintentable.

Cada acción masiva — ya sea disparada desde la lista de miembros, la red de conexiones o una vista filtrada — aterriza en el mismo historial en Acciones masivas en la barra lateral. Ese historial es la fuente de verdad para "qué se cambió, por quién, cuándo y si funcionó."

Cuándo usar una acción masiva

Recurre a una acción masiva cuando:

• Necesitas cambiar el mismo campo en más de un puñado de miembros.
• Quieres enviar mensaje a una porción filtrada (ej. "todos en el ministerio de Jóvenes que no se han registrado en 4 semanas").
• Estás limpiando — marcando miembros inactivos como perdidos, eliminando registros de prueba o geocodificando un atraso de direcciones.
• Estás incorporando — asignando una nueva tanda de miembros a un grupo inicial o flujo de trabajo.

Para un solo miembro, la barra de acciones dentro de su perfil es más rápida. Las acciones masivas ganan su costo cuando tu selección pasa de aproximadamente diez filas.

Qué puedes hacer masivamente

Acción	Qué cambia
Edición masiva	Cualquier campo estándar, junción (unidad org / ministerio / escuela) o campo personalizado
Enviar mensaje	WhatsApp, SMS o correo a través del canal configurado
Asignar o asistir	Unidad org, ministerio, grupo, inscripción a escuela, disparador de flujo de trabajo, asistencia para una reunión
Marcar como perdido / eliminar / restaurar	Archivar suavemente miembros, eliminarlos suavemente o restaurar desde perdido
Geocodificar direcciones	Re-ejecuta el geocodificador en miembros cuyas direcciones cambiaron

Cada acción tiene su propia fila en la edge function process-bulk-action, así que las reglas de validación son las mismas que las equivalentes de miembro individual. No puedes editar masivamente un campo que un solo miembro no podría haber tenido.

Cómo se ejecuta una acción masiva

1. Seleccionas miembros y eliges una acción. La UI abre un diálogo de confirmación con el conteo de filas afectadas.
2. Al confirmar, una fila bulk_actions se inserta con estado queued y la edge function se invoca.
3. La función valida que cada miembro objetivo pertenece a tu org, luego cambia la fila a processing.
4. Los miembros se procesan en lotes de 50. Después de cada lote, los campos success_count, failed_count y failed_items de la fila se actualizan para que la barra de progreso de la UI se mueva en tiempo real.
5. Cuando el último lote termina, el estado se mueve a complete (algún éxito), failed (cero éxitos), o permanece delegated para acciones entregadas a otra cola (geocodificación, mensajería).
6. Recibes una notificación en la app con el resultado y un enlace de vuelta a la página de detalle de la acción.

TIP

Dos acciones masivas se ejecutan en paralelo por org como máximo. Cualquier cosa más allá de eso permanece en queued hasta que un slot se libere — la UI lo muestra como en cola, no atascado.

Referencia de estados

Estado	Significado
queued	La fila existe; el procesamiento no ha comenzado aún. Usualmente cambia en segundos.
processing	Los lotes se están aplicando. La barra de progreso se mueve.
delegated	Entregado a otra cola (mensajería, geocodificación). La finalización se rastrea por un cron de reconciliación.
complete	Todos los lotes terminados. Puede aún incluir fallas por-fila — revisa failed_count.
failed	Cada fila objetivo falló. Mira la tabla de items fallidos.
cancelled	Detuviste la acción a medio camino. Los éxitos ya aplicados permanecen aplicados.

Permisos

Necesitas el permiso members.edit para iniciar cualquier acción masiva. Enviar mensajes también requiere messaging.send. Los administradores de plataforma pueden ver las acciones masivas de cada org cuando se hacen pasar por otro usuario; los propios administradores de la org solo ven las suyas.

WARNING

La eliminación masiva es permanente después de 30 días. Hasta entonces, los miembros eliminados viven en la papelera de reciclaje y pueden ser restaurados — incluso por un administrador diferente. Después de 30 días, la fila se elimina permanentemente por un trabajo nocturno.

Próximos pasos

1. Crear una acción masiva — el flujo de selección-y-confirmación.
2. Edición masiva — la acción más usada.
3. Enviar un mensaje — para alcance y anuncios.
4. Asignar y asistir — conecta miembros a la estructura organizacional correcta.
5. Marcar como perdido / eliminar / restaurar — para cambios en el ciclo de vida de miembros.
6. Monitoreo y reintentos — cuando algo no pasa.