Download arquivos

POST

/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.

🤔 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

Request

Authorization

Provide your bearer token in the

Authorization

header when making requests to protected resources.

Example:

Authorization: Bearer ********************

Header Params

Body Params application/json

Example

{
    "messageKeys": {
        "mediaKey": "309GwkbNs+hvIl+oGYHVIEa+eWGFvYbhwhPrrTQ+P40=",
        "directPath": "/v/t62.7118-24/33508108_425320909632029_855316559690107593_n.enc?ccb=11-4&oh=01_AVwsxssXNsJd8unW7UogNLzFkvWXWQAD18uu1fcMG56mrQ&oe=62FB2248",
        "url": "https://mmg.whatsapp.net/v/t62.7117-24/29574318_6036841743076666_3009887773264574325_n.enc?ccb=11-4&oh=01_AdScv9HQNKy4od39pDdDZjVh_RXfcX3vr94CPXhWKvuBBg&oe=6425B5F7&mms3=true",
        "mimetype": "image/jpeg",
        "messageType": "image"
    }
}

Request Code Samples

Shell

JavaScript

Java

Swift

PHP

Python

HTTP

Objective-C

Ruby

OCaml

Dart

curl --location -g --request POST '/rest/instance/downloadMediaMessage/{{instance_key}}' \
--header 'Authorization: Bearer <token>' \
--header 'Content-Type: application/json' \
--data-raw '{
    "messageKeys": {
        "mediaKey": "309GwkbNs+hvIl+oGYHVIEa+eWGFvYbhwhPrrTQ+P40=",
        "directPath": "/v/t62.7118-24/33508108_425320909632029_855316559690107593_n.enc?ccb=11-4&oh=01_AVwsxssXNsJd8unW7UogNLzFkvWXWQAD18uu1fcMG56mrQ&oe=62FB2248",
        "url": "https://mmg.whatsapp.net/v/t62.7117-24/29574318_6036841743076666_3009887773264574325_n.enc?ccb=11-4&oh=01_AdScv9HQNKy4od39pDdDZjVh_RXfcX3vr94CPXhWKvuBBg&oe=6425B5F7&mms3=true",
        "mimetype": "image/jpeg",
        "messageType": "image"
    }
}'

Responses

🟢200Error

application/json

Body

Example

{
    "error": true,
    "name": "string",
    "message": "string",
    "statusCode": 0
}

Reiniciar uma Conexão

Exemplos dos retorno do webhook megaAPI