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

# Unduh media dari pesan newsletter

> Mengambil satu pesan newsletter langsung dari WhatsApp berdasarkan ID server,
mengunduh medianya ke direktori statics server, dan mengembalikan
metadata file yang disimpan beserta URL publiknya. Jenis media yang didukung adalah gambar,
video, catatan video, audio, dokumen, dan stiker.




## OpenAPI

````yaml /id/openapi.yml get /newsletter/messages/{server_id}/download
openapi: 3.0.0
info:
  title: WhatsApp API MultiDevice
  version: 9.7.0
  description: >
    API ini digunakan untuk mengirim pesan WhatsApp melalui API.


    Dashboard web merupakan proyek terpisah (gowa-ui); server mengunduh aset
    rilis

    terbarunya dan menyajikannya di `/` (atau mengembalikan banner JSON saat

    APP_UI_ENABLED=false).


    Cakupan perangkat:

    - Kirim `X-Device-Id` pada semua panggilan REST yang memiliki cakupan
    perangkat.

    - WebSocket: hubungkan ke `/ws?device_id=<id>`.

    - Autentikasi WebSocket (saat autentikasi dasar diaktifkan): browser tidak
    dapat menyetel
      header Authorization pada koneksi WebSocket, sehingga sertakan juga
      `&authorization=<base64(user:pass)>` dalam query string. Gunakan TLS di
      produksi karena kredensial terlihat di URL.
servers:
  - url: http://localhost:3000
security:
  - basicAuth: []
tags:
  - name: app
    description: Koneksi awal ke server WhatsApp
  - name: device
    description: Pengelolaan perangkat untuk dukungan multi-perangkat
  - name: user
    description: Mengambil informasi
  - name: send
    description: Kirim pesan (teks/gambar/berkas/video).
  - name: message
    description: Manipulasi pesan (cabut/beri reaksi/perbarui).
  - name: call
    description: Pengelolaan panggilan (tolak panggilan masuk)
  - name: chat
    description: Percakapan chat dan perpesanan
  - name: group
    description: Pengaturan grup
  - name: newsletter
    description: Pengaturan newsletter
  - name: chatwoot
    description: Integrasi Chatwoot untuk dukungan pelanggan
paths:
  /newsletter/messages/{server_id}/download:
    get:
      tags:
        - newsletter
      summary: Unduh media dari pesan newsletter
      description: >
        Mengambil satu pesan newsletter langsung dari WhatsApp berdasarkan ID
        server,

        mengunduh medianya ke direktori statics server, dan mengembalikan

        metadata file yang disimpan beserta URL publiknya. Jenis media yang
        didukung adalah gambar,

        video, catatan video, audio, dokumen, dan stiker.
      operationId: downloadNewsletterMessageMedia
      parameters:
        - $ref: '#/components/parameters/DeviceIdHeader'
        - name: server_id
          in: path
          required: true
          description: >-
            ID server pesan newsletter yang dikembalikan oleh GET
            /newsletter/messages
          schema:
            type: integer
            minimum: 1
          example: 8872
        - name: newsletter_id
          in: query
          required: true
          description: JID newsletter yang berisi pesan
          schema:
            type: string
          example: 120363024512399999@newsletter
      responses:
        '200':
          description: Media berhasil diunduh
          content:
            application/json:
              schema:
                $ref: '#/components/schemas/NewsletterMediaDownloadResponse'
        '400':
          description: Permintaan Tidak Valid
          content:
            application/json:
              schema:
                $ref: '#/components/schemas/ErrorBadRequest'
        '500':
          description: Pencarian pesan atau pengunduhan media gagal
          content:
            application/json:
              schema:
                $ref: '#/components/schemas/ErrorInternalServer'
components:
  parameters:
    DeviceIdHeader:
      name: X-Device-Id
      in: header
      required: false
      description: >
        Pengenal perangkat untuk dukungan multi-device. Wajib jika beberapa
        perangkat terdaftar.

        Jika hanya satu perangkat terdaftar, perangkat tersebut digunakan
        sebagai default.

        Dapat juga diberikan sebagai parameter kueri `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: Path lokal server tempat media yang diunduh disimpan
              example: statics/media/120363024512399999/2026-08-28/image.jpg
            file_url:
              type: string
              description: URL publik untuk file media yang disimpan
              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: Kode Status HTTP
        message:
          type: string
          example: field cannot be blank
          description: Pesan kesalahan terperinci
        results:
          type: object
          example: null
          description: data tambahan
    ErrorInternalServer:
      type: object
      properties:
        code:
          type: string
          example: INTERNAL_SERVER_ERROR
          description: SYSTEM_CODE_ERROR
        message:
          type: string
          example: you are not loggin
          description: Pesan kesalahan terperinci
        results:
          type: object
          example: null
          description: data tambahan
  securitySchemes:
    basicAuth:
      type: http
      scheme: basic

````

## Related topics

- [Unduh media dari pesan](https://gowa-docs.mintlify.site/id/api-reference/message/unduh-media-dari-pesan.md)
- [Penanganan Media](https://gowa-docs.mintlify.site/id/examples/media-handling.md)
- [Menerima pesan](https://gowa-docs.mintlify.site/id/examples/receiving-messages.md)
- [Dapatkan penghitung pesan newsletter](https://gowa-docs.mintlify.site/id/api-reference/newsletter/dapatkan-penghitung-pesan-newsletter.md)
- [Dapatkan pesan newsletter (saluran) terbaru](https://gowa-docs.mintlify.site/id/api-reference/newsletter/dapatkan-pesan-newsletter-saluran-terbaru.md)


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