Your AI Connector Docs

Utilizar etiquetas para identificar contactos

As etiquetas são rótulos reutilizáveis para contactos, conversas e campanhas — por exemplo, “Interessado”, “Reservado” ou “Não interessado”.

As etiquetas são especialmente poderosas quando combinadas com o seu Agente de IA — um agente (ou uma campanha clássica) pode etiquetar contactos automaticamente com base no desenrolar de uma conversa. As etiquetas também podem desencadear ações noutras ferramentas através de webhooks e mover contactos automaticamente pelo seu funil de vendas.

Porquê utilizar etiquetas?

  • Acompanhe os resultados das conversas — saiba num relance que contactos marcaram uma reunião, demonstraram interesse ou precisam de acompanhamento.
  • Veja as etiquetas num relance — as etiquetas aparecem como uma coluna na tabela de Contactos.
  • Filtre e segmente — encontre todos os contactos com uma etiqueta específica através de um filtro inteligente ou do painel de Filtros.
  • Automatize fluxos de trabalho — um webhook pode ser disparado sempre que uma etiqueta é aplicada, notificando as suas outras ferramentas.
  • Desencadeie ações de negócio — as etiquetas podem criar negócios ou mover negócios existentes através do seu funil. Veja Funil de Vendas.

Como abrir a página de Etiquetas

  1. Na barra lateral esquerda, clique em Definições (o ícone da engrenagem).
  2. Na barra lateral de Definições, sob o grupo Área de Trabalho, clique em Etiquetas.

Se não vir Etiquetas no grupo Área de Trabalho, o seu plano de subscrição não inclui a funcionalidade de etiquetagem. Clique em Faturação na mesma barra lateral para atualizar o seu plano.

Como criar uma etiqueta

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

A sua nova etiqueta aparece instantaneamente na lista abaixo e está pronta a usar — aplique-a a um contacto a partir de Conversas, através da ação em massa Etiquetar em Contactos ou Conversas, ou faça com que o seu Agente de IA a aplique automaticamente.

Se a criação falhar, poderá já existir uma etiqueta com esse nome exato na sua conta. Escolha um nome diferente ou mude o nome da existente — veja abaixo.

Mudar o nome de uma etiqueta

Ao contrário do que acontecia anteriormente, a alteração de nomes é agora suportada diretamente: encontre a etiqueta na lista, clique no ícone do lápis junto ao nome, edite o texto diretamente e clique no visto para guardar (ou no × para cancelar). Não é necessário recriar a etiqueta nem voltar a etiquetar manualmente cada contacto.

A lista de Etiquetas

As etiquetas são apresentadas numa lista, com cada linha a conter:

  • Uma caixa de verificação — para seleção em massa.
  • O nome da etiqueta, apresentado como um rótulo.
  • A contagem de contactos — quantos contactos têm atualmente esta etiqueta.
  • Um ícone de lápis — para mudar o nome diretamente.
  • Um ícone de lixo (vermelho) — para eliminar esta etiqueta.

Uma caixa de pesquisa acima da lista permite filtrar por nome — útil quando tiver mais do que algumas etiquetas. O cabeçalho mostra o número total de etiquetas e quantos contactos estão etiquetados no total.

É bom saber: a página de Etiquetas não tem um botão Gerar Resumo por etiqueta (a definição que fazia com que a IA escrevesse automaticamente um resumo da conversação sempre que uma etiqueta era aplicada). As etiquetas que cria ou renomeia aqui não têm um resumo de IA configurado desta forma; se depende dessa funcionalidade para etiquetas configuradas anteriormente, a sua definição permanece inalterada, mas atualmente não existe nenhum controlo nesta página para a ativar ou desativar.

Eliminar uma única etiqueta

  1. Clique no ícone do caixote do lixo na linha da etiqueta.
  2. Confirme na janela pop-up — esta indica-lhe quantos contactos têm atualmente essa etiqueta. Esta ação não pode ser desfeita.

Eliminar várias etiquetas de uma só vez

  1. Selecione as caixas de verificação das etiquetas que pretende remover.
  2. Aparecerá uma barra flutuante na parte inferior do ecrã a mostrar o número da sua seleção.
  3. Clique em Eliminar nessa barra e confirme.

A eliminação de uma etiqueta não é reversível. Se um Agente de IA ou uma campanha ainda tiver uma regra de Etiquetas a utilizar esse nome exato, será criada uma nova etiqueta da próxima vez que for aplicada — mas perderá o histórico da etiqueta eliminada e quaisquer ligações ao funil de vendas associadas a ela serão quebradas. Reveja os seus agentes, campanhas e automatizações de vendas posteriormente.

Aplicar etiquetas a um contacto

