# Agilize Docs para IA - Página atual

Este arquivo contém uma versão focada e legível por IA da página aberta na documentação pública da Agilize.
Use esta versão quando a pergunta do usuário estiver restrita ao documento atual.

Última geração: 2026-09-15T03:39:11.378Z

## Página

- Título: Verificar Vínculo com Entidade
- URL humana: https://agilize.app/docs/configuracao/referencias/nodes-fluxos-do-bot/verificar-vinculo-com-entidade
- Leitura completa para IA: https://agilize.app/docs/llms.txt
- Descrição: Verifica se a conversa possui vínculo com uma oportunidade, contato ou empresa.

## Seções

- Quando usar
- Campos de configuração
- Entradas e saídas
- Exemplo prático
- Onde configurar
- Como a verificação funciona
- Exemplo de decisão antes de criar uma oportunidade
- Boas práticas e riscos comuns

## Conteúdo da página

# Verificar Vínculo com Entidade

Verifica se a conversa possui vínculo com uma oportunidade, contato ou empresa. Este node deve ser usado dentro de fluxos do bot, sempre conectado a uma jornada com objetivo claro, rota esperada e tratamento para exceções.

## Quando usar

- Use antes de criar uma oportunidade, contato ou empresa quando o fluxo precisa saber se a conversa já possui esse vínculo.
- Use para separar uma jornada que aproveita o registro associado de outra que precisa gerar ou solicitar a associação.

## Campos de configuração

- **Entidade**: oportunidade, contato ou empresa.

## Entradas e saídas

- Entradas: recebe 1 entrada.
- Saídas: possui 2 saídas.
- Possui vínculo: a sala atual tem uma entidade do tipo selecionado associada.
- Não possui vínculo: a sala atual não tem uma entidade do tipo selecionado associada.

## Exemplo prático

Antes de gerar uma oportunidade, verifique se a conversa já possui uma. Se possuir, continue pelo caminho que usa o registro atual; se não possuir, gere a oportunidade e siga a jornada comercial.

## Onde configurar

Acesse :ScreenEntry{href="https://my.agilize.app/messenger/bot/flow/create" label="Criar fluxo do bot" path="Mensageria > Configurações > Bots / Fluxos Automáticos"}. No editor, localize **Verificar Vínculo com Entidade** no grupo **Condições**, arraste o node para o canvas e abra sua configuração.

![Configuração do node Verificar Vínculo com Entidade com Oportunidade selecionada](/docs/screenshots/config-fluxos-bot-node-verificar-vinculo-entidade.png)

## Como a verificação funciona

O node lê a sala de conversa que está executando o fluxo e verifica apenas o tipo selecionado. Ele não pesquisa o CRM por telefone ou e-mail e não cria, altera ou remove vínculos.

| Entidade selecionada | Pergunta respondida pelo node |
| --- | --- |
| Oportunidade | Esta conversa possui uma oportunidade associada? |
| Contato | Esta conversa possui um contato associado? |
| Empresa | Esta conversa possui uma empresa associada? |

Uma mesma conversa pode ter mais de um tipo de entidade. Para tomar decisões independentes, use um node para cada tipo que precisa ser verificado.

## Exemplo de decisão antes de criar uma oportunidade

---
title: "Evitar oportunidade duplicada"
caption: "O caminho negativo cria a oportunidade; o caminho positivo continua usando o vínculo já existente."
definition: |
  flowchart LR
    A[Conversa chega ao ponto de decisão] --> B{Vínculo com oportunidade?}
    B -->|Possui vínculo| C[Continuar com a oportunidade atual]
    B -->|Não possui vínculo| D[Gerar oportunidade]
    D --> E[Continuar a jornada comercial]
---

## Boas práticas e riscos comuns

- Escolha exatamente o tipo de entidade que a decisão deve verificar: oportunidade, contato ou empresa.
- O node verifica somente a conversa atual e não procura registros por telefone, e-mail ou outro dado.
- Conecte as duas saídas para evitar que a conversa pare quando o vínculo não existir.

## Como testar

- Teste uma conversa que tenha a entidade selecionada associada e confirme a saída **Possui vínculo**.
- Teste outra conversa sem essa associação e confirme a saída **Não possui vínculo**.
- Repita o teste para cada tipo de entidade usado no fluxo e confirme que nenhuma associação foi criada, alterada ou removida.

## Guias relacionados

- [Carregar Entidade Vinculada](/docs/configuracao/referencias/nodes-fluxos-do-bot/carregar-entidade-vinculada)
- [Gerar Entidade](/docs/configuracao/referencias/nodes-fluxos-do-bot/gerar-entidade)
- [Gerar Lead](/docs/configuracao/referencias/nodes-fluxos-do-bot/gerar-lead)
- [Nodes de fluxos do bot](/docs/configuracao/referencias/nodes-fluxos-do-bot)
- [Guia geral de fluxos do bot](/docs/configuracao/fluxos-automacoes/guia-geral-de-fluxos-do-bot)
- [Fluxos do bot](/docs/configuracao/fluxos-automacoes/fluxos-do-bot)