> ## 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_AUTO_REJECT_CALL=true`) التي ترفض
جميع المكالمات الواردة على مستوى النظام. استخدم واجهة برمجة التطبيقات هذه للتحكم الدقيق الحبيب.

**الحقول المطلوبة من webhook:**
- `caller_jid`: استخدم `payload.from` من حدث webhook من النوع `call.offer`
- `call_id`: استخدم `payload.call_id` من حدث webhook من النوع `call.offer`




## OpenAPI

````yaml /ar/openapi.yml post /call/reject
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:
  /call/reject:
    post:
      tags:
        - call
      summary: رفض مكالمة واردة
      description: >
        رفض برنامجياً مكالمة واردة محددة. هذه النقطة النهائية تسمح برفض اتصال
        انتقائي

        بناء على منطق التطبيق الخاص بك (على سبيل المثال قواعد الوقت اليومي،
        القوائم البيضاء للمتصل، توافر الوكيل).


        ويجب أن تظل الدعوة رنانة - فالرفض سيفشل إذا كان النداء قد انتهى بالفعل
        أو تمت الإجابة عليه.


        يكمّل هذا ميزة الرفض التلقائي (`WHATSAPP_AUTO_REJECT_CALL=true`) التي
        ترفض

        جميع المكالمات الواردة على مستوى النظام. استخدم واجهة برمجة التطبيقات
        هذه للتحكم الدقيق الحبيب.


        **الحقول المطلوبة من webhook:**

        - `caller_jid`: استخدم `payload.from` من حدث webhook من النوع
        `call.offer`

        - `call_id`: استخدم `payload.call_id` من حدث webhook من النوع
        `call.offer`
      operationId: rejectCall
      parameters:
        - $ref: '#/components/parameters/DeviceIdHeader'
      requestBody:
        required: true
        content:
          application/json:
            schema:
              type: object
              required:
                - caller_jid
                - call_id
              properties:
                caller_jid:
                  type: string
                  example: 628987654321@s.whatsapp.net
                  description: إجادة المتصلين (من webhook `payload.from`)
                call_id:
                  type: string
                  example: ABC123DEF456
                  description: معرف اتصال فريد (من webhook `payload.call_id`)
      responses:
        '200':
          description: تم رفض المكالمة بنجاح
          content:
            application/json:
              schema:
                $ref: '#/components/schemas/GenericResponse'
        '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:
    GenericResponse:
      type: object
      properties:
        code:
          type: string
          example: SUCCESS
        message:
          type: string
          example: Success
        results:
          type: string
          example: null
    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/concepts/webhooks.md)
- [رفض طلب المشارك للانضمام إلى المجموعة](https://gowa-docs.mintlify.site/ar/api-reference/group/رفض-طلب-المشارك-للانضمام-إلى-المجموعة.md)
- [مرجع التكوين](https://gowa-docs.mintlify.site/ar/configuration.md)
- [خادم MCP](https://gowa-docs.mintlify.site/ar/integrations/mcp.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.