Pular para o conteúdo principal
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
}

Authorizations

​
token
string
header
required

Body

application/json
​
id
string

ID específico da mensagem para busca exata

Example:

"user123:r3EB0538"

​
chatid
string

ID do chat no formato internacional

Example:

"5511999999999@s.whatsapp.net"

​
track_source
string

Origem do rastreamento para filtrar mensagens

Example:

"chatwoot"

​
track_id
string

ID de rastreamento para filtrar mensagens

Example:

"msg_123456789"

​
limit
integer
default:100

Numero maximo de mensagens a retornar (padrao 100)

Intervalo obrigatório: x >= 1
Example:

20

​
offset
integer
default:0

Deslocamento para paginacao (0 retorna as mensagens mais recentes)

Response

Lista de mensagens encontradas com metadados de paginacao

​
returnedMessages
integer

Quantidade de mensagens retornadas nesta pagina

​
messages
object[]
​
limit
integer

Limite aplicado na busca

​
offset
integer

Offset usado para recuperar os resultados

​
nextOffset
integer

Offset sugerido para a proxima pagina

​
hasMore
boolean

Indica se existem mais mensagens apos esta pagina