Nó de IVR: Buscar conversa

Para que serve

Colocado logo após um nó Buscar contato, verifica se o número que está ligando já tem uma conversa recente na sua caixa de entrada e, se encontrar, mostra quem atendeu — agente atribuído, equipe, status — para que o fluxo do IVR possa reconectar a pessoa com o mesmo agente em vez de mandá-la para um menu genérico.

Requisitos

• Precisa rodar depois de um nó Buscar contato — se nenhum contato foi resolvido, este nó avança direto pela saída not_found.
• O canal de chamadas precisa ter conversas já registradas no Inbox (WhatsApp Calling, Telnyx, etc.).

Configuração

• Filtrar por equipe: restringe a busca a conversas de uma equipe específica (ou "Qualquer equipe").
• Status a considerar: caixas de seleção para Aberta, Adiada, Fechada, Resolvida.
• Idade máxima (horas, 0 = sem limite): descarta conversas mais antigas que N horas (padrão 720h = 30 dias).

Saídas (edges)

• found_assigned: existe conversa e ela tem agente atribuído.
• found_unassigned: existe conversa mas está sem atribuição (só na fila).
• not_found: nenhuma conversa correspondente.

Variáveis que define

${last_conversation_id}, ${last_agent_id} (somente em found_assigned), ${last_team_id}, ${last_status}, ${last_agent_online} (true se o agente está online agora), ${last_agent_team_match} (true se o agente pertence à equipe do filtro).

Exemplo

Um cliente que falou ontem com a "Ana" da equipe Suporte liga de novo. Com Filtrar por equipe = Suporte e Status = Aberta + Adiada, o nó encontra a conversa, bifurca em found_assigned e guarda ${last_agent_id} e ${last_agent_online}. Um nó Rotear para usuário mais adiante transfere direto para a Ana se ela estiver online, ou para a fila de Suporte se não estiver.

Dicas

• Combine found_assigned + ${last_agent_online}=true com Rotear para usuário para dar continuidade sem expor o número do agente.
• Se ${last_agent_team_match} vier false, o agente mudou de equipe — melhor rotear para a fila geral.

Solução de problemas

• Se sempre cair em not_found, confira se o Buscar contato roda antes e se o contato existe no workspace certo.
• A presença do agente expira a cada 60 segundos — pode levar alguns segundos para atualizar.