megaAPI Plan Code
HomemegaAPI
Painel de Acesso
  • Entrar
HomemegaAPI
Painel de Acesso
  • Entrar
  1. InstanceController
  • Introdução à megaAPI
  • Componente n8n megaAPI
  • InstanceController
    • Instâncias
    • Status da Conexão
      GET
    • Download arquivos
      POST
    • Número com whatsapp?
      GET
    • Qrcode Imagem
      GET
    • Qrcode Base64
      GET
    • Conexão via código
      GET
    • Desconectar Whatsapp
      DELETE
    • Reiniciar uma Conexão
      DELETE
  • WebhookController
    • Exemplos dos retorno do webhook megaAPI
    • Dados do webhook
      GET
    • Configurar Webhook
      POST
  • SendMessageController
    • Envio de Mensagens de Texto
      POST
    • Envio de arquivos (URL)
      POST
    • Envio de arquivos (BASE64)
      POST
    • Envio de localização
      POST
    • Envio link com pré vizualização
      POST
    • Envio de lista de opções
      POST
    • Envio de botões interativos
      POST
    • Envio de templates interativos
      POST
    • Reencaminhar mensagem
      POST
    • Responder mensagem
      POST
  • ConfigController
    • Detalhes de configurações
      GET
    • Alterar token
      POST
    • Bloquear eventos
      POST
    • Adicionar Evento Webhook
      POST
    • Adicionar Evento Status
      POST
  • ChatController
    • Digitando - Gravando Áudio - Online
    • Deletar mensagem
    • deleteMessageFromMe
  • GroupController
    • Listar todos os grupos
    • Detalhe do grupo
    • Criar grupo
    • Enviar mensagem de texto para grupo
    • Enviar arquivo para grupo (URL)
    • Enviar arquivo para grupo (BASE64)
    • Adicionar participantes no grupo
    • Remover participantes do grupo
    • Sair do Grupo
  1. InstanceController

Download arquivos

POST
https://apinocode01.megaapi.com.br/rest/instance/downloadMediaMessage/{{instance_key}}

Download dos arquivos de mídias#

Este endpoint é destinado ao download de arquivos de mídia recebidos através do webhook do WhatsApp. Os arquivos são criptografados e necessitam de várias chaves, como mediaKey, directPath, url, e mimetype, para serem descriptografados e acessados. A requisição deve ser do tipo POST e contém um corpo de dados específico.

Fique atento!#

Independentemente do tipo de mensagem enviado (áudio, vídeo, documento, sticker, entre outros), utilize um dos valores listados abaixo para preencher o campo messageType no corpo da requisição. Lembre-se de não utilizar o messageType retornado pelo webhook.

messageType#

AtributoTipoDescrição
messageTypestringaudio - video - document - image

🤔 Aonde encontro essas informações no meu webhook?#

Abaixo, temos um exemplo de um payload de uma mensagem recebida do tipo audio. Marcamos na imagem as quatro informações necessárias para serem enviadas, no body da requisição

Exemplo de mensagem tipo audio
Exemplo de mensagem tipo audio

Requisição

Authorization
Forneça seu token bearer no cabeçalho
Authorization
ao fazer requisições para recursos protegidos.
Exemplo:
Authorization: Bearer ********************
Parâmetros Header
Content-Type
string 
opcional
Exemplo:
application/json
Authorization
string 
requerido
Exemplo:
Bearer {{token}}
Parâmetros Bodyapplication/json
messageKeys
object 
requerido
mediaKey
string 
requerido
Key retornado pelo Whatsapp
directPath
string 
requerido
Path retornado pelo Whatsapp
url
string 
requerido
URL retornado pelo Whatsapp
mimetype
string 
requerido
MineType retornado pelo Whatsapp
messageType
string 
requerido
image, document, audio, video
Exemplo
{
  "messageKeys": {
    "mediaKey": "+Ku4+ZNXTMY04YnRMwcTIQ9ntXKvcCoLti16gYmsC54=",
    "directPath": "/v/t62.7118-24/381557134_1127517275638751_4987059405792964531_n.enc?ccb=11-4&oh=01_Q5AaIOEZycGwTrJydm0OF6cQtvevAeBoPMyBL5EK09um1Yk7&oe=676D39DD&_nc_sid=5e03e0",
    "url": "https://mmg.whatsapp.net/v/t62.7118-24/381557134_1127517275638751_4987059405792964531_n.enc?ccb=11-4&oh=01_Q5AaIOEZycGwTrJydm0OF6cQtvevAeBoPMyBL5EK09um1Yk7&oe=676D39DD&_nc_sid=5e03e0&mms3=true",
    "mimetype": "image/jpeg",
    "messageType": "image"
  }
}

Exemplos de Requisição

Shell
JavaScript
Java
Swift
Go
PHP
Python
HTTP
C
C#
Objective-C
Ruby
OCaml
Dart
R
Request Request Example
Shell
JavaScript
Java
Swift
curl --location -g --request POST 'https://apinocode01.megaapi.com.br/rest/instance/downloadMediaMessage/sua instance_key' \
--header 'Authorization: Bearer seu token' \
--header 'Content-Type: application/json' \
--data-raw '{
    "messageKeys": {
        "mediaKey": "+Ku4+ZNXTMY04YnRMwcTIQ9ntXKvcCoLti16gYmsC54=",
        "directPath": "/v/t62.7118-24/381557134_1127517275638751_4987059405792964531_n.enc?ccb=11-4&oh=01_Q5AaIOEZycGwTrJydm0OF6cQtvevAeBoPMyBL5EK09um1Yk7&oe=676D39DD&_nc_sid=5e03e0",
        "url": "https://mmg.whatsapp.net/v/t62.7118-24/381557134_1127517275638751_4987059405792964531_n.enc?ccb=11-4&oh=01_Q5AaIOEZycGwTrJydm0OF6cQtvevAeBoPMyBL5EK09um1Yk7&oe=676D39DD&_nc_sid=5e03e0&mms3=true",
        "mimetype": "image/jpeg",
        "messageType": "image"
    }
}'

Respostas

🟢200Error
application/json
Body
error
boolean 
requerido
Status Error
name
string 
requerido
Name Error
message
string 
requerido
Message
statusCode
integer 
requerido
Status code
Exemplo
{
  "error": true,
  "name": "string",
  "message": "string",
  "statusCode": 0
}
🟢200Success
🟢200Error
Página anterior
Status da Conexão
Próxima página
Número com whatsapp?
Built with