Primeros pasos

Módulo

WhatsApp · Multimedia

Flujo completo de archivo: carga, envía, consulta y descarga medios.

POST/mediaGET/media/:idGET/media/:id/downloadDELETE/media/:id
POST/mediaAlcance: writeOficial (Meta)Requiere plan Oficial o Agency

Sube archivo a Meta.

Envía multipart con connection_id y file.

Parámetros de ruta

Sin parámetros adicionales.

Parámetros de query

Sin parámetros adicionales.

Campos del cuerpo
CampoTipoDescripción
connection_idobligatoriouuidConexión Oficial dueña del archivo.
fileobligatoriobinaryArchivo hasta 100 MB.

Ejemplos listos

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"

Respuestas

201Upload terminado; usa data.id.
GET/media/:idAlcance: readOficial (Meta)Requiere plan Oficial o Agency

Consulta metadatos y ruta de descarga.

Usa media_id del payload.

Parámetros de ruta
CampoTipoDescripción
idobligatoriostringmedia_id de Meta.
Parámetros de query
CampoTipoDescripción
connection_idobligatoriouuidConexión dueña.

Campos del cuerpo

Este endpoint no recibe cuerpo JSON.

Ejemplos listos

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

Respuestas

200Metadatos devueltos.

Ejemplo de respuesta

{
  "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/downloadAlcance: readOficial (Meta)Requiere plan Oficial o Agency

Descarga archivo recibido o enviado.

Usa la misma clave Bearer; la API transmite binario.

Parámetros de ruta
CampoTipoDescripción
idobligatoriostringmedia_id de Meta.
Parámetros de query
CampoTipoDescripción
connection_idobligatoriouuidConexión dueña.

Campos del cuerpo

Este endpoint no recibe cuerpo JSON.

Ejemplos listos

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

Respuestas

200Binario en content-type original.
DELETE/media/:idAlcance: writeOficial (Meta)Requiere plan Oficial o Agency

Elimina medio de Meta.

Elimina solo medios sin uso.

Parámetros de ruta
CampoTipoDescripción
idobligatoriostringmedia_id de Meta.
Parámetros de query
CampoTipoDescripción
connection_idobligatoriouuidConexión dueña.

Campos del cuerpo

Este endpoint no recibe cuerpo JSON.

Ejemplos listos

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

Respuestas

200Medio eliminado.