curl --request POST \
--url https://api.wppfy.com/message/find \
--header 'Content-Type: application/json' \
--header 'token: <api-key>' \
--data '
{
"chatid": "5511999999999@s.whatsapp.net",
"limit": 20,
"offset": 0
}
'{
"returnedMessages": 123,
"messages": [
{
"id": "3c90c3cc-0d44-4b50-8888-8dd25736052a",
"messageid": "<string>",
"chatid": "<string>",
"fromMe": false,
"isGroup": false,
"messageType": "text",
"messageTimestamp": 0,
"edited": "",
"quoted": "",
"reaction": "",
"sender": "",
"senderName": "",
"source": "",
"status": "",
"text": "",
"vote": "",
"buttonOrListid": "",
"convertOptions": "",
"fileURL": "",
"content": "<string>",
"owner": "",
"track_source": "",
"track_id": "",
"created": "(strftime('%Y-%m-%d %H:%M:%f', 'now'))",
"updated": "(strftime('%Y-%m-%d %H:%M:%f', 'now'))",
"ai_metadata": {
"agent_id": "<string>",
"request": {
"messages": "<array>",
"tools": "<array>",
"options": {
"model": "<string>",
"temperature": 123,
"maxTokens": 123,
"topP": 123,
"frequencyPenalty": 123,
"presencePenalty": 123
}
},
"response": {
"choices": "<array>",
"toolResults": "<array>",
"error": "<string>"
}
}
}
],
"limit": 123,
"offset": 123,
"nextOffset": 123,
"hasMore": true
}Ações na mensagem e Buscar
Buscar mensagens em um chat
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)
POST
/
message
/
find
curl --request POST \
--url https://api.wppfy.com/message/find \
--header 'Content-Type: application/json' \
--header 'token: <api-key>' \
--data '
{
"chatid": "5511999999999@s.whatsapp.net",
"limit": 20,
"offset": 0
}
'{
"returnedMessages": 123,
"messages": [
{
"id": "3c90c3cc-0d44-4b50-8888-8dd25736052a",
"messageid": "<string>",
"chatid": "<string>",
"fromMe": false,
"isGroup": false,
"messageType": "text",
"messageTimestamp": 0,
"edited": "",
"quoted": "",
"reaction": "",
"sender": "",
"senderName": "",
"source": "",
"status": "",
"text": "",
"vote": "",
"buttonOrListid": "",
"convertOptions": "",
"fileURL": "",
"content": "<string>",
"owner": "",
"track_source": "",
"track_id": "",
"created": "(strftime('%Y-%m-%d %H:%M:%f', 'now'))",
"updated": "(strftime('%Y-%m-%d %H:%M:%f', 'now'))",
"ai_metadata": {
"agent_id": "<string>",
"request": {
"messages": "<array>",
"tools": "<array>",
"options": {
"model": "<string>",
"temperature": 123,
"maxTokens": 123,
"topP": 123,
"frequencyPenalty": 123,
"presencePenalty": 123
}
},
"response": {
"choices": "<array>",
"toolResults": "<array>",
"error": "<string>"
}
}
}
],
"limit": 123,
"offset": 123,
"nextOffset": 123,
"hasMore": true
}Autorizações
Corpo
application/json
ID específico da mensagem para busca exata
Exemplo:
"user123:r3EB0538"
ID do chat no formato internacional
Exemplo:
"5511999999999@s.whatsapp.net"
Origem do rastreamento para filtrar mensagens
Exemplo:
"chatwoot"
ID de rastreamento para filtrar mensagens
Exemplo:
"msg_123456789"
Numero maximo de mensagens a retornar (padrao 100)
Intervalo obrigatório:
x >= 1Exemplo:
20
Deslocamento para paginacao (0 retorna as mensagens mais recentes)
Resposta
Lista de mensagens encontradas com metadados de paginacao
Quantidade de mensagens retornadas nesta pagina
Show child attributes
Show child attributes
Limite aplicado na busca
Offset usado para recuperar os resultados
Offset sugerido para a proxima pagina
Indica se existem mais mensagens apos esta pagina