Adicionar à lista

Acrescenta um valor a uma lista da conta, opcionalmente com prazo de validade.

Configuração	Conteúdo
Lista	lista existente na conta
Origem: Valor	um campo do evento (Campo) ou uma expressão (Expressão)
Ajuste: Expira em	30m, 12h, 1d; mínimo 5m, máximo 2 anos; vazio = permanente

No modo Campo, o valor vem de um campo de texto, de lista, numérico, booleano ou de data e hora. No modo Expressão, o valor segue a sintaxe das ações: um campo, uma variável temporária, um concat, um split, um join ou um valor fixo. A expressão monta, por exemplo, uma chave composta:

Adicionar à lista → concat($user_id, "-", $merchant_id) em @pares_bloqueados, expira em 1d

O valor adicionado é único e convertido em texto. Um conjunto, como %bot.triggered_cells, é recusado ao salvar a regra, assim como um valor fixo fora do formato aceito pela lista.

Com esta ação a regra incorpora o que já observou. Uma condição detecta o comportamento e escreve na lista, e os eventos seguintes consultam essa lista com uma condição comum:

Evento 1, condição:  "email_velocity" in %bot.triggered_cells
          ação:      Adicionar à lista → $user_email em @emails_bloqueados, expira em 1d

Evento 2, condição:  $user_email in @emails_bloqueados
          ação:      Preencher campo → bloqueado = "true"

Com um prazo de validade, a recuperação passa a ser uma política explícita: a entrada sai da lista ao vencer, em vez de depender da janela da análise que a originou.

Pontos a considerar:

• Reincidência não duplica: adicionar um valor que já está na lista apenas renova o prazo.
• Valores inválidos são ignorados: um valor em branco, ou fora do formato aceito pela lista, não é adicionado e não interrompe o processamento.
• A remoção é periódica: varreduras a cada poucos minutos removem as entradas vencidas. Uma entrada pode continuar valendo um pouco além do prazo, e por isso o prazo mínimo é de 5 minutos.
• Listas cheias param de crescer: atingido o limite de itens, valores novos deixam de ser adicionados, mas os já existentes continuam sendo renovados. Consulte limites e parâmetros.

Por alterar dados fora do evento, esta ação é ignorada durante uma simulação: o simulador não escreve na lista.