Omni: Buscar Chats

Quando usar

• Precisa localizar um chat especifico pelo ID para obter seus dados completos


• Quer listar chats abertos de um canal especifico (WhatsApp, Telegram, etc.)


• Precisa verificar se um contato ja possui um chat aberto antes de iniciar um novo


• Quer monitorar chats pendentes ou nao atribuidos para tomar acoes automaticas

---

Como funciona

O node consulta os chats do seu canal omni. No modo Unico*, retorna os dados completos de um chat especifico. No modo *Todos (Lista), retorna um array de chats filtrados pelos criterios configurados.

---

Configuracoes

Modo de Busca

| Modo | Descricao |
|------|-----------|
| Unico | Informe o ID do chat. Retorna os dados completos desse chat. |
| Todos (Lista) | Retorna um array de chats com filtros opcionais. |

ID do Chat (modo Unico)

ID do chat a ser buscado. Aceita variaveis dinamicas.

Exemplo: `{{trigger.output.chatId}}`

ID do Canal (modo Todos)

Campo opcional. Filtra chats por um canal especifico. Aceita variaveis dinamicas.

Tipo de Canal (modo Todos)

Filtro por tipo de canal:

| Opcao | Descricao |
|-------|-----------|
| Todos | Retorna chats de qualquer canal |
| WhatsApp | Apenas chats do WhatsApp |
| Telegram | Apenas chats do Telegram |
| E-mail | Apenas chats de e-mail |
| Instagram | Apenas chats do Instagram |
| Webchat | Apenas chats do webchat |

Status (modo Todos)

Filtro por status do chat:

| Opcao | Descricao |
|-------|-----------|
| Todos | Retorna chats de qualquer status |
| Pendente | Chats aguardando atendimento |
| Aberto | Chats em atendimento |
| Resolvido | Chats resolvidos |
| Fechado | Chats encerrados |

Busca (modo Todos)

Campo de texto para buscar por nome, telefone ou email do contato. Aceita variaveis dinamicas.

Limite (modo Todos)

Numero maximo de chats retornados. Padrao: 50.

Deslocamento (modo Todos)

Numero de registros a pular (para paginacao). Padrao: 0.

---

Dados de saida

Modo Unico

| Variavel | Tipo | Descricao |
|----------|------|-----------|
| `id` | Texto | ID do chat |
| `channelId` | Texto | ID do canal |
| `channelType` | Texto | Tipo do canal (whatsapp, telegram, etc.) |
| `contact` | Objeto | Dados do contato associado |
| `status` | Texto | Status atual do chat (pending, open, resolved, closed) |
| `assignedUserId` | Texto | ID do agente atribuido |
| `lastMessageAt` | Data | Data/hora da ultima mensagem |
| `lastMessagePreview` | Texto | Preview da ultima mensagem |
| `unreadCount` | Numero | Quantidade de mensagens nao lidas |
| `createdAt` | Data | Data de criacao do chat |

Modo Todos (Lista)

| Variavel | Tipo | Descricao |
|----------|------|-----------|
| `chats` | Lista | Array com os chats (cada item tem os mesmos campos do modo Unico) |
| `total` | Numero | Total de chats encontrados |

---

Dicas

• Use o modo Unico* quando ja tiver o ID do chat (ex: vindo do gatilho *Canal Omni).


• No modo Todos, combine filtros de status e tipo de canal para encontrar chats especificos (ex: todos os chats pendentes do WhatsApp).


• Use os campos `limit` e `offset` (deslocamento) para paginacao quando tiver muitos chats.


• O campo `contact` na saida contem os dados do contato associado ao chat — util para personalizar mensagens.


• Combine com o node Omni: Atribuir Chat para atribuir chats pendentes automaticamente.