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

# تحميل الوسائط من رسالة النشرة الإخبارية

> جلب رسالة إخبارية واحدة مباشرة من WhatsApp بواسطة معرف الخادم،
يقوم بتنزيل الوسائط الخاصة به إلى دليل الخادم الثابت، وإرجاع البيانات الوصفية للملف
المحفوظة والربط العام. أنواع الوسائط المدعومة هي الصور،
الفيديو، ملاحظات الفيديو، الصوت والوثائق والملصقات.




## OpenAPI

````yaml /ar/openapi.yml get /newsletter/messages/{server_id}/download
openapi: 3.0.0
info:
  title: واتسآب API متعدد الأجهزة
  version: 9.7.0
  description: >
    يتم استخدام هذا API لإرسال أي تطبيق عبر API.


    لوحة المعلومات هي مشروع منفصل (gowa-ui)؛ يقوم الخادم بتنزيل أحدث أصول
    الإصدار

    ويخدمه في `/` (أو يرجع لافتة JSON عندما

    APP_UI_ENABLED=false).


    تحديد الجهاز:

    - إرسال `X-Device-Id` على جميع مكالمات REST على نطاق الجهاز.

    - WebSocket: الاتصال بـ `/w?جهاز_id=<id>`.

    - مصادقة WebSocket (عندما يتم تمكين المصادقة الأساسية): المتصفحات لا يمكن
    تعيين
      رأس التفويض على اتصالات WebSocket ، كذلك اجتاز
      `&authorization=<base64(user:pass)>` في سلسلة الاستفسار. استخدم TLS في إنتاج
      لأن بيانات الاعتماد مرئية في عنوان URL.
servers:
  - url: http://localhost:3000
security:
  - basicAuth: []
tags:
  - name: app
    description: الاتصال الأولي بخادم Whatsapp
  - name: device
    description: إدارة الجهاز لدعم الأجهزة المتعددة
  - name: user
    description: الحصول على المعلومات
  - name: send
    description: إرسال رسالة (نص/صورة/ملف/فيديو).
  - name: message
    description: التلاعب بالرسالة (إلغائ/react/update).
  - name: call
    description: إدارة المكالمات (رفض المكالمات الواردة)
  - name: chat
    description: محادثات الدردشة والرسائل
  - name: group
    description: إعداد المجموعة
  - name: newsletter
    description: إعداد النشرة الإخبارية
  - name: chatwoot
    description: تكامل Chatwoot لدعم العملاء
paths:
  /newsletter/messages/{server_id}/download:
    get:
      tags:
        - newsletter
      summary: تحميل الوسائط من رسالة النشرة الإخبارية
      description: >
        جلب رسالة إخبارية واحدة مباشرة من WhatsApp بواسطة معرف الخادم،

        يقوم بتنزيل الوسائط الخاصة به إلى دليل الخادم الثابت، وإرجاع البيانات
        الوصفية للملف

        المحفوظة والربط العام. أنواع الوسائط المدعومة هي الصور،

        الفيديو، ملاحظات الفيديو، الصوت والوثائق والملصقات.
      operationId: downloadNewsletterMessageMedia
      parameters:
        - $ref: '#/components/parameters/DeviceIdHeader'
        - name: server_id
          in: path
          required: true
          description: معرف خادم رسالة النشرة الإخبارية يرجع بواسطة GET /newsletter/message
          schema:
            type: integer
            minimum: 1
          example: 8872
        - name: newsletter_id
          in: query
          required: true
          description: النشرة الإخبارية JID التي تحتوي على الرسالة
          schema:
            type: string
          example: 120363024512399999@newsletter
      responses:
        '200':
          description: تم تنزيل الوسائط بنجاح
          content:
            application/json:
              schema:
                $ref: '#/components/schemas/NewsletterMediaDownloadResponse'
        '400':
          description: طلب خاطئ
          content:
            application/json:
              schema:
                $ref: '#/components/schemas/ErrorBadRequest'
        '500':
          description: فشل البحث عن الرسائل أو تحميل الوسائط
          content:
            application/json:
              schema:
                $ref: '#/components/schemas/ErrorInternalServer'
components:
  parameters:
    DeviceIdHeader:
      name: X-Device-Id
      in: header
      required: false
      description: |
        معرف الجهاز لدعم الأجهزة المتعددة. مطلوب عند تسجيل أجهزة متعددة.
        إذا تم تسجيل جهاز واحد فقط، فسيتم استخدامه كجهاز افتراضي.
        يمكن أيضا توفيره كعامل استعلام `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: مسار الخادم المحلي حيث تم حفظ الوسائط المحملة
              example: statics/media/120363024512399999/2026-08-28/image.jpg
            file_url:
              type: string
              description: عنوان URL العام لملف الوسائط المحفوظة
              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: رمز حالة HTTP
        message:
          type: string
          example: field cannot be blank
          description: تفاصيل رسالة الخطأ
        results:
          type: object
          example: null
          description: بيانات إضافية
    ErrorInternalServer:
      type: object
      properties:
        code:
          type: string
          example: INTERNAL_SERVER_ERROR
          description: SYSTEM_CODE_ERROR
        message:
          type: string
          example: you are not loggin
          description: تفاصيل رسالة الخطأ
        results:
          type: object
          example: null
          description: بيانات إضافية
  securitySchemes:
    basicAuth:
      type: http
      scheme: basic

````

## Related topics

- [تحميل الوسائط من الرسالة](https://gowa-docs.mintlify.site/ar/api-reference/message/تحميل-الوسائط-من-الرسالة.md)
- [الحصول على أحدث الرسائل النشرة الإخبارية (القناة)](https://gowa-docs.mintlify.site/ar/api-reference/newsletter/الحصول-على-أحدث-الرسائل-النشرة-الإخبارية-القناة.md)
- [متابعة النشرة الإخبارية](https://gowa-docs.mintlify.site/ar/api-reference/newsletter/متابعة-النشرة-الإخبارية.md)
- [إلغاء متابعة النشرة الإخبارية](https://gowa-docs.mintlify.site/ar/api-reference/newsletter/إلغاء-متابعة-النشرة-الإخبارية.md)
- [مرجع API](https://gowa-docs.mintlify.site/ar/api-reference/introduction.md)


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