NODAPI

Ações na mensagem e Buscar

Baixar arquivo de uma mensagem

POST/message/download

Autenticação: envie a chave da conexão no header token ou em Authorization: Bearer.

Baixa o arquivo associado a uma mensagem de mídia (imagem, vídeo, áudio, documento ou sticker).

Parâmetros

  • id (string, obrigatório): ID da mensagem
  • return_base64 (boolean, default: false): Retorna arquivo em base64
  • generate_mp3 (boolean, default: true): Para áudios, define formato de retorno
  • true: Retorna MP3
  • false: Retorna OGG
  • return_link (boolean, default: true): Retorna URL pública do arquivo
  • transcribe (boolean, default: false): Transcreve áudios para texto
  • openai_apikey (string, opcional): Chave OpenAI para transcrição
  • Se não informada, usa a chave salva na instância
  • Se informada, atualiza e salva na instância para próximas chamadas
  • download_quoted (boolean, default: false): Baixa mídia da mensagem citada
  • Útil para baixar conteúdo original de status do WhatsApp
  • Quando uma mensagem é resposta a um status, permite baixar a mídia do status original
  • Contextualização: Ao baixar a mídia citada, você identifica o contexto da conversa
  • Exemplo: Se alguém responde a uma promoção, baixando a mídia você saberá que a pergunta é sobre aquela promoção específica

Exemplos

Baixar áudio como MP3:

{
  "id": "7EB0F01D7244B421048F0706368376E0",
  "generate_mp3": true
}

Transcrever áudio:

{
  "id": "7EB0F01D7244B421048F0706368376E0",
  "transcribe": true
}

Apenas base64 (sem salvar):

{
  "id": "7EB0F01D7244B421048F0706368376E0",
  "return_base64": true,
  "return_link": false
}

Baixar mídia de status (mensagem citada):

{
  "id": "7EB0F01D7244B421048F0706368376E0",
  "download_quoted": true
}

*Útil quando o cliente responde a uma promoção/status - você baixa a mídia original para entender sobre qual produto/oferta ele está perguntando.*

Resposta

{
  "fileURL": "https://api.exemplo.com/files/arquivo.mp3",
  "mimetype": "audio/mpeg",
  "base64Data": "UklGRkj...",
  "transcription": "Texto transcrito"
}

Nota:

  • Por padrão, se não definido o contrário:
  1. áudios são retornados como MP3.
  2. E todos os pedidos de download são retornados com URL pública.
  • Transcrição requer chave OpenAI válida. A chave pode ser configurada uma vez na instância e será reutilizada automaticamente.
  • Retenção de mídia: mantemos as mídias no nosso storage por 2 dias. Após 2 dias, elas são removidas na limpeza automática e o link retornado deixa de ficar disponível. Para voltar a disponibilizar a mídia, é necessário refazer o download pelo endpoint. Se o cliente solicitar novamente, a mídia será baixada do CDN da Meta, o que pode aumentar o tempo de resposta. Enquanto estiver no nosso storage, a resposta tende a ser mais rápida.

Corpo da requisição (JSON)

CampoTipoDescrição
id*string

ID da mensagem contendo o arquivo

Exemplo: 7EB0F01D7244B421048F0706368376E0

return_base64boolean

Se verdadeiro, retorna o conteúdo em base64

Exemplo: false

generate_mp3boolean

Para áudios, define formato de retorno (true=MP3, false=OGG)

Exemplo: true

return_linkboolean

Salva e retorna URL pública do arquivo

Exemplo: true

transcribeboolean

Se verdadeiro, transcreve áudios para texto

Exemplo: false

openai_apikeystring

Chave da API OpenAI para transcrição (opcional)

Exemplo: sk-...

download_quotedboolean

Se verdadeiro, baixa mídia da mensagem citada ao invés da mensagem principal

Exemplo: false

* obrigatório

Respostas

  • 200Successful file download
  • 400Bad Request
  • 401Unauthorized
  • 404Not Found
  • 500Internal Server Error

Experimente

Atenção: a chamada é real. Ela roda na sua conexão e pode enviar mensagem de verdade. A chave fica só nesta tela e some ao sair dela; nunca é guardada.

Cole a chave gerada no painel.