Your AI Connector Docs

Usando tags para rotular contatos

Tags são etiquetas reutilizáveis para contatos, chats e campanhas — por exemplo, “Interessado”, “Agendado” ou “Não interessado”.

Tags são especialmente poderosas quando combinadas com seu Agente de IA — um agente (ou uma campanha clássica) pode marcar contatos automaticamente com base no desenrolar de uma conversa. As tags também podem acionar ações em outras ferramentas por meio de webhooks e mover contatos pelo seu funil de vendas automaticamente.

Por que usar tags?

  • Rastreie resultados de conversas — saiba rapidamente quais contatos agendaram uma reunião, demonstraram interesse ou precisam de acompanhamento.
  • Veja as tags rapidamente — as tags aparecem como uma coluna na tabela de Contatos.
  • Filtre e segmente — encontre todos os contatos com uma tag específica usando um filtro inteligente ou o painel de Filtros.
  • Automatize fluxos de trabalho — um webhook pode ser disparado sempre que uma tag for aplicada, notificando suas outras ferramentas.
  • Acione ações de negócio — as tags podem criar negócios ou mover negócios existentes pelo seu funil. Veja Funil de Vendas.

Como abrir a página de Tags

  1. Na barra lateral esquerda, clique em Configurações (o ícone de engrenagem).
  2. Na barra lateral de Configurações, sob o grupo Espaço de trabalho, clique em Tags.

Se você não vir Tags no grupo Espaço de trabalho, seu plano de assinatura não inclui o uso de tags. Clique em Faturamento na mesma barra lateral para fazer um upgrade.

Como criar uma tag

  1. Abra a página Tags (passos acima).
  2. Em Nova tag, digite um nome (por exemplo, VIP, Spanish ou Trial). Mantenha-o curto — no máximo algumas palavras.
  3. Clique em Adicionar tag.

Sua nova tag aparece instantaneamente na lista abaixo e está pronta para uso — aplique-a a um contato a partir de Chats, da ação em massa Tag em Contatos ou Chats, ou faça com que seu Agente de IA a aplique automaticamente.

Se a criação falhar, uma tag com esse nome exato pode já existir em sua conta. Escolha um nome diferente ou renomeie a existente — veja abaixo.

Renomeando uma Tag

Diferente de antes, agora o renomeio é suportado diretamente: encontre a tag na lista, clique no ícone de lápis ao lado do nome, edite o texto na linha e clique no ícone de verificação para salvar (ou no × para cancelar). Não é necessário recriar a tag ou marcar manualmente cada contato novamente.

A Lista de Tags

As tags são exibidas como uma lista, cada linha com:

  • Uma caixa de seleção — para seleção em massa.
  • O nome da tag, exibido como um rótulo.
  • A contagem de contatos — quantos contatos possuem esta tag atualmente.
  • Um ícone de lápis — para renomear na linha.
  • Um ícone de lixeira (vermelho) — para excluir esta tag.

Uma caixa de pesquisa acima da lista filtra por nome — útil quando você tiver mais do que algumas poucas tags. O cabeçalho mostra sua contagem total de tags e quantos contatos estão marcados no total.

Bom saber: a página de Tags não possui um botão Gerar Resumo por tag (a configuração que fazia a IA escrever um resumo da conversa automaticamente sempre que uma tag era aplicada). As tags que você cria ou renomeia aqui não têm um resumo de IA configurado dessa forma; se você depende desse recurso para tags configuradas anteriormente, a configuração delas permanece inalterada, mas atualmente não há controle nesta página para ativá-lo ou desativá-lo.

Excluindo uma única tag

  1. Clique no ícone de lixeira na linha da tag.
  2. Confirme no pop-up — ele informa quantos contatos possuem a tag atualmente. Isso não pode ser desfeito.

Excluindo várias tags de uma vez

  1. Marque as caixas de seleção das tags que deseja remover.
  2. Uma barra flutuante aparecerá na parte inferior da tela mostrando a contagem da sua seleção.
  3. Clique em Excluir nessa barra e confirme.

A exclusão de uma tag não é reversível. Se um Agente de IA ou campanha ainda tiver uma regra de Tags usando exatamente esse nome, ele criará uma nova tag na próxima vez que a aplicar — mas você perderá o histórico da tag excluída e quaisquer links do funil de vendas vinculados a ela serão quebrados. Revise seus agentes, campanhas e automações de funil posteriormente.

Aplicando Tags a um Contato

