Nó: Transferir para um agente

O nó Transferir para um agente (handoff) entrega a conversa a um humano: atribui ao agente ou equipe indicados, interrompe os demais workflows em execução naquela conversa e, opcionalmente, deixa uma nota visível no chat avisando sobre a transferência. É o nó padrão para fechar o ciclo "IA → humano" em qualquer fluxo de atendimento.

Quando usar

• No final de um fluxo de recepção, quando o cliente pede para falar com uma pessoa.
• Quando o agente de IA detecta que não consegue resolver a solicitação (escalonamento).
• Após um período de inatividade da IA sem resposta do cliente (handoff automático).

Configuração

• Atribuir a: Usuário, Equipe, Agente dentro de uma equipe ou Sem atribuição.
• Usuário / Equipe (conforme a opção anterior): o destino da atribuição. Aceita tanto um ID fixo quanto uma variável (ex.: $last_agent_id) para reatribuir ao último agente que atendeu.
• Lógica de seleção (apenas para "Agente dentro de uma equipe"): round_robin, menor carga ou manual, para escolher automaticamente um membro específico da equipe.
• Filtros (apenas para "Agente dentro de uma equipe"): "somente agentes online" e/ou "máximo de conversas abertas", para não atribuir a alguém sobrecarregado ou offline.
• Texto de aviso (opcional): mensagem publicada no chat avisando sobre a transferência (aceita variáveis).
• Interromper outros workflows (ativado por padrão): cancela qualquer outro workflow em execução na mesma conversa para que a IA não continue respondendo após a transferência.

Exemplo

Um workflow de IA detecta que o cliente escreveu "quero falar com uma pessoa". Adiciona-se Transferir para um agente com Atribuir a = Agente dentro de uma equipe, Equipe = Suporte, Lógica = round_robin, Filtro = somente agentes online, e Texto de aviso = Estamos te transferindo para um agente humano, um momento por favor. A conversa passa para o primeiro agente online disponível da equipe e a IA para de responder.

Dicas

• Deixar "Interromper outros workflows" ativado (recomendado) evita que a IA continue respondendo depois que um humano já assumiu a conversa.
• Use "Sem atribuição" quando quiser apenas tirar a conversa das mãos da IA sem decidir ainda quem vai atendê-la (por exemplo, para que fique na fila geral da equipe).

Solução de problemas

• Ninguém é atribuído: se você escolheu "Agente dentro de uma equipe" com filtros muito restritivos (ex.: somente online + máximo de conversas baixo), pode ser que nenhum agente se qualifique; a equipe mesmo assim fica atribuída como respaldo.
• A equipe não existe: se o ID de equipe configurado não existir mais no workspace, o nó retorna erro e nada é atribuído.