Nó de IVR: Buscar contato

O nó Buscar contato (tipo ContactLookup) procura na sua base de contatos do workspace a pessoa que está ligando, usando o número de telefone do chamador. Se encontrar, salva as informações em variáveis que você pode usar nos nós seguintes (Condição, Bifurcar, mensagens personalizadas). Não exige nenhuma configuração: basta colocá-lo no fluxo onde quiser fazer a busca.

Como funciona

O nó normaliza o número do chamador para o formato E.164 e também testa variantes (com e sem +, somente dígitos) para maximizar a correspondência com o que estiver salvo no campo telefone do contato, dentro do mesmo workspace do canal.

Saídas

• found: um contato correspondente foi encontrado. Ficam disponíveis as variáveis contact.id, contact.name, contact.email, contact.tags (lista de etiquetas) e contact.is_new = false.
• not_found: nenhum contato correspondeu a esse número. contact.is_new é definido como true.

Exemplo

Você coloca o Buscar contato logo após a saudação inicial. Conecta a saída found a uma Condição com a expressão contact.tags includes 'vip' para priorizar clientes marcados como VIP; conecta not_found direto ao menu principal, já que provavelmente é um chamador novo que precisa se cadastrar primeiro.

Dicas

• Coloque-o cedo no fluxo, antes de qualquer nó que use contact.* na sua configuração (Condição, mensagens personalizadas, etc.) — se ele ainda não rodou, essas variáveis estarão vazias.
• O campo telefone do contato precisa estar preenchido para que esse nó o encontre; se seus contatos forem criados sem telefone (por exemplo, só via WhatsApp com outro identificador), a busca vai falhar sistematicamente.
• Combine com o nó Buscar conversação (se disponível no seu plano) para também direcionar ao mesmo agente/equipe que atendeu esse cliente da última vez.

Solução de problemas

Se um contato que você sabe que existe sempre cai em not_found, verifique se o número salvo no cadastro dele está num formato reconhecível (com ou sem +, com código de país) — o nó testa várias variantes, mas não consegue adivinhar um número salvo de forma muito diferente de como o cliente está ligando.