Além de permitir que seu Agente de IA marque contatos automaticamente (veja abaixo), você mesmo pode aplicar ou remover tags em alguns lugares:

  • De um chat — abra a conversa do contato em Chats. O Painel de Contato à direita tem uma seção Tags mostrando as tags atuais com um link Gerenciar, ou abra o menu ⋯ na conversa e escolha Gerenciar tags….
  • Em massa — selecione vários contatos (em Contatos) ou chats (em Chats) e use a ação em massa Tag.
  • Deixe a IA decidir, depois do fato — Auto-tag com IA executa as regras de tag de um agente em toda uma conversa sob demanda. Veja Adicionando tags a uma conversa sob demanda.
  • Automaticamente — faça com que seu Agente de IA ou campanha aplique a tag enquanto conversa (veja abaixo).

Qualquer um dos caminhos abre a mesma caixa de diálogo Atribuir tags: pesquise ou role a lista, marque as tags que devem ser aplicadas, opcionalmente clique em Criar nova tag sem sair da caixa de diálogo e, em seguida, clique em Aplicar tags.

Permitindo que seu Agente de IA marque contatos automaticamente

É isso que torna as tags poderosas: em vez de marcar os contatos você mesmo, diga à IA o que observar e ela aplicará a tag durante a conversa. Isso é configurado por Agente de IA (ou por campanha clássica, se você ainda não migrou para Agentes) na etapa Tags — não na página de configurações de Tags acima, que apenas gerencia a biblioteca de tags reutilizáveis.

  1. Abra o seu editor de Agente de IA (ou campanha) e vá para a etapa Tags.
  2. Clique em Adicionar tag e escolha uma tag existente da sua biblioteca ou digite um novo nome.
  3. Em Quando aplicar, descreva a situação que deve acioná-la — por exemplo, “O contato diz que quer agendar uma chamada ou pergunta sobre preços.”
  4. Opcionalmente, adicione uma URL de Webhook — o Your AI Connector enviará via POST o contato e a tag para essa URL no momento em que a tag for aplicada. Salve a tag primeiro e, em seguida, use Testar ao lado do campo para enviar um payload de exemplo imediatamente e verificar se a sua automação o recebe.
  5. Deixe a opção Permitir que a IA remova esta tag desativada, a menos que você queira que a IA possa remover a tag de um contato posteriormente. Veja Como a IA decide abaixo.
  6. Clique em Salvar alterações.

Deixe a IA escrever as regras de tags para você

Na etapa Tags de um Agente de IA, também há um botão Gerar com IA. Ele lê as instruções e o contexto de negócios do agente e propõe um conjunto de tags — geralmente de três a oito — cada uma com uma regra de “Quando aplicar” já escrita, no idioma do agente. Antes de inventar um novo nome, ele verifica sua biblioteca de tags e reutiliza uma tag existente quando ela significa a mesma coisa, para que as tags adicionadas estejam alinhadas com aquelas que sua equipe já usa para filtrar e automatizar. Escolha Adicionar às minhas tags (mantém suas tags atuais, apenas adiciona novas) ou Substituir todas as tags e, em seguida, revise e edite as linhas como qualquer outra tag. Uma execução custa 1 crédito (0,25 no plano Max, ou nada quando o agente é executado com sua própria chave de IA). Agentes criados a partir de um site ou documentos, seja no assistente de configuração ou com Novo agente, têm suas tags geradas automaticamente, então você frequentemente encontrará esta lista já preenchida. As tags geradas são adicionadas à sua biblioteca de tags na primeira vez que a IA aplica uma a um contato, e não antes — exclua uma linha proposta e ela nunca aparecerá em lugar nenhum.

Tags de agente vs. tags de campanha: se você ainda estiver em uma campanha clássica, a etapa Tags funciona de forma idêntica. Migrar para um Agente transfere suas regras de tag — veja Agentes de IA.

Como a IA decide — adicionar e remover

