NODAPI

Ações na mensagem e Buscar

Buscar mensagens em um chat

POST/message/find

Autenticação: envie a chave da conexão no header token ou em Authorization: Bearer.

Busca mensagens com múltiplos filtros disponíveis. Este endpoint permite:

  1. Busca por ID específico: Use id para encontrar uma mensagem exata
  2. Filtrar por chat: Use chatid para mensagens de uma conversa específica
  3. Filtrar por rastreamento: Use track_source e track_id para mensagens com dados de tracking
  4. Limitar resultados: Use limit para controlar quantas mensagens retornar
  5. Ordenação: Resultados ordenados por data (mais recentes primeiro)

Corpo da requisição (JSON)

CampoTipoDescrição
idstring

ID específico da mensagem para busca exata

Exemplo: user123:r3EB0538

chatidstring

ID do chat no formato internacional

Exemplo: [email protected]

track_sourcestring

Origem do rastreamento para filtrar mensagens

Exemplo: chatwoot

track_idstring

ID de rastreamento para filtrar mensagens

Exemplo: msg_123456789

limitinteger

Numero maximo de mensagens a retornar (padrao 100)

Exemplo: 20

offsetinteger

Deslocamento para paginacao (0 retorna as mensagens mais recentes)

Exemplo: 0

* obrigatório

Exemplos de corpo

Buscar por chat especifico

{
  "chatid": "[email protected]",
  "limit": 20,
  "offset": 0
}

Buscar por ID especifico

{
  "id": "user123:r3EB0538"
}

Buscar por rastreamento

{
  "track_source": "chatwoot",
  "track_id": "conv_123456",
  "limit": 50,
  "offset": 100
}

Respostas

  • 200Lista de mensagens encontradas com metadados de paginacao
  • 400Parametros invalidos
  • 401Token invalido ou expirado
  • 404Chat nao encontrado
  • 500Erro interno do servidor

Experimente

Atenção: a chamada é real. Ela roda na sua conexão e pode enviar mensagem de verdade. A chave fica só nesta tela e some ao sair dela; nunca é guardada.

Cole a chave gerada no painel.