As ações de Cliente alteram o cadastro do cliente que está no fluxo: marcam com tags, colocam ou tiram de grupos, atualizam dados, associam um vendedor e registram anotações. Elas não enviam mensagem. Servem para organizar a base e preparar as próximas ações e condições.
Para adicionar uma delas, clique no + da saída do cartão e abra a aba Cliente do seletor. Se você ainda não conhece o seletor ou as saídas, veja Ações: visão geral.
Aba Cliente do seletor de ações, do início da lista
A mesma aba, rolada até o fim: as últimas ações são Associar vendedor e Criar anotação no cliente
Saídas comuns: todas as ações de cliente têm uma só saída, sem nome no canvas, que segue para o próximo passo. A folha não tem a seção Caminhos extras, então a tela não oferece como ligar um caminho separado para o caso de falha. Nos detalhes da execução, o passo mostra por onde seguiu: Continuar (deu certo) ou Erro (falhou). Quando segue pelo Erro, não há passo ligado a ele, então o cliente não segue adiante por esse caminho, e a execução mostra o motivo. Se a ação for o último passo de um caminho, o canvas mostra A automação é encerrada depois dela.
Quando um campo obrigatório fica vazio, o cartão mostra o selo de pendência e a folha avisa Falta preencher ao tentar salvar.
Tags e grupos disparam outros fluxos. Cada mudança real que estas ações fazem conta para os gatilhos Tag do cliente adicionada, Tag do cliente removida, Entrou em grupo e Saiu de grupo de outros fluxos. Remover e adicionar de novo a mesma tag (ou tirar e pôr de volta no mesmo grupo) dispara de novo. Aplicar uma tag que o cliente já tem, ou colocá-lo num grupo em que ele já está, não dispara nada. Veja Gatilhos de tags e Gatilhos de grupos.
Ação (no seletor) | Título da folha | Em uma frase |
Adicionar tag ao cliente | Adicionar tag ao cliente | Marca o cliente com uma ou mais tags. |
Remover tag do cliente | Remover tag do cliente | Retira tags do cadastro do cliente. |
Adicionar cliente ao grupo | Adicionar ao grupo | Coloca o cliente em um grupo. |
Remover cliente do grupo | Remover do grupo | Retira o cliente de um grupo. |
Atualizar cliente | Alterar dados do cliente | Atualiza um campo do cadastro do cliente. |
Definir metadata do cliente | Campo personalizado do cliente | Grava um campo livre no cliente. |
Associar vendedor | Associar vendedor | Associa um vendedor ao cliente. |
Criar anotação no cliente | Criar anotação no cliente | Adiciona uma anotação com título ao cadastro do cliente. |
Adicionar tag ao cliente
O que faz
Marca o cliente com uma ou mais tags. É uma das ações mais usadas, por isso aparece no grupo Mais usados do seletor. A frase da folha é "Marca o cliente com uma ou mais tags."
Como configurar
Folha "Adicionar tag ao cliente"
Campo (como aparece) | Obrigatório | O que escolher / opções / limites | Para que serve |
Tags do cliente | Sim | Escolha uma ou mais na lista de tags de cliente da sua loja (Selecionar tags). Até 20 tags. O botão Criar nova tag cria uma tag sem sair do fluxo. | Todas as tags escolhidas são aplicadas ao cliente. |
Saídas
Uma só, sem nome no canvas. Sem Caminhos extras.
Exemplo de uso
Exemplo: gatilho Pedido pago → Adicionar tag ao cliente com a tag "Comprou em 2026". Depois você usa essa tag para separar o público em outro fluxo ou campanha.
Pegadinhas e limites
Até 20 tags por passo.
Se uma das tags escolhidas não existir mais, ela é pulada e as outras seguem normalmente (texto da tela).
Sem nenhuma tag escolhida, o cartão mostra Tag não definida e a folha avisa Selecione ao menos uma tag a adicionar.
Cada tag que o cliente ainda não tinha dispara os fluxos com o gatilho Tag do cliente adicionada. Uma tag que ele já tinha não dispara de novo.
Cuidado com laços: se este fluxo começa por Tag do cliente adicionada e, mais adiante, remove e adiciona de novo a mesma tag, ele pode começar outra vez para o mesmo cliente. Controle isso pela reentrada nas Configurações do fluxo.
Nome técnico (para suporte): customer_tag_add
Remover tag do cliente
O que faz
Retira uma ou mais tags do cadastro do cliente.
Como configurar
Campo (como aparece) | Obrigatório | O que escolher / opções / limites | Para que serve |
Tags do cliente | Sim | Escolha uma ou mais na lista de tags de cliente da sua loja (Selecionar tags). Até 20 tags. A folha também mostra o botão Criar nova tag. | As tags que serão removidas do cliente. |
Saídas
Uma só, sem nome no canvas. Sem Caminhos extras.
Exemplo de uso
Exemplo: quando o cliente compra, Remover tag do cliente com a tag "Carrinho abandonado", para ele sair dessa lista.
Pegadinhas e limites
Até 20 tags por passo.
Remover uma tag que o cliente não tem não muda nada (texto da tela) e não dispara nenhum fluxo.
Cada tag realmente removida dispara os fluxos com o gatilho Tag do cliente removida. Se a tag voltar depois e for removida de novo, dispara outra vez.
Sem nenhuma tag escolhida, a folha avisa Selecione ao menos uma tag a remover.
Nome técnico (para suporte): customer_tag_remove
Adicionar cliente ao grupo (folha "Adicionar ao grupo")
O que faz
Coloca o cliente em um grupo de clientes da loja. A frase da folha é "Coloca o cliente em um grupo."
Como configurar
Campo (como aparece) | Obrigatório | O que escolher / opções / limites | Para que serve |
Grupo | Sim | Escolha na lista de grupos de clientes da sua loja (Selecionar grupo). O botão Criar novo grupo cria um grupo sem sair do fluxo. | O grupo em que o cliente será colocado. |
Saídas
Uma só, sem nome no canvas. Sem Caminhos extras.
Exemplo de uso
Exemplo: depois de uma terceira compra, Adicionar cliente ao grupo "Clientes fiéis".
Pegadinhas e limites
O campo Grupo é obrigatório. Sem ele, o cartão mostra Grupo não definido, com selo de pendência, a folha avisa Selecione o grupo de destino. e o fluxo não pode ser ativado.
Colocar o cliente num grupo em que ele ainda não estava dispara os fluxos com o gatilho Entrou em grupo. Se ele já estava no grupo, nada dispara.
Nome técnico (para suporte): customer_cluster_add
Remover cliente do grupo (folha "Remover do grupo")
O que faz
Retira o cliente de um grupo. A frase da folha é "Retira o cliente de um grupo."
Como configurar
Campo (como aparece) | Obrigatório | O que escolher / opções / limites | Para que serve |
Grupo | Sim | Escolha na lista de grupos de clientes da sua loja (Selecionar grupo). | O grupo de onde o cliente será retirado. A folha avisa: se o grupo for recalculado automaticamente, o cliente pode voltar a entrar. |
Saídas
Uma só, sem nome no canvas. Sem Caminhos extras.
Exemplo de uso
Exemplo: o cliente responde a uma pesquisa de satisfação e você tira ele do grupo "Aguardando avaliação".
Pegadinhas e limites
Se o grupo for recalculado automaticamente, o cliente pode voltar a entrar nele depois. Cada saída e cada volta são mudanças reais: disparam de novo os fluxos com Saiu de grupo e Entrou em grupo.
Sem escolher o grupo, a folha avisa Selecione o grupo de origem.
Esta folha não tem o botão Criar novo grupo.
Nome técnico (para suporte): customer_cluster_remove
Atualizar cliente (folha "Alterar dados do cliente")
O que faz
Muda, ou limpa, um dado do cadastro do cliente. A frase da folha é "Atualiza um campo do cadastro do cliente."
Como configurar
Campo (como aparece) | Obrigatório | O que escolher / opções / limites | Para que serve |
Campo | Sim | Nome, Sobrenome, E-mail, Telefone, CPF/CNPJ, Data de nascimento, Gênero, Cidade, Estado, Bairro ou Aceita marketing (Selecionar campo). | Qual dado do cadastro será alterado. |
O que fazer | Sim | Inserir valor (padrão): grava o valor informado no campo, substituindo o que estiver lá. Limpar valor: deixa o campo em branco no cadastro do cliente. | Se vai colocar um valor novo ou apagar o atual. |
Novo valor | Sim, quando O que fazer é Inserir valor | Texto livre, com o botão { } (Inserir variável) para usar dados do cliente, do pedido, do carrinho, do gatilho e os atributos personalizados da loja. Se o Campo for Aceita marketing, o campo vira uma escolha entre Sim e Não. Some quando você escolhe Limpar valor. | O valor que será gravado. |
Saídas
Uma só, sem nome no canvas. Sem Caminhos extras.
Exemplo de uso
Exemplo: quando uma condição identifica que o cliente pediu para parar de receber mensagens, Atualizar cliente com Campo = Aceita marketing, O que fazer = Inserir valor e Novo valor = Não.
Pegadinhas e limites
Cada passo altera um campo. Para mudar mais de um, use mais passos.
A folha não mostra dicas de formato para Telefone nem para Data de nascimento. Confira como o dado está gravado no cadastro dos seus clientes e use o mesmo padrão.
Sem escolher o Campo, o cartão mostra Campo não definido, com selo de pendência.
Nome técnico (para suporte): customer_update
Definir metadata do cliente (folha "Campo personalizado do cliente")
O que faz
Grava no cliente um campo livre, com um nome e um valor que você define. É útil para guardar uma informação que não existe no cadastro padrão. A frase da folha é "Grava um campo livre no cliente."
Como configurar
Campo (como aparece) | Obrigatório | O que escolher / opções / limites | Para que serve |
Nome do campo | Sim | Até 64 caracteres, só com letras sem acento, números, | O nome do campo livre. |
Valor | Sim | Texto livre, com o botão { } (Inserir variável), que inclui os atributos personalizados da loja. | O valor gravado nesse campo. |
Saídas
Uma só, sem nome no canvas. Sem Caminhos extras.
Exemplo de uso
Exemplo: Nome do campo = origem_campanha e Valor = black-friday, para você saber depois de qual ação o cliente veio.
Pegadinhas e limites
Nome e valor são obrigatórios. Sem eles, a folha avisa Informe o nome do campo. e Informe o valor do campo.
O nome do campo tem regra. Um nome com espaço, acento, outro símbolo ou variável (
{{…}}), ou com mais de 64 caracteres, mostra o aviso Use só letras sem acento, números, _, . e -, sem espaços, até 64 caracteres., e o fluxo não pode ser ativado. Por exemplo, "Data de Nascimento do Bebê" não passa;data_nascimento_bebepassa.Fluxo salvo antes dessa regra com um nome fora dela: o passo falha ao rodar e o dado não é gravado. Esse fluxo também não pode ser reativado, desarquivado nem ter as configurações salvas até você corrigir o nome e publicar de novo.
Nome técnico (para suporte): customer_metadata_set
Associar vendedor
O que faz
Associa o cliente a um vendedor da loja. A frase da folha é "Associa um vendedor ao cliente."
O fluxo espera a confirmação. O cliente só segue para o próximo passo depois que a Martz confirma o resultado da associação. Enquanto isso, ele fica parado neste passo. O resultado fica guardado para os passos seguintes (veja Saídas).
Em validação: esta ação está disponível, mas o vínculo ainda está em validação. Depois do primeiro uso, confira se o vendedor aparece associado ao cliente. Se não aparecer, ou se o cliente ficar parado neste passo nos detalhes da execução, fale com o suporte.
Como configurar
Campo (como aparece) | Obrigatório | O que escolher / opções / limites | Para que serve |
Vendedor | Sim | Escolha na lista de vendedores da sua loja (Selecionar vendedor). | O vendedor que será associado ao cliente. |
Substituir vendedor já associado | Não | Interruptor, desligado por padrão. | Define o que fazer se o cliente já tem outro vendedor. Ligado, o vendedor escolhido toma o lugar do atual. Desligado, o vendedor atual não é substituído. |
Saídas
Uma só, sem nome no canvas. Sem Caminhos extras. O cliente segue por ela depois da confirmação.
O resultado da associação fica na variável Resultado da associação de vendedor (grupo Variáveis do fluxo), que você pode usar numa Expressão avançada mais adiante, como vars.seller_assignment_outcome. Os valores possíveis são:
Valor | O que aconteceu |
| O cliente não tinha vendedor e passou a ter o escolhido. |
| O cliente tinha outro vendedor, e ele foi substituído (só com Substituir vendedor já associado ligado). |
| O cliente já era do vendedor escolhido. |
| O cliente tinha outro vendedor, e ele foi mantido (com Substituir vendedor já associado desligado). |
Exemplo de uso
Exemplo: cliente de alto valor entra no fluxo → Associar vendedor com a vendedora da carteira de clientes premium → Condição com a Expressão avançada vars.seller_assignment_outcome == "kept_existing". No Sim, o cliente já tinha outro vendedor e você avisa a equipe; no Não, segue o fluxo normal.
Pegadinhas e limites
Sem escolher o Vendedor, o cartão mostra Vendedor não definido, com selo de pendência, e a folha avisa Selecione o vendedor.
Deixe Substituir vendedor já associado desligado quando não quiser tirar clientes da carteira de outro vendedor. Com ele desligado, um cliente que já tem vendedor não faz a ação falhar: o vínculo atual é mantido e o fluxo segue normalmente.
Se a Martz não conseguir confirmar a associação, o passo termina em erro e o caminho acaba ali.
Nome técnico (para suporte): customer_seller_set
Criar anotação no cliente
O que faz
Adiciona uma anotação, com título e texto, ao cadastro do cliente. Serve para deixar registrado, para a equipe, algo que aconteceu no fluxo. No seletor e na folha o nome é o mesmo, com a frase "Adiciona uma anotação com título ao cadastro do cliente."
Como configurar
Campo (como aparece) | Obrigatório | O que escolher / opções / limites | Para que serve |
Título | Sim | Texto livre, com o botão { }, até 255 caracteres (o campo trava nesse limite, sem contador). Exemplo da tela: ex.: Pediu troca do produto. | O título da anotação. |
Anotação | Sim | Texto livre, com o botão { }, até 4.096 caracteres (com contador). | O texto da anotação. O ⓘ explica: "A anotação fica no cadastro do cliente, com o autor "Automação"." |
A folha Criar anotação no cliente, com os dois campos obrigatórios preenchidos. Sob cada um, a tela lembra o limite e que, se o texto passar dele depois das variáveis, o passo segue pelo Erro
Saídas
Uma só no canvas, sem nome. Sem Caminhos extras. Nos detalhes da execução, o passo aparece como Continuar ou Erro. Quando segue pelo Erro (texto acima do limite depois das variáveis), o cliente não segue adiante por esse caminho, e a execução mostra o motivo.
Onde a anotação aparece
No Atendimento, na barra lateral do cliente, seção Anotações (e em Ver todas): o cartão mostra a data, o autor Automação e o texto da anotação. O título não aparece nesse cartão.
No detalhe do cliente, a lista de anotações mostra o título.
Exemplo de uso
Exemplo: gatilho Pedido cancelado → Criar anotação no cliente com Título "Cancelou o pedido {{object.order.order_number}}" e Anotação "Pedido cancelado. Total: {{object.order.total_amount}}. Conferir o estorno." Quem atender o cliente depois já vê o histórico.
Pegadinhas e limites
Título e Anotação são obrigatórios. Sem eles, o cartão mostra Anotação não escrita, com selo de pendência, e a folha avisa Informe o título da anotação. e Escreva a anotação.
Os limites valem depois das variáveis. Os campos travam em 255 e 4.096 caracteres, mas uma variável pode deixar o texto maior. Se o título ou a anotação passar do limite, o passo segue pelo Erro, e a execução mostra "O texto ficou maior que o limite depois das variáveis; o passo seguiu pelo Erro."
Como o título não aparece no cartão do Atendimento, coloque no texto da Anotação o que a equipe precisa ler primeiro.
Nome técnico (para suporte): customer_note_create
Próximos passos
Gatilhos de tags e Gatilhos de grupos: o que acontece quando uma tag ou um grupo muda.
Condições: separe o público por tag ou grupo.