Após cada resposta da IA, ela relê a conversa recente em relação às suas regras de tags e atualiza as tags do contato. Algumas coisas que vale a pena saber sobre como ela decide:

  • Ela só adiciona uma tag quando a conversa corresponde claramente à sua regra. “Provavelmente” não é suficiente — se a IA não tiver certeza, ela não aplica a tag.
  • Ela também pode remover uma tag — mas apenas se você permitir. Cada tag possui um botão Permitir que a IA remova esta tag, desativado por padrão. Ative-o para tags cuja regra descreve quando a tag deve ser removida — por exemplo, “Aplicar enquanto o pagamento estiver atrasado; remover assim que o contato pagar” — e a IA removerá a tag no momento em que a conversa mostrar que essa condição foi atendida. Com o botão desativado, a tag é apenas de aplicação: a IA pode adicioná-la, mas nunca a removerá. Remover uma tag é gratuito (nunca consome créditos).
  • Ela sabe quais tags o contato já possui e qual é a data de hoje, portanto, regras como “atrasado a partir de hoje” ou “paga no dia 5 de cada mês” funcionam conforme escritas.
  • Conjuntos exclusivos permanecem organizados. Se você usar um conjunto de tags onde um contato deve ter apenas uma (como uma tag de dia do mês para datas de vencimento de pagamento), a IA substitui a antiga pela correta em vez de deixar que duas se acumulem — ative o botão de remoção para cada tag no conjunto, caso contrário, a antiga permanecerá.
  • Ela nunca toca em tags fora da lista de tags do agente. Tags que você aplica manualmente e que não fazem parte das regras do agente não são alteradas.

Dica — escreva a remoção na regra. O texto em “Quando aplicar” também é onde você descreve quando a tag deve ser removida. Uma regra como “Adicionar quando o contato perguntar sobre preços; remover após a compra” fornece à IA ambas as partes. A regra sozinha não é suficiente, no entanto: o botão Permitir que a IA remova esta tag também precisa estar ativado.

Por que a remoção está desativada por padrão (alterado em 12 de agosto de 2026). “Quando aplicar” descreve quando uma tag começa a ser verdadeira, e a IA às vezes interpretava o oposto — removendo uma tag que simplesmente tinha deixado de ser o tópico da conversa. Como um webhook de tag costumava ser disparado também na remoção, isso poderia reexecutar uma automação para um contato que já tinha passado dessa etapa. Os webhooks de tag agora são disparados apenas na aplicação, e a remoção é algo que você ativa por tag. As tags existentes mantêm todas as tags que já possuem; se você dependia da IA para remover uma, ative o botão para ela.

Adicionando tags a uma conversa sob demanda

A marcação de tags em tempo real só acontece quando a própria IA responde. Conversas que sua equipe gerencia com a IA pausada, chats importados do seu histórico do WhatsApp e qualquer coisa que tenha acontecido antes de você escrever as regras de tag do agente nunca são analisadas — e o mesmo vale para suas conversas existentes quando você adiciona uma nova regra ou clica em Generate with AI. O Auto-tag com IA cobre tudo isso: um clique executa as regras de tag do agente em toda a conversa, não apenas nas últimas mensagens, e adiciona ou remove tags exatamente da mesma forma que a marcação em tempo real faria.

Três lugares para iniciar:

  • Um chat — abra a conversa, clique no menu de três pontos (⋯) no cabeçalho e escolha Auto-tag com IA. Confirme e, um momento depois, uma mensagem informará quais tags foram adicionadas ou removidas.
  • Vários contatos — em Contatos, marque os contatos e clique em Auto-tag na barra de ação flutuante. Por padrão, cada contato é avaliado pelas regras do seu próprio agente de IA; escolha um agente em Use this agent’s tags for all para aplicar as regras de um agente a todos os selecionados. A janela mostra o progresso enquanto é executada e um resumo quando termina — você pode fechá-la, a execução continuará.
  • Tudo o que um agente gerencia — na aba Tags do agente, clique em Apply to existing conversations. Isso executa as regras em até 500 das conversas mais recentes desse agente.

O que esperar:

  • Mesmas regras, mesmas decisões. Ele segue as regras de “Quando Aplicar” e as chaves Let the AI remove this tag exatamente como a marcação em tempo real: ele nunca adiciona uma tag fora da lista do agente e nunca remove uma que você não permitiu.
  • Mesmo preço. 1 crédito por tag aplicada (0,25 no plano Max, gratuito quando o agente é executado com sua própria chave de IA). Ler a conversa é gratuito, então um contato que não recebe novas tags não custa nada, e as remoções nunca custam nada. Isso é exatamente o que a marcação em tempo real cobra, portanto, não há maneira mais barata de obter as mesmas tags desativando a marcação em tempo real.
  • Até 500 contatos por execução, uma execução por vez. Contatos sem mensagens ainda, sem agente de IA ou com um agente sem regras de tag são ignorados e contados no resumo. Se seus créditos acabarem no meio da execução, ela para ali e mantém tudo o que foi marcado até o momento.

Próximos passos