Últimas Mensagens

O comando Últimas Mensagens retorna as mensagens recentes de uma conversa específica. As mensagens sao entregues individualmente como webhooks, no mesmo formato das mensagens recebidas em tempo real.

Requisição

POST /api/v1/message/SendCommand

{
  "channelId": "uuid-do-canal",
  "content": {
    "type": "GET_LAST_MESSAGES",
    "commandType": "GET_LAST_MESSAGES",
    "chatJID": "5511999887766@s.whatsapp.net",
    "messageId": "3EB0A1B2C3D4E5F6"
  }
}

Campos

Campo	Tipo	Obrigatório	Descrição
`chatJID`	`string`	Sim	JID da conversa (contato ou grupo)
`messageId`	`string`	Não	ID da mensagem para páginacao. Se informado, retorna mensagens anteriores a está mensagem
`count`	`integer`	Não	Quantidade de mensagens a retornar. Padrão: 20
`fromMe`	`boolean`	Não	Filtra mensagens enviadas pelo próprio canal (`true`) ou recebidas (`false`). Omita para todas
`messageTimestamp`	`string` (ISO 8601)	Não	Timestamp de referência para paginação. Retorna mensagens anteriores a este momento

O campo messageId funciona como cursor de páginacao. Na primeira chamada, omita este campo para obter as mensagens mais recentes. Nas chamadas seguintes, use o messageId da mensagem mais antiga retornada para carregar mensagens anteriores.

Resposta da API

{
  "packageId": "3fa85f64-5717-4562-b3fc-2c963f66afa6"
}

Webhook de resposta

Diferente dos outros comandos, as mensagens nao sao entregues em um único webhook. Cada mensagem e enviada individualmente como um webhook separado, no mesmo formato das mensagens recebidas em tempo real. Por exemplo, para uma mensagem de texto:

{
  "packageId": "3fa85f64-5717-4562-b3fc-2c963f66afa6",
  "channelId": "uuid-do-canal",
  "content": {
    "type": "TEXT",
    "text": "Olá, como vai?",
    "from": {
      "phoneNumber": "5511999887766",
      "name": "João Silva"
    },
    "to": {
      "phoneNumber": "5521988776655",
      "name": "Maria Santos"
    },
    "messageId": "3EB0A1B2C3D4E5F6",
    "isFromMe": false,
    "isGroupMessage": false,
    "timestamp": "2025-04-14T10:30:00Z"
  }
}

Dependendo da quantidade de mensagens na conversa, você pode receber multiplos webhooks em sequência. Certifique-se de que seu servidor de webhook consegue processar multiplas requisicoes simultaneas.

Quando o processamento termina (com sucesso ou falha), a plataforma envia um webhook GET_LAST_MESSAGES_RESPONSE sinalizando o resultado global. Veja Recebendo Eventos para os campos.

Exemplo completo

curl -X POST https://api-dev.messagefy.io/api/v1/message/SendCommand \
  -H "Content-Type: application/json" \
  -H "X-API-KEY: sua-api-key" \
  -d '{
    "channelId": "a1b2c3d4-e5f6-7890-abcd-ef1234567890",
    "content": {
      "type": "GET_LAST_MESSAGES",
      "commandType": "GET_LAST_MESSAGES",
      "chatJID": "5511999887766@s.whatsapp.net"
    }
  }'

import requests

# Primeira chamada - mensagens mais recentes
response = requests.post(
    "https://api-dev.messagefy.io/api/v1/message/SendCommand",
    headers={
        "Content-Type": "application/json",
        "X-API-KEY": "sua-api-key"
    },
    json={
        "channelId": "a1b2c3d4-e5f6-7890-abcd-ef1234567890",
        "content": {
            "type": "GET_LAST_MESSAGES",
            "commandType": "GET_LAST_MESSAGES",
            "chatJID": "5511999887766@s.whatsapp.net"
        }
    }
)

print(response.json())

