Passar para o conteúdo principal

Ações de cliente: tags, grupos, cadastro, metadata, vendedor e anotação

Veja como configurar as 8 ações de cliente do fluxo: tags, grupos, atualização de cadastro, metadata, vendedor e anotação, com campos, saídas, exemplos e limites.

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, _, . e -, sem espaços. A folha mostra o exemplo origem_lead.

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_bebe passa.

  • 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

assigned

O cliente não tinha vendedor e passou a ter o escolhido.

replaced

O cliente tinha outro vendedor, e ele foi substituído (só com Substituir vendedor já associado ligado).

already_assigned

O cliente já era do vendedor escolhido.

kept_existing

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

Respondeu à sua pergunta?