Buscar Opcao

Quando usar

• Precisa obter o ID de uma opcao de status para usar em um Se / Senao (If)* ou *Alternador (Switch)


• Quer que a IA identifique automaticamente a opcao correta de um campo de selecao (ex: status "Em andamento")


• Precisa listar todas as opcoes de um campo para apresentar ao usuario


• Quer atribuir um valor de campo personalizado a um card com base em uma condicao

---

Como funciona

O node navega pela hierarquia: Projeto* > **Campo** > **Opcao**. Primeiro voce seleciona o projeto, depois o campo do tipo selecao ou checkbox, e por fim a opcao desejada. No modo **Unica**, retorna o ID e label de uma opcao especifica. No modo *Todas (Lista), retorna todas as opcoes do campo selecionado.

---

Configuracoes

Descricao (para Ferramenta IA)

Campo de texto que descreve o proposito desta busca. Ajuda a IA a entender quando usar esta ferramenta durante uma conversa com o chatbot.

Exemplo: `Buscar etapa do atendimento`, `Encontrar prioridade do card`

Modo de Busca

| Modo | Descricao |
|------|-----------|
| Unica | Selecione uma opcao especifica. Retorna o ID e label dessa opcao. |
| Todas (Lista) | Retorna um array com todas as opcoes do campo selecionado. |

Projeto

Dropdown que lista todos os projetos do workspace. Selecione o projeto que contem o campo desejado.

Campo (Tipo Selecao)

Exibido apos selecionar um projeto. Dropdown que lista apenas os campos do tipo select* ou *checkbox do projeto. Mostra o icone e titulo de cada campo.

Opcao Desejada (modo Unica)

Exibido apos selecionar um campo. Dropdown que lista todas as opcoes desse campo, mostrando a cor e o nome de cada opcao.

---

Dados de saida

Modo Unica

| Variavel | Tipo | Descricao |
|----------|------|-----------|
| `value` | Texto | ID da opcao selecionada |
| `label` | Texto | Nome/label da opcao |

Modo Todas (Lista)

| Variavel | Tipo | Descricao |
|----------|------|-----------|
| `fieldId` | Texto | ID do campo consultado |
| `fieldType` | Texto | Tipo do campo (select, checkbox) |
| `fieldName` | Texto | Nome do campo |
| `searchTerm` | Texto | Termo de busca usado |
| `options` | Lista | Array com as opcoes encontradas |
| `options[].value` | Texto | ID da opcao |
| `options[].label` | Texto | Nome/label da opcao |

---

Dicas

• Use no modo Unica* quando precisar comparar o status de um card com uma opcao especifica. Exemplo: no *Se / Senao, compare `{{trigger.output.data.status}}` com `{{findOption.output.value}}`.


• No modo Todas*, combine com o node *Para Cada (For Each) para executar acoes para cada opcao de um campo.


• A descricao para ferramenta IA e essencial quando este node e usado como tool do chatbot — descreva claramente o que a IA deve buscar.


• Apenas campos do tipo select* e *checkbox aparecem no dropdown de campos. Outros tipos de campo nao possuem opcoes.


• O `value` retornado e o ID interno da opcao, nao o texto visivel. Use `label` quando precisar mostrar o nome ao usuario.