WhatsApp · Mídia — API Zyron Connect Suite

Módulo

WhatsApp · Mídia

Fluxo completo de arquivo: envie para a Meta, use o media_id em uma mensagem, consulte metadados e baixe mídia recebida sem expor o token da conexão.

POSTEnviar arquivo/media GETMetadados da mídia/media/:id GETBaixar mídia/media/:id/download DELETERemover mídia/media/:id

POST/mediaEscopo: writeOficial (Meta)Requer plano Oficial ou Agency

Faz upload de arquivo para a Meta.

Envie multipart/form-data com connection_id e file. A resposta contém media_id para usar em POST /messages.

Parâmetros de caminho

Sem parâmetros adicionais.

Parâmetros de query

Sem parâmetros adicionais.

Campos do corpo

Campo	Tipo	Descrição
`connection_id`obrigatório	uuid \| phone	Conexão Oficial dona do arquivo: UUID ou o número da instância. Também aceito como from.
`file`obrigatório	binary	Arquivo até 100 MB. O limite final também depende do formato aceito pela Meta.

Exemplos prontos

curl -X POST "https://connect.zyronstack.com/api/v1/media" \
  -H "Authorization: Bearer SUA_CHAVE_API" \
  -F "connection_id=<CONNECTION_ID>" \
  -F "file=@/CAMINHO/arquivo.pdf"

Respostas

201	Upload concluído; use data.id como media.id.

GET/media/:idEscopo: readOficial (Meta)Requer plano Oficial ou Agency

Consulta metadados e rota de download.

Use o media_id do payload da mensagem. A resposta devolve mime_type, tamanho, hash e uma download_url autenticada do Zyron.

Parâmetros de caminho

Campo	Tipo	Descrição
`id`obrigatório	string	media_id da Meta.

Parâmetros de query

Campo	Tipo	Descrição
`connection_id`obrigatório	uuid	Conexão dona da mídia.

Campos do corpo

Este endpoint não recebe corpo JSON.

Exemplos prontos

curl -X GET "https://connect.zyronstack.com/api/v1/media/<MEDIA_ID>?connection_id=<CONNECTION_ID>" \
  -H "Authorization: Bearer SUA_CHAVE_API"

Respostas

200	Metadados retornados.

Exemplo de resposta

{
  "data": {
    "id": "<MEDIA_ID>",
    "mime_type": "image/jpeg",
    "file_size": "303833",
    "download_url": "https://connect.zyronstack.com/api/v1/media/<MEDIA_ID>/download?connection_id=<CONNECTION_ID>",
    "download_requires_authorization": true
  }
}

GET/media/:id/downloadEscopo: readOficial (Meta)Requer plano Oficial ou Agency

Baixa o arquivo recebido ou enviado.

Use a mesma chave Bearer; a API transmite o binário e nunca devolve o token Meta. Funciona para image, audio, video, document e sticker oficiais.

Parâmetros de caminho

Campo	Tipo	Descrição
`id`obrigatório	string	media_id da Meta.

Parâmetros de query

Campo	Tipo	Descrição
`connection_id`obrigatório	uuid	Conexão dona da mídia.

Campos do corpo

Este endpoint não recebe corpo JSON.

Exemplos prontos

curl -X GET "https://connect.zyronstack.com/api/v1/media/<MEDIA_ID>/download?connection_id=<CONNECTION_ID>" \
  -H "Authorization: Bearer SUA_CHAVE_API"

Respostas

200	Binário da mídia no content-type original.

DELETE/media/:idEscopo: writeOficial (Meta)Requer plano Oficial ou Agency

Remove mídia armazenada na Meta.

Remova somente mídias que não serão mais usadas por mensagens ou automações.

Parâmetros de caminho

Campo	Tipo	Descrição
`id`obrigatório	string	media_id da Meta.

Parâmetros de query

Campo	Tipo	Descrição
`connection_id`obrigatório	uuid	Conexão dona da mídia.

Campos do corpo

Este endpoint não recebe corpo JSON.

Exemplos prontos

curl -X DELETE "https://connect.zyronstack.com/api/v1/media/<MEDIA_ID>?connection_id=<CONNECTION_ID>" \
  -H "Authorization: Bearer SUA_CHAVE_API"

Respostas

200	Mídia removida.