> ## Documentation Index
> Fetch the complete documentation index at: https://gowa-docs.mintlify.site/llms.txt
> Use this file to discover all available pages before exploring further.

# Descargar medios del mensaje

> Descargar contenido multimedia (imagen, video, audio, documento) de un mensaje



## OpenAPI

````yaml /es/openapi.yml get /message/{message_id}/download
openapi: 3.0.0
info:
  title: Multidispositivo API de WhatsApp
  version: 9.7.0
  description: >
    Esta API se utiliza para enviar whatsapp a través de API.


    El panel web es un proyecto separado (gowa-ui); el servidor descarga su
    último recurso de versión

    y lo sirve en `/` (o devuelve un banner JSON cuando

    APP_UI_ENABLED=false).


    Ámbito del dispositivo:

    - Envía `X-Device-Id` en todas las llamadas REST con ámbito dispositivo.

    - WebSocket: conectar a `/ws?device_id=<id>`.

    - WebSocket auth (cuando la autenticación básica está habilitada): los
    navegadores no pueden establecer un encabezado
      de autorización en conexiones WebSocket, así que también pase
      `&authorization=<base64(user:pass)>` en la cadena de consulta. Usa TLS en producciónformat@@0
      ya que la credencial es visible en la URL.
servers:
  - url: http://localhost:3000
security:
  - basicAuth: []
tags:
  - name: app
    description: Conexión inicial al servidor de Whatsapp
  - name: device
    description: Gestión de dispositivos para soporte multidispositivo
  - name: user
    description: Obteniendo información
  - name: send
    description: Enviar mensaje (Texto/Imágen/Archivo/Video).
  - name: message
    description: Manipulación de mensajes (revocar/react/actualizar).
  - name: call
    description: Gestión de llamadas (rechazar llamadas entrantes)
  - name: chat
    description: Chats de chat y mensajería
  - name: group
    description: Ajuste de grupo
  - name: newsletter
    description: configuración del boletín de noticias
  - name: chatwoot
    description: Integración de Chatwoot para soporte al cliente
paths:
  /message/{message_id}/download:
    get:
      tags:
        - message
      summary: Descargar medios del mensaje
      description: >-
        Descargar contenido multimedia (imagen, video, audio, documento) de un
        mensaje
      operationId: downloadMessageMedia
      parameters:
        - $ref: '#/components/parameters/DeviceIdHeader'
        - in: path
          name: message_id
          schema:
            type: string
          required: true
          description: ID del mensaje
          example: 3EB0123456789ABCDEF
        - in: query
          name: phone
          schema:
            type: string
          required: true
          description: Número de teléfono con código de país
          example: 6289685028129@s.whatsapp.net
      responses:
        '200':
          description: Ok
          content:
            application/json:
              schema:
                type: object
                properties:
                  status:
                    type: integer
                    example: 200
                  code:
                    type: string
                    example: SUCCESS
                  message:
                    type: string
                    example: Media downloaded successfully
                  results:
                    type: object
                    properties:
                      status:
                        type: string
                        example: Media downloaded successfully
                      message_id:
                        type: string
                        example: 3EB0ABC123456789
                      media_type:
                        type: string
                        example: audio
                      filename:
                        type: string
                        example: audio.ogg
                      file_path:
                        type: string
                        description: >-
                          Ruta del archivo del servidor local donde se guardó el
                          medio
                        example: statics/media/6289685028129/2026-06-09/audio.ogg
                      file_url:
                        type: string
                        description: >-
                          URL pública para descargar el medio guardado cuando se
                          almacena en el directorio estático servido
                        example: >-
                          http://localhost:3000/statics/media/6289685028129/2026-06-09/audio.ogg
                      file_size:
                        type: integer
                        example: 524288
        '400':
          description: Solicitud incorrecta
          content:
            application/json:
              schema:
                $ref: '#/components/schemas/ErrorBadRequest'
        '404':
          description: Mensaje o medio no encontrado
          content:
            application/json:
              schema:
                $ref: '#/components/schemas/ErrorNotFound'
        '500':
          description: Error interno del servidor
          content:
            application/json:
              schema:
                $ref: '#/components/schemas/ErrorInternalServer'
components:
  parameters:
    DeviceIdHeader:
      name: X-Device-Id
      in: header
      required: false
      description: >
        Identificador de dispositivo para soporte multidispositivo. Requerido
        cuando se registran múltiples dispositivos.

        Si sólo se registra un dispositivo, se utilizará como el valor
        predeterminado.

        También se puede proporcionar como parámetro de consulta `device_id`.
      schema:
        type: string
        example: my-device-id
  schemas:
    ErrorBadRequest:
      type: object
      properties:
        code:
          type: string
          example: 400
          description: Código de estado HTTP
        message:
          type: string
          example: field cannot be blank
          description: Mensaje de error detallado
        results:
          type: object
          example: null
          description: datos adicionales
    ErrorNotFound:
      type: object
      properties:
        code:
          type: string
          example: 404
          description: Código de estado HTTP
        message:
          type: string
          example: Chat not found
          description: Mensaje de error detallado
        results:
          type: object
          example: null
          description: datos adicionales
    ErrorInternalServer:
      type: object
      properties:
        code:
          type: string
          example: INTERNAL_SERVER_ERROR
          description: Error
        message:
          type: string
          example: you are not loggin
          description: Mensaje de error detallado
        results:
          type: object
          example: null
          description: datos adicionales
  securitySchemes:
    basicAuth:
      type: http
      scheme: basic

````

## Related topics

- [Descargar medios de un mensaje de boletín de noticias](https://gowa-docs.mintlify.site/es/api-reference/newsletter/descargar-medios-de-un-mensaje-de-boletín-de-noticias.md)
- [Canales de WhatsApp](https://gowa-docs.mintlify.site/es/examples/newsletters.md)
- [Reenviar mensaje](https://gowa-docs.mintlify.site/es/api-reference/message/reenviar-mensaje.md)
- [Referencia API](https://gowa-docs.mintlify.site/es/api-reference/introduction.md)
- [Manejo de medios](https://gowa-docs.mintlify.site/es/examples/media-handling.md)


This documentation is built and hosted on [Mintlify](https://mintlify.com), a developer documentation platform.