Condição: o agente pertence a uma equipe

Use o nó O agente pertence a equipe para ramificar seus workflows conforme a equipe do agente atribuído à conversa.

Jun 26, 2026

Veja este passo no vídeo · Detectar idioma e agente na equipe

O que é e quando usar

O nó O agente pertence a equipe é uma condição (roteador) que verifica se um agente faz parte de uma equipe e direciona o fluxo pela saída Sim ou Não. É a peça-chave para roteamentos avançados: aplicar SLAs diferentes por equipe, notificar o líder certo, escalar para fora da equipe de vendas ou marcar conversas por área.

Por padrão avalia o agente atribuído à conversa, mas também pode verificar um usuário específico. A verificação pode ser pertence a qualquer equipe ou pertence a uma equipe específica.

Requisitos

  • Ter pelo menos uma equipe criada no workspace (menu Configurações → Equipes) com membros.
  • Um workflow onde a conversa já tenha (ou possa ter) um agente atribuído, para o nó ter quem avaliar.

Passos para configurar

  1. Abra Automações e entre no editor do seu workflow.
  2. Arraste o nó O agente pertence a equipe da paleta (categoria Condição).
  3. Em Configurar, escolha o Agente a avaliar:
    • Atribuído à conversa (recomendado): usa o agente atual.
    • Usuário específico: informe um usuário por ID ou por uma $variable.
  4. Escolha o Modo de equipe:
    • Qualquer equipe: segue por Sim se o agente estiver em pelo menos uma equipe.
    • Equipe específica: selecione a equipe a verificar.
  5. Conecte as saídas Sim e Não aos próximos nós conforme sua lógica.
  6. Salve e ative o workflow.

Variáveis que expõe

Após avaliar, o nó disponibiliza estas variáveis para os nós seguintes:

  • $agent_in_team (booleano)
  • $agent_id (o usuário avaliado)
  • $agent_team_ids e $agent_team_names
  • $agent_team_count
  • $matched_team_name e $agent_team_role (member ou lead)
  • $agent_team_members (nomes dos colegas)

Use-as, por exemplo, para compor uma mensagem como: "Seu caso foi encaminhado à equipe $matched_team_name."

Verificação

Ative o workflow e dispare-o em uma conversa com um agente que você saiba que pertence (ou não) à equipe. Veja o histórico de execução: você verá o ramo seguido e o valor de $agent_in_team. Teste também com um agente sem equipe para confirmar a saída Não.

Se não funcionar

  • Segue sempre por Não: provavelmente a conversa ainda não tem agente atribuído. Coloque o nó depois de uma atribuição, ou use o modo Usuário específico.
  • A equipe certa não coincide: em Equipe específica, confirme que selecionou a equipe do workspace ativo; um agente pode estar em várias equipes, mas só este workspace conta.
  • Não aparecem membros: confirme que a equipe tem membros em Configurações → Equipes.

Dicas

  • Combine este nó com Detectar idioma ou Horário comercial para roteamentos realmente finos (idioma + área + disponibilidade).
  • Como o nó é isolado por workspace, é seguro reutilizar a mesma equipe em vários workflows sem misturar dados entre workspaces.

Artigos relacionados

Isso foi útil?

Artigos relacionados

Fale conosco no WhatsApp