Contato: Buscar

Quando usar

• Você precisa localizar um contato antes de enviar um e-mail ou mensagem no omni


• Quer obter os dados completos de um contato (telefone, empresa, tags) para usar em nodes seguintes


• Precisa listar todos os contatos do workspace para iterar com um "Para Cada"


• Quer filtrar contatos por nome ou tag para segmentar ações no fluxo

---

Como funciona

O node consulta a base de contatos do seu workspace e retorna os dados de acordo com o modo de busca escolhido. No modo Unico*, retorna os dados completos de um contato especifico. No modo *Todos (Lista), retorna um array com todos os contatos, podendo aplicar filtros opcionais por nome ou tag.

---

Configuracoes

Modo de Busca

Alterna entre dois modos de operacao:

| Modo | Descricao |
|------|-----------|
| Unico | Selecione um contato especifico pelo dropdown. Retorna os dados completos desse contato. |
| Todos (Lista) | Retorna um array com todos os contatos do workspace, com filtros opcionais. |

Contato (modo Unico)

Dropdown que lista todos os contatos do workspace. Selecione o contato desejado. O dropdown mostra nome, foto e empresa de cada contato.

Filtro por Nome (modo Todos)

Campo de texto opcional. Filtra os contatos cujo nome contenha o texto informado. Aceita variaveis dinamicas (ex: `{{trigger.output.body.nome}}`).

Filtro por Tag (modo Todos)

Campo de texto opcional. Filtra os contatos que possuam a tag informada. Aceita variaveis dinamicas.

---

Dados de saida

Modo Unico

| Variavel | Tipo | Descricao |
|----------|------|-----------|
| `id` | Texto | ID unico do contato |
| `name` | Texto | Nome do contato |
| `company` | Texto | Empresa do contato |
| `picture` | Texto | URL da foto de perfil |
| `channels` | Lista | Canais de contato (array) |
| `channels[].channel` | Texto | Tipo do canal (email, phone, whatsapp, etc.) |
| `channels[].value` | Texto | Valor do canal (endereco de email, numero, etc.) |
| `channels[].primary` | Booleano | Se e o canal principal |
| `channels[].label` | Texto | Rotulo do canal (ex: Trabalho, Pessoal) |
| `tags` | Lista | Tags do contato (array) |
| `tags[].value` | Texto | Valor da tag |

Modo Todos (Lista)

| Variavel | Tipo | Descricao |
|----------|------|-----------|
| `contacts.count` | Numero | Quantidade total de contatos retornados |
| `contacts.items` | Lista | Array com os contatos |
| `contacts.items[].id` | Texto | ID do contato |
| `contacts.items[].name` | Texto | Nome do contato |
| `contacts.items[].company` | Texto | Empresa do contato |
| `contacts.items[].picture` | Texto | URL da foto de perfil |

---

Dicas

• No modo Todos*, combine com o node *Para Cada (For Each) para iterar sobre os contatos e executar acoes em lote (ex: enviar mensagem para todos os contatos com uma tag especifica).


• Use o modo Unico quando ja souber qual contato precisa — e mais rapido e retorna dados mais completos (incluindo canais e tags).


• Os filtros por nome e tag sao opcionais. Se nenhum filtro for preenchido, todos os contatos do workspace serao retornados.


• Combine com o node Se / Senao (If) para verificar se o contato tem determinada tag ou canal antes de prosseguir.