Condição: o contato tem etiqueta

Como usar a condição O contato tem etiqueta para direcionar o fluxo com os operadores any, all e none.

Jun 26, 2026

Veja este passo no vídeo · O contato tem a etiqueta

O que é e quando usar

A condição O contato tem etiqueta (contact_has_tag) verifica as etiquetas do contato e direciona o fluxo conforme as que ele tiver. É ideal para segmentar: por exemplo, dar um tratamento diferente a contatos vip, pular passos para quem já está cliente, ou filtrar quem tem nao-contatar. Você a encontra na seção Condições da paleta (ícone de etiqueta).

Requisitos

  • Ter etiquetas criadas no workspace, ou saber o nome exato de uma etiqueta criada dinamicamente.
  • Um workflow em que o contato esteja em contexto (a maioria dos gatilhos o traz).

Passos

  1. No editor de Automações, arraste o nó O contato tem etiqueta para o canvas.
  2. No inspetor, escolha o Operador, que define como as etiquetas selecionadas são avaliadas:
    • Tem ao menos uma (any): passa se o contato tiver uma ou mais das etiquetas.
    • Tem todas (all): passa só se tiver todas as etiquetas.
    • Não tem nenhuma (none): passa se não tiver nenhuma das etiquetas.
  3. Em Etiquetas, selecione uma ou várias etiquetas do workspace.
  4. Se a etiqueta for criada dinamicamente (por outro workflow), use o campo Ou tag por nome (legacy) e digite o nome exato, por exemplo vip. Se preencher ambos, as etiquetas selecionadas têm prioridade.
  5. Conecte as saídas Sim/Não aos nós seguintes.

Verificação

Teste com um contato que tenha a etiqueta e outro que não. Revise o histórico de execuções do workflow para ver por qual saída cada um passou. As etiquetas do contato aparecem na ficha dele em Contatos.

Se não funcionar

  • Todos saem por "Não": confirme que o contato realmente tem a etiqueta na ficha e que é a mesma que você selecionou. Se usar o nome legacy, atenção a maiúsculas e acentos: deve coincidir exatamente.
  • Uma etiqueta nova não é reconhecida: se a etiqueta é criada por um nó anterior no mesmo fluxo, use o campo Ou tag por nome com o nome exato, pois ela pode ainda não estar na lista do workspace.
  • O nó não aparece na paleta: verifique que você está no editor de workflows e na seção Condições.

Dicas

  • Para excluir contatos (lista negra) use o operador none com a etiqueta nao-contatar.
  • Combine esta condição com Adicionar etiqueta / Remover etiqueta para construir fluxos de ciclo de vida autogerenciados.

Artigos relacionados

Isso foi útil?

Artigos relacionados

Fale conosco no WhatsApp