Ações em massa

As ações em massa são como você altera muitos registros de membros de uma vez. Em vez de abrir 200 perfis para definir o mesmo campo personalizado, você seleciona os 200 da lista de membros e executa uma única ação. O trabalho roda em segundo plano, você pode acompanhar a barra de progresso, e qualquer linha que falhe volta com um erro que pode ser tentado novamente.

Cada ação em massa — seja disparada da lista de membros, da rede de conexões ou de uma vista filtrada — aterriza no mesmo histórico em Ações em massa na barra lateral. Esse histórico é a fonte da verdade para "o que foi alterado, por quem, quando e se funcionou."

Quando usar uma ação em massa

Recorra a uma ação em massa quando:

• Você precisa alterar o mesmo campo em mais do que um punhado de membros.
• Você quer enviar mensagem a uma fatia filtrada (ex. "todos no ministério de Jovens que não fizeram check-in há 4 semanas").
• Você está limpando — marcando membros inativos como perdidos, excluindo registros de teste ou geocodificando um acúmulo de endereços.
• Você está integrando — atribuindo uma nova leva de membros a um grupo inicial ou workflow.

Para um único membro, a barra de ações dentro do perfil dele é mais rápida. As ações em massa valem o custo quando sua seleção passa de cerca de dez linhas.

O que você pode fazer em massa

Ação	O que altera
Edição em massa	Qualquer campo padrão, junção (unidade org / ministério / escola) ou campo personalizado
Enviar mensagem	WhatsApp, SMS ou e-mail através do canal configurado
Atribuir ou presença	Unidade org, ministério, grupo, matrícula em escola, gatilho de workflow, presença em uma reunião
Marcar como perdido / excluir / restaurar	Arquivar suavemente membros, excluí-los suavemente ou restaurá-los do estado perdido
Geocodificar endereços	Reexecuta o geocodificador em membros cujos endereços mudaram

Cada ação tem sua própria linha na edge function process-bulk-action, então as regras de validação são as mesmas dos equivalentes de membro único. Você não pode editar em massa um campo que um único membro não poderia ter.

Como uma ação em massa é executada

1. Você seleciona membros e escolhe uma ação. A UI abre um diálogo de confirmação com a contagem de linhas afetadas.
2. Ao confirmar, uma linha bulk_actions é inserida com status queued e a edge function é invocada.
3. A função valida que cada membro alvo pertence à sua org, depois muda a linha para processing.
4. Os membros são processados em lotes de 50. Após cada lote, os campos success_count, failed_count e failed_items da linha são atualizados para que a barra de progresso da UI se mova em tempo real.
5. Quando o último lote termina, o status passa para complete (algum sucesso), failed (zero sucessos), ou permanece delegated para ações entregues a outra fila (geocodificação, mensageria).
6. Você recebe uma notificação in-app com o resultado e um link de volta para a página de detalhe da ação.

TIP

No máximo duas ações em massa rodam em paralelo por org. Qualquer coisa além disso fica em queued até que um slot se libere — a UI mostra como na fila, não travado.

Referência de status

Status	Significado
queued	A linha existe; o processamento ainda não começou. Geralmente muda em segundos.
processing	Os lotes estão sendo aplicados. A barra de progresso se move.
delegated	Entregue a outra fila (mensageria, geocodificação). A conclusão é rastreada por um cron de reconciliação.
complete	Todos os lotes terminados. Pode ainda incluir falhas por linha — verifique failed_count.
failed	Cada linha alvo falhou. Olhe a tabela de itens com falha.
cancelled	Você parou a ação no meio do caminho. Os sucessos já aplicados permanecem aplicados.

Permissões

Você precisa da permissão members.edit para iniciar qualquer ação em massa. Enviar mensagens também requer messaging.send. Os administradores de plataforma podem ver as ações em massa de cada org quando personificam outro usuário; os administradores da própria org veem apenas as suas.

WARNING

A exclusão em massa é permanente após 30 dias. Até lá, os membros excluídos vivem na lixeira e podem ser restaurados — inclusive por um administrador diferente. Após 30 dias, a linha é excluída permanentemente por um job noturno.

Próximos passos

1. Criar uma ação em massa — o fluxo de seleção-e-confirmação.
2. Edição em massa — a ação mais usada.
3. Enviar uma mensagem — para alcance e anúncios.
4. Atribuir e presença — conecte os membros à estrutura organizacional correta.
5. Marcar como perdido / excluir / restaurar — para mudanças no ciclo de vida dos membros.
6. Monitoramento e tentativas — quando algo não passa.