Pular para o conteúdo principal
GET
/
v1
/
chat
/
{id}
Buscar chat por ID
curl --request GET \
  --url https://api.liderhub.com.br/v1/chat/{id} \
  --header 'x-company-key: <api-key>'
{
  "contactId": "aaaaaaaa-bbbb-cccc-dddd-111111111111",
  "contactNumber": "5511999999999",
  "integration": "WHATSAPP-NON-OFFICIAL",
  "contactName": "João Silva",
  "department": {},
  "status": {},
  "source": {},
  "connection": {},
  "aiAgent": {},
  "humanAgent": {},
  "ticketStatus": "open",
  "createdAt": {},
  "lastInteraction": {},
  "isWhatsAppWindowClosed": {},
  "tags": {}
}

Autorizações

​
x-company-key
string
header
obrigatório

Chave de autenticação do workspace (gerada na plataforma Liderhub)

Parâmetros de caminho

​
id
string
obrigatório

UUID do chat

Resposta

Chat retornado com sucesso

​
contactId
string
obrigatório

Contact unique identifier

Exemplo:

"aaaaaaaa-bbbb-cccc-dddd-111111111111"

​
contactNumber
string
obrigatório

Contact phone number

Exemplo:

"5511999999999"

​
integration
enum<string>
obrigatório

Normalized integration type

Opções disponíveis:
WHATSAPP-NON-OFFICIAL,
WHATSAPP-BUSINESS
Exemplo:

"WHATSAPP-NON-OFFICIAL"

​
contactName
object

Contact name

Exemplo:

"João Silva"

​
department
object

Department ID

​
status
object

Status label ID

​
source
object

Source label ID

​
connection
object

Connection ID

​
aiAgent
object

AI agent ID

​
humanAgent
object

Human agent (company user) ID

​
ticketStatus
object

Ticket status

Exemplo:

"open"

​
createdAt
object

Chat creation date (ISO string)

​
lastInteraction
object

Last interaction date (ISO string). Returned only for official integrations.

​
isWhatsAppWindowClosed
object

True when WhatsApp conversation window is closed. Returned only for official integrations.

​
tags
object

Tags array

Last modified on February 16, 2026