> ## 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 طلب
إذا لم يكن البوت مشرفا على المجموعة.




## OpenAPI

````yaml /ar/openapi.yml post /message/{message_id}/revoke
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}/revoke:
    post:
      tags:
        - message
      summary: إلغاء الرسالة
      description: >
        إلغاء (حذف للجميع) رسالة. يلغي رسالة البوت الخاصة بشكل افتراضي.

        إذا كانت الرسالة المستهدفة قد أُرسلت بواسطة مستخدم آخر وكانت موجودة في
        مخزن المحادثات،

        فيُحدَّد مُرسِلها الأصلي تلقائيًا، مما يتيح لروبوت يتمتع بصلاحيات مشرف
        المجموعة حذف

        رسائل الأعضاء الآخرين (في حالات مكافحة الرسائل غير المرغوب فيها). يرفض
        خادم WhatsApp طلب

        إذا لم يكن البوت مشرفا على المجموعة.
      operationId: revokeMessage
      parameters:
        - $ref: '#/components/parameters/DeviceIdHeader'
        - in: path
          name: message_id
          schema:
            type: string
          required: true
          description: معرف الرسالة
      requestBody:
        content:
          application/json:
            schema:
              type: object
              properties:
                phone:
                  type: string
                  example: 6289685024051@s.whatsapp.net
                  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:
    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/api-reference/message/رسالة-إلغاء-النجمة.md)
- [حذف الرسالة](https://gowa-docs.mintlify.site/ar/api-reference/message/حذف-الرسالة.md)
- [إرسال الرسائل](https://gowa-docs.mintlify.site/ar/examples/sending-messages.md)
- [إعادة توجيه الرسالة](https://gowa-docs.mintlify.site/ar/api-reference/message/إعادة-توجيه-الرسالة.md)
- [إلغاء إرسال مجدول](https://gowa-docs.mintlify.site/ar/api-reference/send/إلغاء-إرسال-مجدول.md)


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