curl -X POST https://zapclass.com.br/api/messages/download \
-H "Content-Type: application/json" \
-H "Authorization: Bearer zc_6FrX2qjM4bHT9pR6cC0sD8wLkG3nE2tZfV5uN1aP" \
-d '{
"id": "7EB0F01D7244B421048F0706368376E0",
"mp3": true,
"base64": true,
"link": true,
"quoted": true,
"openai_api_key": "sk-proj-..."
}'
const response = await fetch("https://zapclass.com.br/api/messages/download", {
method: "POST",
headers: {
"Content-Type": "application/json",
Authorization: "Bearer zc_6FrX2qjM4bHT9pR6cC0sD8wLkG3nE2tZfV5uN1aP",
},
body: JSON.stringify({
id: "7EB0F01D7244B421048F0706368376E0",
mp3: true,
base64: true,
link: true,
quoted: true,
openai_api_key: "sk-proj-...",
}),
});
<?php
$ch = curl_init('https://zapclass.com.br/api/messages/download');
$payload = [
"id" => "7EB0F01D7244B421048F0706368376E0",
"mp3" => true,
"base64" => true,
"link" => true,
"quoted" => true,
"openai_api_key" => "sk-proj-...",
];
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);
$response = curl_exec($ch);
$data = json_decode($response, true);
echo "URL do arquivo: " . $data['fileURL'];
curl_close($ch);
?>
{
"url": "https://api.exemplo.com/files/arquivo.mp3",
"base64": "base64encodedstring",
"mimetype": "audio/mpeg",
"transcription": "Olá, gostaria de saber mais informações sobre o produto que você postou no status"
}
{
"success": false,
"message": "Token de autenticação inválido"
}
Mensagens
Baixar Arquivo
Baixar arquivo de uma mensagem de mídia
POST
/
messages
/
download
curl -X POST https://zapclass.com.br/api/messages/download \
-H "Content-Type: application/json" \
-H "Authorization: Bearer zc_6FrX2qjM4bHT9pR6cC0sD8wLkG3nE2tZfV5uN1aP" \
-d '{
"id": "7EB0F01D7244B421048F0706368376E0",
"mp3": true,
"base64": true,
"link": true,
"quoted": true,
"openai_api_key": "sk-proj-..."
}'
const response = await fetch("https://zapclass.com.br/api/messages/download", {
method: "POST",
headers: {
"Content-Type": "application/json",
Authorization: "Bearer zc_6FrX2qjM4bHT9pR6cC0sD8wLkG3nE2tZfV5uN1aP",
},
body: JSON.stringify({
id: "7EB0F01D7244B421048F0706368376E0",
mp3: true,
base64: true,
link: true,
quoted: true,
openai_api_key: "sk-proj-...",
}),
});
<?php
$ch = curl_init('https://zapclass.com.br/api/messages/download');
$payload = [
"id" => "7EB0F01D7244B421048F0706368376E0",
"mp3" => true,
"base64" => true,
"link" => true,
"quoted" => true,
"openai_api_key" => "sk-proj-...",
];
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);
$response = curl_exec($ch);
$data = json_decode($response, true);
echo "URL do arquivo: " . $data['fileURL'];
curl_close($ch);
?>
{
"url": "https://api.exemplo.com/files/arquivo.mp3",
"base64": "base64encodedstring",
"mimetype": "audio/mpeg",
"transcription": "Olá, gostaria de saber mais informações sobre o produto que você postou no status"
}
{
"success": false,
"message": "Token de autenticação inválido"
}
Realiza o download de arquivos associados a mensagens de mídia (imagem, vídeo, áudio ou documento).
Casos de Uso
Download de Áudios
Download de Áudios
Permite baixar áudios em diferentes formatos:
- MP3 (padrão) - usando
generate_mp3: true - OGG (formato original) - usando
generate_mp3: false
Transcrição de Áudio
Transcrição de Áudio
Converte mensagens de voz em texto automaticamente.Requisitos:
- Chave da API OpenAI configurada
- Parâmetro
transcribe: true
Download de Mídia Citada
Download de Mídia Citada
Útil para baixar conteúdo original de status do WhatsApp.Exemplo de uso:
Quando um cliente responde a uma promoção/status, você pode baixar a mídia original para entender sobre qual produto/oferta ele está perguntando.Use
download_quoted: true para este cenário.Formatos de Retorno
Formatos de Retorno
Escolha como receber o arquivo:
- URL pública (padrão) - arquivo salvo e acessível via link
- Base64 - conteúdo codificado em string
- Ambos - URL + Base64
- Nenhum - apenas processa (ex: transcrição)
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
required
ID da mensagem contendo o arquivo.
Exemplo:
Exemplo:
7EB0F01D7244B421048F0706368376E0boolean
Se verdadeiro, retorna o conteúdo em base64.
Padrão:
Exemplo:
Padrão:
false Exemplo:
trueboolean
Para áudios, define formato de retorno.
true: Retorna MP3false: Retorna OGG
Padrão:true
Exemplo:true
boolean
Salva e retorna URL pública do arquivo.
Padrão:
Exemplo:
Padrão:
true Exemplo:
trueboolean
Baixa mídia da mensagem citada ao invés da mensagem principal.
Útil para baixar conteúdo original de status do WhatsApp.
Padrão:
Exemplo:
Útil para baixar conteúdo original de status do WhatsApp.
Padrão:
false Exemplo:
truestring
Chave da API OpenAI para transcrição áudios para texto.
Exemplo:
Exemplo:
sk-proj-...Comportamento padrão: - Áudios são retornados como MP3 - Downloads incluem
URL pública do arquivo - Transcrição requer chave OpenAI configurada
curl -X POST https://zapclass.com.br/api/messages/download \
-H "Content-Type: application/json" \
-H "Authorization: Bearer zc_6FrX2qjM4bHT9pR6cC0sD8wLkG3nE2tZfV5uN1aP" \
-d '{
"id": "7EB0F01D7244B421048F0706368376E0",
"mp3": true,
"base64": true,
"link": true,
"quoted": true,
"openai_api_key": "sk-proj-..."
}'
const response = await fetch("https://zapclass.com.br/api/messages/download", {
method: "POST",
headers: {
"Content-Type": "application/json",
Authorization: "Bearer zc_6FrX2qjM4bHT9pR6cC0sD8wLkG3nE2tZfV5uN1aP",
},
body: JSON.stringify({
id: "7EB0F01D7244B421048F0706368376E0",
mp3: true,
base64: true,
link: true,
quoted: true,
openai_api_key: "sk-proj-...",
}),
});
<?php
$ch = curl_init('https://zapclass.com.br/api/messages/download');
$payload = [
"id" => "7EB0F01D7244B421048F0706368376E0",
"mp3" => true,
"base64" => true,
"link" => true,
"quoted" => true,
"openai_api_key" => "sk-proj-...",
];
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);
$response = curl_exec($ch);
$data = json_decode($response, true);
echo "URL do arquivo: " . $data['fileURL'];
curl_close($ch);
?>
{
"url": "https://api.exemplo.com/files/arquivo.mp3",
"base64": "base64encodedstring",
"mimetype": "audio/mpeg",
"transcription": "Olá, gostaria de saber mais informações sobre o produto que você postou no status"
}
{
"success": false,
"message": "Token de autenticação inválido"
}
⌘I