Skip to main content
POST
/
messages
/
find
curl -X POST https://zapclass.com.br/api/messages/find \
  -H "Content-Type: application/json" \
  -H "Authorization: Bearer zc_6FrX2qjM4bHT9pR6cC0sD8wLkG3nE2tZfV5uN1aP" \
  -d '{
    "chat_id": "5511999999999@s.whatsapp.net",
    "message_source": "typebot",
    "limit": 10
  }'
{
  "success": true,
  "messages": [
    {
      "id": "5511999999999:1AB2C3DEFG4H56I78JKL9M",
      "chat_id": "5511999999999@s.whatsapp.net",
      "message": "Olá, gostaria de mais informações sobre o produto",
      "timestamp": "2025-10-04T15:30:00Z",
      "from_me": false,
      "message_source": "typebot",
      "message_id": "msg_123456789"
    },
    {
      "id": "5511999999999:1AB2C3DEFG4H56I78JKL9N",
      "chat_id": "5511999999999@s.whatsapp.net",
      "message": "Claro! Posso ajudar com isso",
      "timestamp": "2025-10-04T15:31:00Z",
      "from_me": true,
      "message_source": "typebot",
      "message_id": "msg_123456790"
    }
  ],
  "total": 2
}
Realiza buscas de mensagens utilizando múltiplos filtros disponíveis para localizar conversas, rastrear interações ou recuperar mensagens específicas.

Recursos de Busca

Localiza uma mensagem exata através do seu identificador único.Parâmetro: idUso ideal: Quando você precisa recuperar uma mensagem específica já conhecida.
Recupera todas as mensagens de uma conversa específica.Parâmetro: chat_id (formato: número@s.whatsapp.net)Uso ideal: Visualizar histórico completo de uma conversa ou análise de interações com um cliente.
Filtra mensagens por dados de rastreamento personalizados.Parâmetros: message_source e message_idUso ideal: Identificar mensagens enviadas por integrações específicas (n8n, typebot, chatwoot, etc.) ou campanhas marcadas.
Limita a quantidade de mensagens retornadas.Parâmetro: limitOrdenação: Resultados sempre ordenados por data (mais recentes primeiro)Uso ideal: Paginação ou visualização de mensagens recentes.

Authorization

api_key
string
required
Chave de autenticação da sua conexão, utilizada no header Authorization como Bearer Token.
Você encontra sua API Key no botão API da sua conexão no painel ZapClass.
A chave sempre começa com o prefixo zc_.
Exemplo: zc_6FrX2qjM4bHT9pR6cC0sD8wLkG3nE2tZfV5uN1aP

Body Parameters

id
string
ID específico da mensagem para busca exata.
Retorna apenas a mensagem com este identificador.
Exemplo: user123:r3EB0538
chat_id
string
ID do chat no formato internacional.
Filtra mensagens de uma conversa específica.
Formato: número@s.whatsapp.net
Exemplo: 5511999999999@s.whatsapp.net
message_source
string
Origem do envio da mensagem.
Normalmente usado para rastreamento da mensagem.
Exemplo: typebot
message_id
string
Identificador do envio da mensagem.
Combinado com o message_source pode ser usado para rastreamento.
Exemplo: 5511999999999:1AB2C3DEFG4H56I78JKL9M
limit
integer
Número máximo de mensagens a retornar.
Útil para paginação e controle de resultados.
Exemplo: 10
Combine filtros para buscas mais precisas. Por exemplo, use chatid + track_source para encontrar mensagens de uma integração específica em uma conversa.
curl -X POST https://zapclass.com.br/api/messages/find \
  -H "Content-Type: application/json" \
  -H "Authorization: Bearer zc_6FrX2qjM4bHT9pR6cC0sD8wLkG3nE2tZfV5uN1aP" \
  -d '{
    "chat_id": "5511999999999@s.whatsapp.net",
    "message_source": "typebot",
    "limit": 10
  }'
{
  "success": true,
  "messages": [
    {
      "id": "5511999999999:1AB2C3DEFG4H56I78JKL9M",
      "chat_id": "5511999999999@s.whatsapp.net",
      "message": "Olá, gostaria de mais informações sobre o produto",
      "timestamp": "2025-10-04T15:30:00Z",
      "from_me": false,
      "message_source": "typebot",
      "message_id": "msg_123456789"
    },
    {
      "id": "5511999999999:1AB2C3DEFG4H56I78JKL9N",
      "chat_id": "5511999999999@s.whatsapp.net",
      "message": "Claro! Posso ajudar com isso",
      "timestamp": "2025-10-04T15:31:00Z",
      "from_me": true,
      "message_source": "typebot",
      "message_id": "msg_123456790"
    }
  ],
  "total": 2
}