> ## Documentation Index
> Fetch the complete documentation index at: https://docs.zapclass.com.br/llms.txt
> Use this file to discover all available pages before exploring further.

# Buscar Mensagens

> Buscar mensagens em um chat com filtros avançados

Realiza buscas de mensagens utilizando múltiplos filtros disponíveis para localizar conversas, rastrear interações ou recuperar mensagens específicas.

## Recursos de Busca

> **Busca por ID Específico**
>
> Localiza uma mensagem exata através do seu identificador único.
>
> **Parâmetro:** `id`
>
> **Uso ideal:** Quando você precisa recuperar uma mensagem específica já conhecida.

> **Filtrar por Chat**
>
> Recupera todas as mensagens de uma conversa específica.
>
> **Parâmetro:** `chat_id` (formato: nú[mero@s.whatsapp.net](mailto:mero@s.whatsapp.net))
>
> **Uso ideal:** Visualizar histórico completo de uma conversa ou análise de interações com um cliente.

> **Rastreamento de Mensagens**
>
> Filtra mensagens por dados de rastreamento personalizados.
>
> **Parâmetros:** `message_source` e `message_id`
>
> **Uso ideal:** Identificar mensagens enviadas por integrações específicas (n8n, typebot, chatwoot, etc.) ou campanhas marcadas.

> **Controle de Resultados**
>
> Limita a quantidade de mensagens retornadas.
>
> **Parâmetro:** `limit`
>
> **Ordenaçã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](mailto: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`

> [!TIP]
>
> **Combine filtros** para buscas mais precisas. Por exemplo, use `chatid` +
> `track_source` para encontrar mensagens de uma integração específica em uma
> conversa.

```bash cURL theme={null}
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
  }'
```

```javascript JavaScript theme={null}
const response = await fetch("https://zapclass.com.br/api/messages/find", {
  method: "POST",
  headers: {
    "Content-Type": "application/json",
    Authorization: "Bearer zc_6FrX2qjM4bHT9pR6cC0sD8wLkG3nE2tZfV5uN1aP",
  },
  body: JSON.stringify({
    chat_id: "5511999999999@s.whatsapp.net",
    message_source: "typebot",
    limit: 10,
  }),
});
```

```php PHP theme={null}
<?php
$ch = curl_init('https://zapclass.com.br/api/messages/find');

$payload = [
    "chat_id" => "5511999999999@s.whatsapp.net",
    "message_source" => "typebot",
    "limit" => 10
];

curl_setopt($ch, CURLOPT_POST, 1);
curl_setopt($ch, CURLOPT_POSTFIELDS, json_encode($payload));
curl_setopt($ch, CURLOPT_HTTPHEADER, [
    'Content-Type: application/json',
    'Authorization: Bearer zc_6FrX2qjM4bHT9pR6cC0sD8wLkG3nE2tZfV5uN1aP'
]);
curl_setopt($ch, CURLOPT_RETURNTRANSFER, true);

curl_exec($ch);
curl_close($ch);
?>
```

```json 200 theme={null}
{
  "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
}
```

```json 400 theme={null}
{
  "success": false,
  "message": "Token de autenticação inválido"
}
```


This documentation is built and hosted on [Mintlify](https://mintlify.com), a developer documentation platform.