# Segunda chamada - paginacao (mensagens anteriores)
response = requests.post(
    "https://api-dev.messagefy.io/api/v1/message/SendCommand",
    headers={
        "Content-Type": "application/json",
        "X-API-KEY": "sua-api-key"
    },
    json={
        "channelId": "a1b2c3d4-e5f6-7890-abcd-ef1234567890",
        "content": {
            "type": "GET_LAST_MESSAGES",
            "commandType": "GET_LAST_MESSAGES",
            "chatJID": "5511999887766@s.whatsapp.net",
            "messageId": "3EB0A1B2C3D4E5F6"
        }
    }
)

// Primeira chamada - mensagens mais recentes
const response = await fetch(
  "https://api-dev.messagefy.io/api/v1/message/SendCommand",
  {
    method: "POST",
    headers: {
      "Content-Type": "application/json",
      "X-API-KEY": "sua-api-key",
    },
    body: JSON.stringify({
      channelId: "a1b2c3d4-e5f6-7890-abcd-ef1234567890",
      content: {
        type: "GET_LAST_MESSAGES",
        commandType: "GET_LAST_MESSAGES",
        chatJID: "5511999887766@s.whatsapp.net",
      },
    }),
  }
);

const data = await response.json();
console.log(data);

Exemplo com filtros avançados

cURL

curl -X POST https://api-dev.messagefy.io/api/v1/message/SendCommand \
  -H "Content-Type: application/json" \
  -H "X-API-KEY: sua-api-key" \
  -d '{
    "channelId": "a1b2c3d4-e5f6-7890-abcd-ef1234567890",
    "content": {
      "type": "GET_LAST_MESSAGES",
      "commandType": "GET_LAST_MESSAGES",
      "chatJID": "5511999887766@s.whatsapp.net",
      "count": 50,
      "fromMe": false,
      "messageTimestamp": "2025-04-14T12:00:00Z"
    }
  }'

Python

import requests

# Buscar últimas 50 mensagens recebidas antes de um timestamp específico
response = requests.post(
    "https://api-dev.messagefy.io/api/v1/message/SendCommand",
    headers={
        "Content-Type": "application/json",
        "X-API-KEY": "sua-api-key"
    },
    json={
        "channelId": "a1b2c3d4-e5f6-7890-abcd-ef1234567890",
        "content": {
            "type": "GET_LAST_MESSAGES",
            "commandType": "GET_LAST_MESSAGES",
            "chatJID": "5511999887766@s.whatsapp.net",
            "count": 50,
            "fromMe": False,
            "messageTimestamp": "2025-04-14T12:00:00Z"
        }
    }
)

print(response.json())

Node.js

// Buscar últimas 50 mensagens recebidas antes de um timestamp específico
const response = await fetch(
  "https://api-dev.messagefy.io/api/v1/message/SendCommand",
  {
    method: "POST",
    headers: {
      "Content-Type": "application/json",
      "X-API-KEY": "sua-api-key",
    },
    body: JSON.stringify({
      channelId: "a1b2c3d4-e5f6-7890-abcd-ef1234567890",
      content: {
        type: "GET_LAST_MESSAGES",
        commandType: "GET_LAST_MESSAGES",
        chatJID: "5511999887766@s.whatsapp.net",
        count: 50,
        fromMe: false,
        messageTimestamp: "2025-04-14T12:00:00Z",
      },
    }),
  }
);

const data = await response.json();
console.log(data);

Este exemplo busca as últimas 50 mensagens recebidas (fromMe: false) antes de 2025-04-14T12:00:00Z.

Você pode obter o chatJID usando o comando Listar Conversas. Para contatos individuais, o JID segue o formato número@s.whatsapp.net. Para grupos, o formato e id@g.us.

Início

Contas

API Keys

Canais

WhatsApp Oficial

Tipos de Mensagem

Operações de Mensagem

Sessão e Conexão

Consultas

Interação

Últimas Mensagens

Últimas Mensagens

Requisição

Campos

Resposta da API

Webhook de resposta

Exemplo completo

Exemplo com filtros avançados

​Últimas Mensagens

​Requisição

​Campos

​Resposta da API

​Webhook de resposta

​Exemplo completo

​Exemplo com filtros avançados

Últimas Mensagens

Requisição

Campos

Resposta da API

Webhook de resposta

Exemplo completo

Exemplo com filtros avançados