Buscar Usuario

Quando usar

• Precisa identificar um usuario especifico do workspace para atribuir tarefas ou chats


• Quer obter o ID de um usuario para usar em nodes como "Omni: Atribuir Chat" ou "Projeto: Adicionar Membro"


• Precisa listar todos os usuarios do workspace para comparacao ou selecao


• O chatbot precisa buscar o responsavel por um atendimento

---

Como funciona

O node consulta a lista de usuarios do seu workspace. No modo Unico*, voce seleciona um usuario pelo dropdown e o node retorna seus dados completos. No modo *Todos (Lista), retorna um array com todos os usuarios do workspace.

---

Configuracoes

Descricao (para Ferramenta IA)

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

Exemplo: `Buscar responsavel do atendimento`, `Encontrar gerente do projeto`

Modo de Busca

| Modo | Descricao |
|------|-----------|
| Unico | Selecione um usuario pelo dropdown. Retorna os dados completos desse usuario. |
| Todos (Lista) | Retorna um array com todos os usuarios do workspace. |

Usuario (modo Unico)

Dropdown que lista todos os usuarios do workspace, mostrando foto, nome e email de cada um. Selecione o usuario desejado.

---

Dados de saida

Modo Unico

| Variavel | Tipo | Descricao |
|----------|------|-----------|
| `id` | Texto | ID unico do usuario |
| `name` | Texto | Nome do usuario |
| `email` | Texto | Email do usuario |
| `picture` | Texto | URL da foto de perfil |

Modo Todos (Lista)

| Variavel | Tipo | Descricao |
|----------|------|-----------|
| `users.count` | Numero | Quantidade total de usuarios |
| `users.items` | Lista | Array com os usuarios |
| `users.items[].id` | Texto | ID do usuario |
| `users.items[].name` | Texto | Nome do usuario |
| `users.items[].email` | Texto | Email do usuario |

---

Dicas

• Use no modo Unico* quando precisar comparar o usuario de um node anterior com um usuario fixo (ex: verificar se o responsavel e o gerente no *Se / Senao).


• No modo Todos*, combine com o node *Para Cada (For Each) para executar acoes para cada usuario (ex: enviar notificacao para todos).


• A descricao para ferramenta IA e importante quando este node e usado como tool do chatbot — escreva uma descricao clara para que a IA saiba quando invocar esta busca.


• O campo `id` retornado pode ser usado diretamente em nodes como Omni: Atribuir Chat* (campo `userId`) ou *Projeto: Adicionar Membro (campo `userId`).