Gatilho: Etiqueta adicionada

O gatilho Etiqueta adicionada (tag.added) inicia um workflow quando uma etiqueta é adicionada a um contato, seja manualmente pela caixa de entrada, por outro workflow ou pelo Agente de IA. É a base das segmentações automáticas: toda vez que um contato entra numa categoria (VIP, inadimplente, interessado no produto X), você pode disparar ações específicas.

Quando dispara

Dispara assim que a etiqueta é salva no contato, independente da origem (atendente, API, workflow ou IA).

Requisitos

• Pelo menos uma etiqueta criada no workspace (Configurações > Etiquetas, ou criada na hora pela caixa de entrada).

Configuração do gatilho

• Nome da etiqueta: deixe em branco para disparar com qualquer etiqueta, ou especifique uma exata (por exemplo "VIP") para restringir o workflow a esse caso.
• Este gatilho suporta a opção "executar apenas uma vez por contato", útil para evitar reenviar a mesma boas-vindas se a etiqueta for removida e adicionada de novo.

Variáveis disponíveis

• $tag.id, $tag.name, $tag.added_at
• Variáveis padrão $contact.*

Exemplo

Um workflow disparado por tag.added com Nome da etiqueta = "VIP": assim que um atendente etiqueta um contato como VIP, o workflow reatribui a conversa à equipe de Contas-Chave e envia uma mensagem de boas-vindas personalizada usando $contact.first_name.

Dicas

• Combine com tag.removed para montar o fluxo inverso (por exemplo, tirar alguém de uma lista de remarketing quando deixa de estar "interessado").
• Use o nome exato da etiqueta como aparece em Configurações > Etiquetas — a comparação nem sempre ignora maiúsculas/minúsculas, então teste antes.

Solução de problemas

Se o workflow não disparar, verifique se a etiqueta foi realmente adicionada ao contato (e não só à conversa) e se o nome configurado no filtro bate exatamente com a etiqueta real.