> ## 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 get /chat/{chat_jid}/messages
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}/messages:
    get:
      tags:
        - chat
      summary: الحصول على رسائل من محادثة محددة
      description: استرداد الرسائل من محادثة محددة مع خيارات التصفية
      operationId: getChatMessages
      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
        - name: limit
          in: query
          schema:
            type: integer
            default: 50
            maximum: 100
          description: الحد الأقصى لعدد الرسائل المراد إرجاعها
        - name: offset
          in: query
          schema:
            type: integer
            default: 0
          description: عدد الرسائل المراد تخطيها (للصفحة)
        - name: start_time
          in: query
          schema:
            type: string
            format: date-time
          description: تصفية الرسائل من هذا الطابع الزمني (ISO 8601)
        - name: end_time
          in: query
          schema:
            type: string
            format: date-time
          description: تصفية الرسائل حتى هذا الشكل الزمني (ISO 8601)
        - name: media_only
          in: query
          schema:
            type: boolean
            default: false
          description: إرجاع الرسائل فقط مع محتوى الوسائط
        - name: is_from_me
          in: query
          schema:
            type: boolean
          description: >-
            تصفية الرسائل حسب المرسل (صحيح للرسائل المرسلة من قبلك، خطأ للرسائل
            المستلمة). عندما يتم توفير كل من media_only=true و isFromMe=false ،
            تكون للوسيط الأسبقية فقط وسوف يعيد جميع رسائل الوسائط بغض النظر عن
            المرسل.
        - name: search
          in: query
          schema:
            type: string
          description: البحث عن الرسائل حسب نص المحتوى
      responses:
        '200':
          description: حسناً
          content:
            application/json:
              schema:
                $ref: '#/components/schemas/ChatMessagesResponse'
        '400':
          description: طلب خاطئ
          content:
            application/json:
              schema:
                $ref: '#/components/schemas/ErrorBadRequest'
        '401':
          description: غير مصرح
          content:
            application/json:
              schema:
                $ref: '#/components/schemas/ErrorUnauthorized'
        '404':
          description: لم يتم العثور على الدردشة
          content:
            application/json:
              schema:
                $ref: '#/components/schemas/ErrorNotFound'
        '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:
    ChatMessagesResponse:
      type: object
      properties:
        code:
          type: string
          example: SUCCESS
        message:
          type: string
          example: Success get chat messages
        results:
          type: object
          properties:
            data:
              type: array
              items:
                $ref: '#/components/schemas/ChatMessage'
            pagination:
              type: object
              properties:
                limit:
                  type: integer
                  example: 50
                offset:
                  type: integer
                  example: 0
                total:
                  type: integer
                  example: 1250
            chat_info:
              $ref: '#/components/schemas/Chat'
    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: بيانات إضافية
    ErrorNotFound:
      type: object
      properties:
        code:
          type: string
          example: 404
          description: رمز حالة HTTP
        message:
          type: string
          example: Chat not found
          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: بيانات إضافية
    ChatMessage:
      type: object
      properties:
        id:
          type: string
          example: 3EB0B430B6F8F1D0E053AC120E0A9E5C
          description: معرف الرسالة
        chat_jid:
          type: string
          example: 6289685028129@s.whatsapp.net
          description: دردشة JID هذه الرسالة تنتمي إلى
        sender_jid:
          type: string
          example: 6289685028129@s.whatsapp.net
          description: Sender JID
        sender_display_name:
          type: string
          example: Saved Contact
          description: >-
            وسم المرسل الذي يمكن قراءته بشريا تم حله بشكل دينامي عندما يتم إنتاج
            هذا الرد، لا يتم تخزينه مع الرسالة. بالنسبة للمرسلين الآخرين، يفضل
            اسم جهة الاتصال الكامل المحفوظة، ثم اسم الدفع الخاص بجهة الاتصال
            المخزنة، واسم الأعمال، وجزء مستخدم JID، و JID. بالنسبة للحساب النشط،
            يفضل اسم عرض الجهاز (العودة إلى اسم دفع الحساب المخزن)، حساب JID جزء
            المستخدم، حساب JID، جزء المستخدم الخاص بالمرسل، و JID. لذلك يمكن
            إعادة تسمية جهة الاتصال تغيير التسمية التي تم إرجاعها للرسائل
            التاريخية. `sender_jid` يظل معرف المرسل المستقر.
        content:
          type: string
          example: Hello, how are you?
          description: محتوى نص الرسالة
        timestamp:
          type: string
          format: date-time
          example: '2024-01-15T10:30:00Z'
          description: الطابع الزمني للرسالة
        is_from_me:
          type: boolean
          example: false
          description: ما إذا كانت هذه الرسالة قد أرسلت من قبل المستخدم الحالي
        media_type:
          type: string
          example: image
          nullable: true
          description: >-
            نوع الوسائط (صورة، فيديو، صوتي، وثيقة، إلخ). تشير القيمة `call` إلى
            سجل محفوظ لمكالمة واردة.
        reactions:
          type: array
          description: ردود فعل الرموز التعبيرية المرفقة بهذه الرسالة
          items:
            $ref: '#/components/schemas/ChatReaction'
        call_metadata:
          type: string
          example: '{"call_id":"ABC","auto_rejected":false}'
          description: >-
            سلسلة JSON مع تفاصيل المكالمة عندما تكون media_type `call`. تم
            إغلاقه عندما لا ينطبق (يطابق Go json omitempty).
        referral_metadata:
          type: string
          example: '{"ctwa_clid":"clid_123","source_app":"whatsapp"}'
          description: >-
            سلسلة JSON مع إحالة أو تفاصيل الإسناد إلى Meta Ads عندما تنشأ
            الرسالة من إعلان النقر إلى WhatsApp. تم إغلاقه عندما لا ينطبق (يطابق
            Go json omitempty).
        context_metadata:
          type: string
          example: '{"replied_to_id":"AC625C65EA7143E71D784176C4A90A93"}'
          description: >-
            سلسلة JSON التي تحتوي على معرف الرسالة المجيبة عندما يكون سياق الرد
            معروفاً. التقط من الرسائل المباشرة والمرسلة والمزامنة التاريخية. ()
            غير موجودة عندما لا يكون سياق الرد متاحا، بما في ذلك الصفوف القديمة
            المخزونة إلى أن يتم استيعابها في السياق.
        filename:
          type: string
          example: photo.jpg
          nullable: true
          description: اسم الملف الأصلي لرسائل الوسائط
        url:
          type: string
          example: https://media.example.com/file.jpg
          nullable: true
          description: رابط ملف الوسائط
        file_length:
          type: integer
          example: 1024768
          nullable: true
          description: حجم الملف في بايت لرسائل الوسائط
        created_at:
          type: string
          format: date-time
          example: '2024-01-15T10:30:00Z'
          description: طابع الوقت لإنشاء السجل
        updated_at:
          type: string
          format: date-time
          example: '2024-01-15T10:30:00Z'
          description: سجل آخر تحديث زمني
    Chat:
      type: object
      properties:
        jid:
          type: string
          example: 6289685028129@s.whatsapp.net
          description: معرف دردشة JID
        name:
          type: string
          example: John Doe
          description: اسم عرض الدردشة
        last_message_time:
          type: string
          format: date-time
          example: '2024-01-15T10:30:00Z'
          description: الطابع الزمني للرسالة الأخيرة
        ephemeral_expiration:
          type: integer
          example: 0
          description: وقت انتهاء صلاحية الرسالة الزواجية بالثواني (0 = معطل)
        created_at:
          type: string
          format: date-time
          example: '2024-01-10T08:00:00Z'
          description: وقت إنشاء الدردشة
        updated_at:
          type: string
          format: date-time
          example: '2024-01-15T10:30:00Z'
          description: آخر تحديث زمني للدردشة
        archived:
          type: boolean
          example: false
          description: ما إذا كانت المحادثة قد أرشفت
    ChatReaction:
      type: object
      properties:
        emoji:
          type: string
          example: 👍
          description: الرموز التعبيرية المستخدمة في التفاعل
        sender_jid:
          type: string
          example: 628123456789@s.whatsapp.net
          description: وحدة التفتيش المشتركة للمستخدم الذي كان رد فعل
        sender_display_name:
          type: string
          example: Saved Contact
          description: >-
            وسم المرسل الذي يمكن قراءته بشريا تم حله بشكل دينامي عندما يتم إنتاج
            هذا الاستجابة، وليس مخزنا مع رد الفعل. بالنسبة للمرسلين الآخرين،
            يفضل اسم جهة الاتصال الكامل المحفوظة، ثم اسم الدفع الخاص بجهة
            الاتصال المخزنة، واسم الأعمال، وجزء مستخدم JID، و JID. بالنسبة
            للحساب النشط، يفضل اسم عرض الجهاز (العودة إلى اسم دفع الحساب
            المخزن)، حساب JID جزء المستخدم، حساب JID، جزء المستخدم الخاص
            بالمرسل، و JID. وبالتالي فإن إعادة تسمية جهة الاتصال يمكن أن تغير
            التسمية التي أعيدت لردود الفعل التاريخية. `sender_jid` يظل معرف
            المرسل المستقر.
        is_from_me:
          type: boolean
          example: false
          description: ما إذا كان رد الفعل قد قام به المستخدم الحالي
        timestamp:
          type: string
          format: date-time
          example: '2024-01-15T10:31:00Z'
          description: عند تلقي رد الفعل
  securitySchemes:
    basicAuth:
      type: http
      scheme: basic

````

## Related topics

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


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