Para além de permitir que o seu Agente de IA etiquete contactos automaticamente (ver abaixo), pode aplicar ou remover etiquetas manualmente em alguns locais:

  • A partir de uma conversa — abra a conversa do contacto em Chats. O Painel de Contacto, à direita, tem uma secção Etiquetas que mostra as etiquetas atuais com uma ligação Gerir, ou abra o menu ⋯ na conversa e escolha Gerir etiquetas….
  • Em massa — selecione vários contactos (em Contactos) ou conversas (em Chats) e utilize a ação em massa Etiquetar.
  • Deixe a IA decidir, à posteriori — Etiquetar automaticamente com IA executa as regras de etiquetas de um agente sobre toda uma conversa, a pedido. Consulte Etiquetar uma conversa a pedido.
  • Automaticamente — peça ao seu Agente de IA ou campanha para aplicar a etiqueta enquanto conversa (veja abaixo).

Qualquer um dos caminhos abre a mesma caixa de diálogo Atribuir etiquetas: pesquise ou percorra a lista, selecione as etiquetas que pretende aplicar, opcionalmente clique em Criar nova etiqueta sem sair da caixa de diálogo e, em seguida, clique em Aplicar etiquetas.

Permitir que o seu Agente de IA etiquete contactos automaticamente

É isto que torna as etiquetas poderosas: em vez de etiquetar contactos manualmente, diga à IA o que deve procurar e ela aplicará a etiqueta durante a conversa. Isto é configurado por Agente de IA (ou por campanha clássica, se ainda não tiver migrado para Agentes) no passo Etiquetas — e não na página de definições de Etiquetas acima, que apenas gere a biblioteca de etiquetas reutilizáveis.

  1. Abra o seu editor de Agente de IA (ou campanha) e aceda ao passo Etiquetas.
  2. Clique em Adicionar etiqueta e escolha uma etiqueta existente da sua biblioteca ou escreva um novo nome.
  3. Em Quando aplicar, descreva a situação que deve acioná-la — por exemplo, “O contacto diz que quer marcar uma chamada ou pergunta sobre preços.”
  4. Opcionalmente, adicione um URL de Webhook — o Your AI Connector envia o contacto e a etiqueta via POST para esse URL no momento em que a etiqueta é aplicada. Guarde a etiqueta primeiro e, em seguida, utilize Testar ao lado do campo para enviar um payload de exemplo imediatamente e verificar se a sua automatização o recebe.
  5. Deixe a opção Permitir que a IA remova esta etiqueta desativada, a menos que pretenda que a IA possa remover a etiqueta de um contacto mais tarde. Veja Como a IA decide abaixo.
  6. Clique em Guardar alterações.

Deixe a IA escrever as regras de etiquetas por si

No passo Etiquetas de um Agente de IA, existe também um botão Gerar com IA. Este lê as instruções e o contexto empresarial do agente e propõe um conjunto de etiquetas — normalmente entre três a oito — cada uma com uma regra de “Quando aplicar” já escrita, no idioma do agente. Antes de inventar um novo nome, o sistema pesquisa na sua biblioteca de etiquetas e reutiliza uma etiqueta existente quando esta significa o mesmo, para que as etiquetas adicionadas estejam alinhadas com aquelas que a sua equipa já utiliza para filtrar e automatizar. Escolha Adicionar às minhas etiquetas (mantém as suas etiquetas atuais, apenas adiciona novas) ou Substituir todas as etiquetas e, em seguida, reveja e edite as linhas como qualquer outra etiqueta. Uma execução custa 1 crédito (0,25 no nível Max, ou nada quando o agente é executado com a sua própria chave de IA). Os agentes criados a partir de um site ou documentos, seja no assistente de configuração ou com Novo agente, têm as suas etiquetas geradas automaticamente, pelo que encontrará frequentemente esta lista já preenchida. As etiquetas geradas são adicionadas à sua biblioteca de etiquetas na primeira vez que a IA aplica uma a um contacto, e não antes — elimine uma linha proposta e esta nunca aparecerá em lado nenhum.

Etiquetas de agente vs. etiquetas de campanha: se ainda estiver a utilizar uma campanha clássica, o seu passo Etiquetas funciona de forma idêntica. A transição para um Agente transfere as suas regras de etiquetas — consulte Agentes de IA.

Como a IA decide — adicionar e remover

