Skip to main content
POST
Buscar chats con filtros

Autorizaciones

token
string
header
requerido

Cuerpo

application/json
operator
enum<string>
predeterminado:AND

Operador lógico entre los filtros

Opciones disponibles:
AND,
OR
sort
string

Campo para ordenamiento (+/-campo). Ej. -wa_lastMsgTimestamp

limit
integer

Formato completo: predeterminado 2000, conservando un limit positivo explícito sin nuevo tope. Formato compacto: predeterminado 100, máximo 200. Omitido, cero o negativo usa el valor predeterminado del modo.

offset
integer
predeterminado:0

Número de registros a omitir (para paginación)

compact
boolean
predeterminado:false

Devuelve solo la proyección usada en listas/sidebar: identidad, nombres, preview, flags, unread, último mensaje, labels y campos esenciales del lead. No devuelve campos personalizados, notas completas ni el estado del chatbot.

wa_fastid
string
wa_chatid
string
wa_archived
boolean
wa_contactName
string
wa_name
string
name
string
wa_isBlocked
boolean
wa_isGroup
boolean
wa_isGroup_admin
boolean
wa_isGroup_announce
boolean
wa_isGroup_member
boolean
wa_isPinned
boolean
wa_unreadCount
string

Mensajes no leídos, con operador: >0 trae las conversaciones con mensajes no leídos.

lead_awaitingReply
boolean

true: conversaciones en las que el contacto espera respuesta (esperando su respuesta); false: las que no esperan. Las conversaciones sin último mensaje no entran en ninguno de los dos.

wa_label
string

ID de la label aplicada al chat. Use el valor devuelto por /labels, no el nombre de la etiqueta.

wa_notes
string
lead_tags
string
lead_isTicketOpen
boolean
lead_assignedAttendant_id
string
lead_status
string

Use =valor para igualdad explícita.

lead_tag
string

Devuelve los chats que contienen exactamente esta tag en lead_tags, sin confundir nombres parcialmente iguales.

Respuesta

200 - application/json

Lista de chats encontrados

chats
object[]

Chats de la página. En el modo compacto, solo se completan los campos de la proyección de listado.

totalChatsStats
object

Contadores totales de chats

pagination
object