Pular para o conteúdo principal
GET
/
v1
/
message
Listar mensagens de um contato
curl --request GET \
  --url https://api.liderhub.com.br/v1/message \
  --header 'x-company-key: <api-key>'
{
  "messages": [
    {
      "messageId": "f8d015c2-e21b-4b96-9455-238d2e5be137",
      "contactId": "c83ccc3a-1102-4386-a533-d7a2f042b121",
      "outbound": true,
      "createdAt": "<string>",
      "content": "Hello!",
      "type": "conversation",
      "deliveryStatus": "DELIVERED",
      "sentAt": {},
      "scheduledFor": {},
      "mediaUrl": {},
      "mediaCaption": {},
      "audioText": {}
    }
  ],
  "pagination": {
    "page": 1,
    "limit": 20,
    "total": 154,
    "totalPages": 8,
    "hasNextPage": true,
    "hasPreviousPage": false
  }
}

Autorizações

x-company-key
string
header
obrigatório

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

Parâmetros de consulta

contactId
string
obrigatório

ID do contato/chat

Exemplo:

"aaaaaaaa-bbbb-cccc-dddd-111111111111"

page
number
padrão:1

Página (começa em 1, padrão: 1)

Exemplo:

1

limit
number
padrão:20

Itens por página (padrão: 20, máximo: 100)

Exemplo:

20

Resposta

Lista de mensagens retornada com sucesso

messages
object[]
obrigatório
pagination
object
obrigatório

Pagination metadata

Last modified on March 24, 2026