> ## 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 de un mensaje de boletín de noticias

> Obtiene un mensaje del boletín de noticias directamente desde WhatsApp por ID del servidor,
descarga sus archivos multimedia al directorio estático del servidor, y devuelve los metadatos de archivo guardados
y la URL pública. Los tipos de medios soportados son imágenes,
vídeos, notas de vídeo, audio, documentos y pegatinas.




## OpenAPI

````yaml /es/openapi.yml get /newsletter/messages/{server_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:
  /newsletter/messages/{server_id}/download:
    get:
      tags:
        - newsletter
      summary: Descargar medios de un mensaje de boletín de noticias
      description: >
        Obtiene un mensaje del boletín de noticias directamente desde WhatsApp
        por ID del servidor,

        descarga sus archivos multimedia al directorio estático del servidor, y
        devuelve los metadatos de archivo guardados

        y la URL pública. Los tipos de medios soportados son imágenes,

        vídeos, notas de vídeo, audio, documentos y pegatinas.
      operationId: downloadNewsletterMessageMedia
      parameters:
        - $ref: '#/components/parameters/DeviceIdHeader'
        - name: server_id
          in: path
          required: true
          description: >-
            ID del servidor del boletín de noticias devuelto por GET
            /newsletter/messages
          schema:
            type: integer
            minimum: 1
          example: 8872
        - name: newsletter_id
          in: query
          required: true
          description: JID del boletín de noticias que contiene el mensaje
          schema:
            type: string
          example: 120363024512399999@newsletter
      responses:
        '200':
          description: Medios descargados con éxito
          content:
            application/json:
              schema:
                $ref: '#/components/schemas/NewsletterMediaDownloadResponse'
        '400':
          description: Solicitud incorrecta
          content:
            application/json:
              schema:
                $ref: '#/components/schemas/ErrorBadRequest'
        '500':
          description: Error al buscar mensajes o descargar medios
          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:
    NewsletterMediaDownloadResponse:
      type: object
      properties:
        status:
          type: integer
          example: 200
        code:
          type: string
          example: SUCCESS
        message:
          type: string
          example: Media downloaded successfully
        results:
          type: object
          properties:
            server_id:
              type: integer
              example: 8872
            message_id:
              type: string
              example: ACBD7F85529AAD63FAF376F622351D14
            status:
              type: string
              example: >-
                Media downloaded successfully to
                statics/media/120363024512399999/2026-08-28/image.jpg
            media_type:
              type: string
              enum:
                - image
                - video
                - video_note
                - audio
                - document
                - sticker
              example: image
            mime_type:
              type: string
              example: image/jpeg
            filename:
              type: string
              example: image.jpg
            file_path:
              type: string
              description: Ruta del servidor local donde se guardó el medio descargado
              example: statics/media/120363024512399999/2026-08-28/image.jpg
            file_url:
              type: string
              description: URL pública para el archivo de medios guardado
              example: >-
                http://localhost:3000/statics/media/120363024512399999/2026-08-28/image.jpg
            file_size:
              type: integer
              format: int64
              example: 524288
    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
    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

- [Obtener contadores de mensajes del boletín de noticias](https://gowa-docs.mintlify.site/es/api-reference/newsletter/obtener-contadores-de-mensajes-del-boletín-de-noticias.md)
- [Obtener los últimos mensajes del boletín de noticias (canal)](https://gowa-docs.mintlify.site/es/api-reference/newsletter/obtener-los-últimos-mensajes-del-boletín-de-noticias-canal.md)
- [Obtener metadatos del boletín de noticias (canal)](https://gowa-docs.mintlify.site/es/api-reference/newsletter/obtener-metadatos-del-boletín-de-noticias-canal.md)
- [Obtener mensajes de un chat específico](https://gowa-docs.mintlify.site/es/api-reference/chat/obtener-mensajes-de-un-chat-específico.md)
- [Marcar un mensaje de audio como reproducido](https://gowa-docs.mintlify.site/es/api-reference/message/marcar-un-mensaje-de-audio-como-reproducido.md)


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