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

# مستخدم مجموعات قائمتي

> احصل على كل المجموعات التي انضم إليها المستخدم المصادق.

⚠️ **حدود معروفة**: نقطة النهاية هذه ترجع 500 مجموعة كحد أقصى بسبب حد بروتوكول WhatsApp.
ترسل الدالة `GetJoinedGroups()` في مكتبة whatsmeow الأساسية استعلامًا واحدًا إلى خوادم WhatsApp،
التي تفرض هذا الحد. هذا ليس خطأً في واجهة API هذه، بل هو قيد يفرضه بروتوكول
WhatsApp متعدد الأجهزة. أما المستخدمون الذين لديهم أكثر من 500 مجموعة فلن يتلقون سوى أول 500 مجموعة.

لمزيد من التفاصيل، انظر: https://github.com/tulir/whatsmeow/blob/main/group.go




## OpenAPI

````yaml /ar/openapi.yml get /user/my/groups
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:
  /user/my/groups:
    get:
      tags:
        - user
      summary: مستخدم مجموعات قائمتي
      description: >
        احصل على كل المجموعات التي انضم إليها المستخدم المصادق.


        ⚠️ **حدود معروفة**: نقطة النهاية هذه ترجع 500 مجموعة كحد أقصى بسبب حد
        بروتوكول WhatsApp.

        ترسل الدالة `GetJoinedGroups()` في مكتبة whatsmeow الأساسية استعلامًا
        واحدًا إلى خوادم WhatsApp،

        التي تفرض هذا الحد. هذا ليس خطأً في واجهة API هذه، بل هو قيد يفرضه
        بروتوكول

        WhatsApp متعدد الأجهزة. أما المستخدمون الذين لديهم أكثر من 500 مجموعة
        فلن يتلقون سوى أول 500 مجموعة.


        لمزيد من التفاصيل، انظر:
        https://github.com/tulir/whatsmeow/blob/main/group.go
      operationId: userMyGroups
      parameters:
        - $ref: '#/components/parameters/DeviceIdHeader'
      responses:
        '200':
          description: حسناً
          content:
            application/json:
              schema:
                $ref: '#/components/schemas/UserGroupResponse'
        '500':
          description: خطأ خادم داخلي
          content:
            application/json:
              schema:
                $ref: '#/components/schemas/ErrorInternalServer'
      externalDocs:
        description: مرجع حد بروتوكول WhatsApp (Whatsmeow source)
        url: https://github.com/tulir/whatsmeow/blob/main/group.go
components:
  parameters:
    DeviceIdHeader:
      name: X-Device-Id
      in: header
      required: false
      description: |
        معرف الجهاز لدعم الأجهزة المتعددة. مطلوب عند تسجيل أجهزة متعددة.
        إذا تم تسجيل جهاز واحد فقط، فسيتم استخدامه كجهاز افتراضي.
        يمكن أيضا توفيره كعامل استعلام `device_id`.
      schema:
        type: string
        example: my-device-id
  schemas:
    UserGroupResponse:
      type: object
      properties:
        code:
          type: string
          example: SUCCESS
        message:
          type: string
          example: Success get list groups
        results:
          type: object
          properties:
            data:
              type: array
              items:
                $ref: '#/components/schemas/UserMyGroupItem'
    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: بيانات إضافية
    UserMyGroupItem:
      type: object
      description: >
        انضم واحد كمجموعة متسلسلة `whatsmeow/types.GroupInfo`. الهياكل المضمنة
        مسطحة ؛ أسماء الحقول تبقى PascalCase (Go default JSON).
      properties:
        JID:
          type: string
          example: 120363416355796813@g.us
        OwnerJID:
          type: string
        OwnerPN:
          type: string
        Name:
          type: string
        NameSetAt:
          type: string
          format: date-time
        NameSetBy:
          type: string
        NameSetByPN:
          type: string
        GroupCreated:
          type: string
          format: date-time
        CreatorCountryCode:
          type: string
        ParticipantVersionID:
          type: string
        ParticipantCount:
          type: integer
        Participants:
          type: array
          items:
            $ref: '#/components/schemas/JoinedGroupParticipant'
        MemberAddMode:
          type: string
          example: admin_add
        Suspended:
          type: boolean
        AddressingMode:
          type: string
        IsLocked:
          type: boolean
        IsAnnounce:
          type: boolean
        AnnounceVersionID:
          type: string
        IsEphemeral:
          type: boolean
        DisappearingTimer:
          type: integer
        IsIncognito:
          type: boolean
        IsJoinApprovalRequired:
          type: boolean
        DefaultMembershipApprovalMode:
          type: string
        IsParent:
          type: boolean
        LinkedParentJID:
          type: string
        IsDefaultSubGroup:
          type: boolean
        Topic:
          type: string
        TopicID:
          type: string
        TopicDeleted:
          type: boolean
        TopicSetAt:
          type: string
          format: date-time
        TopicSetBy:
          type: string
        TopicSetByPN:
          type: string
    JoinedGroupParticipant:
      type: object
      description: >-
        متسلسل `whatsmeow/types.GroupParticipant` في حمولات قائمة المجموعات
        المشتركة.
      properties:
        JID:
          type: string
          description: المعرف الأساسي للعضو (غالبا `@lid`).
        PhoneNumber:
          type: string
          description: >-
            سلسلة JID للمستخدم عندما تكون معروفة (مثل `628...@s.whatsapp.net`)؛
            قد تكون فارغة في حالات الحافة.
        LID:
          type: string
        IsAdmin:
          type: boolean
        IsSuperAdmin:
          type: boolean
        DisplayName:
          type: string
          description: تعيين لبعض حالات الإعلان/المجهولة؛ غالباً ما تكون فارغة.
        Error:
          type: integer
        AddRequest:
          type: object
          nullable: true
  securitySchemes:
    basicAuth:
      type: http
      scheme: basic

````

## Related topics

- [مستخدم مجموعات قائمتي](https://gowa-docs.mintlify.site/ar/api-reference/user/مستخدم-مجموعات-قائمتي-1.md)
- [مرجع التكوين](https://gowa-docs.mintlify.site/ar/configuration.md)
- [إدارة المجموعة](https://gowa-docs.mintlify.site/ar/examples/group-management.md)
- [مرجع API](https://gowa-docs.mintlify.site/ar/api-reference/introduction.md)
- [أفضل الممارسات الإنتاجية](https://gowa-docs.mintlify.site/ar/advanced/best-practices.md)


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