> ## 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، فإن إعادة التحميل تسأل الهاتف أولا عن الملف،
الذي يحتاج إلى الهاتف على الإنترنت ويمكن أن يستغرق ما يصل إلى 30 ثانية.




## OpenAPI

````yaml /ar/openapi.yml post /message/{message_id}/forward
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:
  /message/{message_id}/forward:
    post:
      tags:
        - message
      summary: إعادة توجيه الرسالة
      description: >
        إعادة توجيه رسالة موجودة في وحدة تخزين المحادثة المحلية إلى دردشة أخرى
        بواسطة رقم تعريف الرسالة.

        يتم دعم أنواع النصوص والوسائط القياسية (صورة، فيديو، ملاحظة فيديو، صوت،
        وثيقة، ملصق).

        يتم إعادة استخدام مراجع الوسائط عند الإمكان؛ يرفض التوقف تشغيل إعادة
        تحميل تلقائيًا.

        إذا انتهت صلاحية وسائط المصدر على خوادم WhatsApp، فإن إعادة التحميل تسأل
        الهاتف أولا عن الملف،

        الذي يحتاج إلى الهاتف على الإنترنت ويمكن أن يستغرق ما يصل إلى 30 ثانية.
      operationId: forwardMessage
      parameters:
        - $ref: '#/components/parameters/DeviceIdHeader'
        - in: path
          name: message_id
          schema:
            type: string
          required: true
          description: معرف الرسالة المصدر من وحدة تخزين الدردشة
          example: 3EB0123456789ABCDEF
      requestBody:
        content:
          application/json:
            schema:
              type: object
              allOf:
                - $ref: '#/components/schemas/ScheduleOptions'
              required:
                - phone
              properties:
                phone:
                  type: string
                  example: 6289685024051@s.whatsapp.net
                  description: الوجهة رقم الهاتف أو مجموعة JID
                duration:
                  type: integer
                  example: 0
                  description: >-
                    تجاوز مدة الرسائل المختفية اختياريا (0، 86400، 604800،
                    7776000)
                force_reupload:
                  type: boolean
                  example: false
                  description: >-
                    تخطي إعادة استخدام مرجع الوسائط وإعادة تحميل الوسائط قبل
                    الإرسال
      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/advanced/error-handling.md)
- [حذف تهيئة دردشة الجهاز](https://gowa-docs.mintlify.site/ar/api-reference/chatwoot/حذف-تهيئة-دردشة-الجهاز.md)
- [تكامل Chatwoot](https://gowa-docs.mintlify.site/ar/integrations/chatwoot.md)
- [إلغاء الرسالة](https://gowa-docs.mintlify.site/ar/api-reference/message/إلغاء-الرسالة.md)
- [حذف الرسالة](https://gowa-docs.mintlify.site/ar/api-reference/message/حذف-الرسالة.md)


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