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

# إرسال صورة



## OpenAPI

````yaml /ar/openapi.yml post /send/image
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:
  /send/image:
    post:
      tags:
        - send
      summary: إرسال صورة
      operationId: sendImage
      parameters:
        - $ref: '#/components/parameters/DeviceIdHeader'
      requestBody:
        content:
          multipart/form-data:
            schema:
              type: object
              allOf:
                - $ref: '#/components/schemas/ScheduleOptions'
              properties:
                phone:
                  type: string
                  example: 6289685028129@s.whatsapp.net
                  description: رقم الهاتف مع رمز البلد
                caption:
                  type: string
                  example: selamat malam
                  description: التعليق المراد إرساله
                mentions:
                  type: array
                  items:
                    type: string
                  example:
                    - '628123456789'
                    - '@everyone'
                  description: >
                    قائمة أرقام الهواتف المراد ذكرها (يذكر الشبح - لا @ مطلوبة
                    في الشرح).

                    ويشار أيضاً إلى `@phone` في الشرح. استخدم الكلمة المفتاحية
                    الخاصة "@everyone" لذكر جميع المشاركين في المجموعة.

                    أرسل حقل نموذج `mentions` واحدًا لكل إدخال.
                reply_message_id:
                  type: string
                  example: 3EB089B9D6ADD58153C561
                  description: معرف الرسالة الذي تريد الرد عليه
                view_once:
                  type: boolean
                  example: false
                  description: عرض مرة واحدة
                image:
                  type: string
                  format: binary
                  description: الصورة المراد إرسالها
                image_url:
                  type: string
                  example: https://example.com/image.jpg
                  description: رابط الصورة المراد إرسالها
                compress:
                  type: boolean
                  example: false
                  description: ضغط الصورة
                hd:
                  type: boolean
                  example: true
                  description: >-
                    إرسال صورة عالية الدقة (حدّ أقصى 2560 بكسل). تجاوز الضغط
                    عندما يكون صحيحاً.
                duration:
                  type: integer
                  example: 86400
                  description: >-
                    اختفاء مدة الرسالة في ثواني. القيم المسموح بها: صفر (بدون
                    انتهاء الصلاحية)، 400 86400 (24 ساعة)، 604800 (7 د)، 000 776
                    (90 د).
                is_forwarded:
                  type: boolean
                  example: false
                  description: ما إذا كانت هذه رسالة معاد توجيهها
                allow_reshare:
                  type: boolean
                  example: false
                  description: >-
                    إظهار زر إعادة المشاركة لمشاهدي الحالة. يشترط أن تكون قيمة
                    `phone` هي `status@broadcast`؛ ويرفض GOWA هذا الحقل لأي
                    مستلِم آخر.
      responses:
        '200':
          description: حسناً
          content:
            application/json:
              schema:
                $ref: '#/components/schemas/SendResponse'
        '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:
    ScheduleOptions:
      type: object
      description: |
        الحقول الاختيارية التي تجمل الرسالة بدلا من إرسالها الآن. تعيين
        `scheduled_at` إلى الجدول الزمني؛ بدونها يتم إرسال الرسالة فوراً.
        عامل خلفية يرسلها في الوقت المقرر، إعادة المحاولة بينما الجهاز
        غير متصل أو غير مسجل الدخول. يتم تخزين الوسائط التي تم تحميلها على خادم
        حتى ينتهي الجدول.
        في محتوى طلبات multipart/form-data، أرسل `weekdays` كحقل متكرر
        (`weekdays=1`، `weekdays=3`).
      properties:
        scheduled_at:
          type: string
          format: date-time
          example: '2026-10-01T09:00:00+07:00'
          description: >-
            RFC3339 وقت الإرسال الأول. يجب أن يكون في المستقبل. يحدث الإرسال
            الأول دائمًا في هذا الموعد، حتى إذا وقع خارج `weekdays` أو
            `day_of_month`؛ فهذان الحقلان يحددان مرات التكرار التالية.
        timezone:
          type: string
          example: Asia/Jakarta
          description: >-
            المنطقة الزمنية للوكالة الدولية للطاقة المستخدمة لحساب العمليات
            المتكررة مطلوب عند تعيين الـ scheduled_at
        recurrence:
          type: string
          enum:
            - once
            - daily
            - weekly
            - monthly
          default: once
          description: كم مرة تكرر إرسال
        weekdays:
          type: array
          items:
            type: integer
            minimum: 0
            maximum: 6
          uniqueItems: true
          example:
            - 1
            - 3
            - 5
          description: >-
            أيام الإرسال ، 0=الأحد خلال 6=يوم السبت. مطلوب عندما يكون التكرار
            أسبوعيا.
        day_of_month:
          type: integer
          minimum: 1
          maximum: 31
          example: 15
          description: >-
            يوم من الشهر الذي سيتم إرساله، ضغطت إلى اليوم الأخير من الشهر. مطلوب
            عندما يكون التكرار شهرياً.
        end_at:
          type: string
          format: date-time
          example: '2026-12-31T23:59:59+07:00'
          description: التكرار فقط. لا يرسل بعد هذا الوقت؛ يجب أن يكون بعد الموعد المحدد.
        occurrence_limit:
          type: integer
          minimum: 1
          example: 10
          description: التكرار فقط. توقف بعد هذا العديد من الإرسالات.
    SendResponse:
      type: object
      properties:
        code:
          type: string
          example: SUCCESS
        message:
          type: string
          example: Success
        results:
          type: object
          properties:
            message_id:
              type: string
              example: 3EB0B430B6F8F1D0E053AC120E0A9E5C
              description: تم إغلاقها للإرسال المجدول
            status:
              type: string
              example: <feature> success ....
            schedule_id:
              type: string
              example: 0b5c3a8e-7f5d-4d6f-9d1e-2f8c1a7b9e10
              description: المجدولة ترسل فقط. استخدمه مع مسارات / إرسال / جداول زمنية.
            scheduled_at:
              type: string
              format: date-time
              example: '2026-10-01T02:00:00Z'
              description: المجدولة ترسل فقط. وقت الإرسال الأول.
            next_run_at:
              type: string
              format: date-time
              example: '2026-10-01T02:00:00Z'
              description: المجدولة ترسل فقط. عندما يرسل العامل بعد ذلك.
    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/examples/interactive-messages.md)
- [إرسال الرسائل](https://gowa-docs.mintlify.site/ar/examples/sending-messages.md)
- [إرسال حدود](https://gowa-docs.mintlify.site/ar/advanced/rate-limiting.md)
- [إرسال ملصق](https://gowa-docs.mintlify.site/ar/api-reference/send/إرسال-ملصق.md)
- [إرسال مجدول](https://gowa-docs.mintlify.site/ar/examples/scheduled-sends.md)


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