CodeChat APIv1.0.0
ChangelogPostman
Referência/Legacy - Chats/legacyFindMessages
Legacy - Chats

Busca mensagens persistidas pelo contrato legado

Alias legado com where/page/offset. Consulta o banco da instancia e nao exige conexao ativa ao WhatsApp. keyid e messageStatus preservam os nomes legados; a resposta preserva MessageUpdate com capitalizacao legada.

Deprecated
POSThttp://localhost:8084/chat/findMessages/{instanceName}

Autenticação

InstanceBearerobrigatório

JWT HS256 da própria instância.

Header
Authorization
Exemplo
Bearer <INSTANCE_TOKEN>

Parâmetros

instanceNamepathobrigatório
string

Nome público da instância na rota legada ou no segundo segmento de logout

minLength 1

Request body

bodyobject
whereobject
idintegermín: 1
keyidstring
keyRemoteJidstring
keyFromMeenum<true | false>
messageTypestring
deviceenum<web | ios | android | unknown | desktop>
messageStatusstring
offsetintegerpadrão: 50 · mín: 1 · máx: 100
pageintegerpadrão: 1 · mín: 1
Exemplo JSON
{
  "where": {
    "id": 2,
    "keyid": "3A4592EBC0C67D447FB2",
    "keyRemoteJid": "[email protected]",
    "keyFromMe": "true",
    "messageType": "imageMessage",
    "device": "web",
    "messageStatus": "DELIVERY_ACK"
  },
  "offset": 20,
  "page": 1
}

Respostas

application/json
200

Pagina legada de mensagens

response 200object
messagesobjectobrigatório
totalintegerobrigatórioformat: int64
pagesintegerobrigatórioformat: int64
currentPageintegerobrigatórioformat: int64
recordsarrayobrigatório
items[]allOf
opção 1object
idintegerobrigatório
keyIdstringobrigatório
keyRemoteJidstring | nullobrigatório
keyLidstring | nullobrigatório
keyFromMebooleanobrigatório
keyParticipantstring | nullobrigatório
keyParticipantLidstring | nullobrigatório
pushNamestring | nullobrigatório
messageTypestringobrigatório
contentanyobrigatório
messageTimestampintegerobrigatório
deviceenum<ios | android | web | unknown | desktop>obrigatório
isGroupboolean | nullobrigatório
instanceIdintegerobrigatório
metadataany
externalAttributesobject
opção 2object
MessageUpdatearrayobrigatório
items[]object
statusstringobrigatório
dateTimestringobrigatórioformat: date-time
Exemplo 200gerado do schema
{
  "messages": {
    "total": 1,
    "pages": 1,
    "currentPage": 1,
    "records": [
      {
        "id": 1,
        "keyId": "string",
        "keyRemoteJid": "[email protected]",
        "keyLid": "string",
        "keyFromMe": true,
        "keyParticipant": "string",
        "keyParticipantLid": "string",
        "pushName": "CodeChat",
        "messageType": "Olá! Esta é uma mensagem de exemplo da CodeChat.",
        "content": "string",
        "messageTimestamp": 1,
        "device": "ios",
        "isGroup": true,
        "instanceId": 1,
        "metadata": "string",
        "externalAttributes": {},
        "MessageUpdate": [
          {
            "status": "string",
            "dateTime": "2026-07-13T15:10:00Z"
          }
        ]
      }
    ]
  }
}