Após cada resposta da IA, esta volta a ler a conversa recente em relação às suas regras de etiquetas e atualiza as etiquetas do contacto. Algumas coisas que vale a pena saber sobre como a IA decide:

  • Apenas adiciona uma etiqueta quando a conversa corresponde claramente à sua regra. “Provavelmente” não é suficiente — se não tiver a certeza, não aplica a etiqueta.
  • Também pode remover uma etiqueta — mas apenas se o permitir. Cada etiqueta tem um interruptor Permitir que a IA remova esta etiqueta, desativado por predefinição. Ative-o para etiquetas cuja regra descreve quando a etiqueta deve ser removida — por exemplo, “Aplicar enquanto o pagamento estiver em atraso; remover assim que o contacto tiver pago” — e a IA remove a etiqueta no momento em que a conversa mostra que essa condição foi cumprida. Com o interruptor desativado, a etiqueta é apenas de aplicação: a IA pode aplicá-la, mas nunca a removerá. A remoção de uma etiqueta é gratuita (nunca utiliza créditos).
  • Sabe que etiquetas o contacto já possui e qual é a data de hoje, pelo que regras como “em atraso a partir de hoje” ou “paga no dia 5 de cada mês” funcionam conforme escritas.
  • Conjuntos únicos mantêm-se organizados. Se utilizar um conjunto de etiquetas em que um contacto só deve ter uma (como uma etiqueta de dia do mês para datas de vencimento de pagamentos), a IA substitui a antiga quando a correta muda, em vez de deixar que duas se acumulem — ative o interruptor de remoção para todas as etiquetas do conjunto, caso contrário, a antiga permanecerá.
  • Nunca toca em etiquetas fora da lista de etiquetas do agente. As etiquetas que 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 “Quando aplicar” é também onde descreve quando a etiqueta deve ser removida. Uma regra como “Adicionar quando o contacto perguntar sobre preços; remover depois de terem efetuado a compra” fornece à IA ambas as partes. No entanto, a regra por si só não é suficiente: o interruptor Permitir que a IA remova esta etiqueta também tem de estar ativado.

Por que a remoção está desativada por predefinição (alterado a 12 de agosto de 2026). “Quando aplicar” descreve quando uma etiqueta começa a ser verdadeira, e a IA por vezes interpretava o oposto — removendo uma etiqueta que simplesmente tinha deixado de ser o tópico de conversa. Como um webhook de etiqueta costumava ser disparado também na remoção, isso poderia reexecutar uma automatização para um contacto que já tinha ultrapassado esse passo. Os webhooks de etiquetas disparam agora apenas na aplicação, e a remoção é algo que ativa por etiqueta. As etiquetas existentes mantêm todas as que já possuem; se dependia da IA para remover uma, ative o interruptor para a mesma.

Etiquetar uma conversa a pedido

A etiquetagem em tempo real só acontece quando a própria IA responde. As conversas que a sua equipa gere com a IA em pausa, as conversas importadas do seu histórico do WhatsApp e tudo o que aconteceu antes de ter escrito as regras de etiquetas do agente nunca são analisadas — tal como as suas conversas existentes quando adiciona uma nova regra ou clica em Gerar com IA. Etiquetar automaticamente com IA cobre todos esses casos: um clique executa as regras de etiquetas do agente sobre a conversa inteira, não apenas sobre as últimas mensagens, e adiciona ou remove etiquetas exatamente da mesma forma que a etiquetagem em tempo real faria.

Três locais para iniciar:

  • Uma conversa — abra a conversa, clique no menu de três pontos (⋯) no cabeçalho e escolha Etiquetar automaticamente com IA. Confirme e, pouco depois, uma mensagem dir-lhe-á que etiquetas foram adicionadas ou removidas.
  • Vários contactos — em Contactos, selecione os contactos e clique em Etiquetar automaticamente na barra de ações flutuante. Por predefinição, cada contacto é avaliado pelas regras do seu próprio agente de IA; escolha um agente em Usar as etiquetas deste agente para todos para aplicar as regras de um agente a todos os selecionados. A janela mostra o progresso enquanto é executada e um resumo quando termina — pode fechá-la, a execução continua.
  • Tudo o que um agente gere — no separador Etiquetas do agente, clique em Aplicar a conversas existentes. Executa as regras sobre até 500 das conversas mais recentes desse agente.

O que esperar:

  • Mesmas regras, mesmas decisões. Segue as regras “Quando aplicar” e os interruptores Deixar a IA remover esta etiqueta exatamente como a etiquetagem em tempo real: nunca adiciona uma etiqueta fora da lista do agente e nunca remove uma que não tenha permitido.
  • Mesmo preço. 1 crédito por etiqueta aplicada (0,25 no plano Max, gratuito quando o agente é executado com a sua própria chave de IA). Ler a conversa é gratuito, por isso um contacto que não receba novas etiquetas não custa nada, e as remoções nunca custam nada. É exatamente o que a etiquetagem em tempo real cobra, pelo que não existe forma mais barata de obter as mesmas etiquetas desligando a etiquetagem em tempo real.
  • Até 500 contactos por execução, uma execução de cada vez. Os contactos sem mensagens, sem agente de IA ou com um agente sem regras de etiquetas são ignorados e contados no resumo. Se os seus créditos terminarem a meio da execução, esta para aí e mantém tudo o que foi etiquetado até ao momento.

Próximos Passos