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
}'
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
$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);
?>
{
"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
}
{
"success": false,
"message": "Token de autenticação inválido"
}
Mensagens
Buscar Mensagens
Buscar mensagens em um chat com filtros avançados
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
}'
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
$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);
?>
{
"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
}
{
"success": false,
"message": "Token de autenticação inválido"
}
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
Busca por ID Específico
Localiza uma mensagem exata através do seu identificador único.Parâmetro:
idUso ideal: Quando você precisa recuperar uma mensagem específica já conhecida.Filtrar por Chat
Filtrar por Chat
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.Rastreamento de Mensagens
Rastreamento de Mensagens
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.Controle de Resultados
Controle de Resultados
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
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
Exemplo:
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_6FrX2qjM4bHT9pR6cC0sD8wLkG3nE2tZfV5uN1aPBody Parameters
string
ID específico da mensagem para busca exata.
Retorna apenas a mensagem com este identificador.
Exemplo:
Retorna apenas a mensagem com este identificador.
Exemplo:
user123:r3EB0538string
ID do chat no formato internacional.
Filtra mensagens de uma conversa específica.
Formato: número@s.whatsapp.net
Exemplo:
Filtra mensagens de uma conversa específica.
Formato: número@s.whatsapp.net
Exemplo:
5511999999999@s.whatsapp.netstring
Origem do envio da mensagem.
Normalmente usado para rastreamento da mensagem.
Exemplo:
Normalmente usado para rastreamento da mensagem.
Exemplo:
typebotstring
Identificador do envio da mensagem.
Combinado com o
Exemplo:
Combinado com o
message_source pode ser usado para rastreamento. Exemplo:
5511999999999:1AB2C3DEFG4H56I78JKL9Minteger
Número máximo de mensagens a retornar.
Útil para paginação e controle de resultados.
Exemplo:
Útil para paginação e controle de resultados.
Exemplo:
10Combine 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
}'
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
$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);
?>
{
"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
}
{
"success": false,
"message": "Token de autenticação inválido"
}
⌘I