> ## 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 Web عند التمرير / "تحميل الرسائل الأقدم"). الطلب قائم على أقدم رسالة مخزنة محليا لهذه الدردشة، لذا يجب أن تحتوي الدردشة بالفعل على رسالة مخزنة واحدة على الأقل. الهاتف يجيب بشكل غير متزامن مع حدث مزامنة التاريخ الذي يستمر في تخزين الدردشة؛ نقطة النهاية هذه تؤكد فقط أن الطلب قد أرسل، ولا تعيد الرسائل القديمة مباشرة.



## OpenAPI

````yaml /ar/openapi.yml post /chat/{chat_jid}/history
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:
  /chat/{chat_jid}/history:
    post:
      tags:
        - chat
      summary: طلب سجل محادثة أقدم من الهاتف
      description: >-
        يسأل الهاتف عن رسائل قديمة من محادثة عند الطلب (ما يفعله WhatsApp Web
        عند التمرير / "تحميل الرسائل الأقدم"). الطلب قائم على أقدم رسالة مخزنة
        محليا لهذه الدردشة، لذا يجب أن تحتوي الدردشة بالفعل على رسالة مخزنة
        واحدة على الأقل. الهاتف يجيب بشكل غير متزامن مع حدث مزامنة التاريخ الذي
        يستمر في تخزين الدردشة؛ نقطة النهاية هذه تؤكد فقط أن الطلب قد أرسل، ولا
        تعيد الرسائل القديمة مباشرة.
      operationId: requestChatHistory
      parameters:
        - $ref: '#/components/parameters/DeviceIdHeader'
        - in: path
          name: chat_jid
          schema:
            type: string
          required: true
          description: >-
            دردشة JID (على سبيل المثال، phone@s.whatsapp.net للأفراد أو
            groupid@g.us للمجموعة). القيم المشفرة (مثلاً: مجموعة%40g.us) مقبولة.
          example: 6289685028129@s.whatsapp.net
      requestBody:
        content:
          application/json:
            schema:
              type: object
              properties:
                count:
                  type: integer
                  default: 50
                  minimum: 0
                  maximum: 500
                  example: 50
                  description: >-
                    عدد الرسائل القديمة المراد طلبها من الهاتف. قبول ذلك، أو
                    إرسال 0، لاستخدام الافتراضي 50.
      responses:
        '200':
          description: حسناً
          content:
            application/json:
              schema:
                $ref: '#/components/schemas/RequestChatHistoryResponse'
        '400':
          description: >-
            طلب خاطئ (على سبيل المثال المحادثة المفقودة_jid، العد خارج النطاق،
            أو الدردشة لا تحتوي على رسائل مخزنة لترسيمها)
          content:
            application/json:
              schema:
                $ref: '#/components/schemas/ErrorBadRequest'
        '401':
          description: غير مصرح
          content:
            application/json:
              schema:
                $ref: '#/components/schemas/ErrorUnauthorized'
        '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:
    RequestChatHistoryResponse:
      type: object
      properties:
        status:
          type: integer
          example: 200
        code:
          type: string
          example: SUCCESS
        message:
          type: string
          example: History sync requested successfully
        results:
          type: object
          properties:
            status:
              type: string
              example: requested
            chat_jid:
              type: string
              example: 6289685028129@s.whatsapp.net
            requested_count:
              type: integer
              example: 50
            anchor_message_id:
              type: string
              example: 3EB0C767D82B0A0D1234
            anchor_timestamp:
              type: string
              format: date-time
              example: '2026-05-16T08:00:00Z'
    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: بيانات إضافية
    ErrorUnauthorized:
      type: object
      properties:
        code:
          type: string
          example: 401
          description: رمز حالة HTTP
        message:
          type: string
          example: Unauthorized access
          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

- [تكامل Chatwoot](https://gowa-docs.mintlify.site/ar/integrations/chatwoot.md)
- [الحصول على رسائل من محادثة محددة](https://gowa-docs.mintlify.site/ar/api-reference/chat/الحصول-على-رسائل-من-محادثة-محددة.md)
- [البداية السريعة](https://gowa-docs.mintlify.site/ar/quickstart.md)
- [المصادقة](https://gowa-docs.mintlify.site/ar/authentication.md)
- [مزامنة سجل الرسائل إلى Chatwoot](https://gowa-docs.mintlify.site/ar/api-reference/chatwoot/مزامنة-سجل-الرسائل-إلى-chatwoot.md)


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