Ações na mensagem e Buscar
Buscar mensagens em um chat
/message/findAutenticaçã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:
- Busca por ID específico: Use
idpara encontrar uma mensagem exata - Filtrar por chat: Use
chatidpara mensagens de uma conversa específica - Filtrar por rastreamento: Use
track_sourceetrack_idpara mensagens com dados de tracking - Limitar resultados: Use
limitpara controlar quantas mensagens retornar - Ordenação: Resultados ordenados por data (mais recentes primeiro)
Corpo da requisição (JSON)
| Campo | Tipo | Descrição |
|---|---|---|
| id | string | ID específico da mensagem para busca exata Exemplo: user123:r3EB0538 |
| chatid | string | ID do chat no formato internacional Exemplo: [email protected] |
| track_source | string | Origem do rastreamento para filtrar mensagens Exemplo: chatwoot |
| track_id | string | ID de rastreamento para filtrar mensagens Exemplo: msg_123456789 |
| limit | integer | Numero maximo de mensagens a retornar (padrao 100) Exemplo: 20 |
| offset | integer | 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.