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

# إرسال رسالة تفاعلية تجريبية

> إرسال REST مباشرة فقط لأزرار التدفق المحلي، قوائم الاختيار،
طلبات الموقع، والقاروفرات. غير مدعوم من الرسائل المجدولة أو MCP.
يستخدم بروتوكول غير رسمي؛ نجاح API لا يضمن تقديم أو تسليم المستفيد
 يقبل المستخدم الفردي أو مجموعة المستلمين فقط.
توفير الأزرار أو البطاقات. كذلك تطبق حدود جسم HTTP عموما.




## OpenAPI

````yaml /ar/openapi.yml post /send/interactive
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:
  /send/interactive:
    post:
      tags:
        - send
      summary: إرسال رسالة تفاعلية تجريبية
      description: |
        إرسال REST مباشرة فقط لأزرار التدفق المحلي، قوائم الاختيار،
        طلبات الموقع، والقاروفرات. غير مدعوم من الرسائل المجدولة أو MCP.
        يستخدم بروتوكول غير رسمي؛ نجاح API لا يضمن تقديم أو تسليم المستفيد
         يقبل المستخدم الفردي أو مجموعة المستلمين فقط.
        توفير الأزرار أو البطاقات. كذلك تطبق حدود جسم HTTP عموما.
      operationId: sendInteractive
      parameters:
        - $ref: '#/components/parameters/DeviceIdHeader'
      requestBody:
        required: true
        content:
          application/json:
            schema:
              $ref: '#/components/schemas/InteractiveSendRequest'
            example:
              phone: '628123456789'
              body: Confirm your order?
              buttons:
                - name: quick_reply
                  params:
                    display_text: Confirm
                    id: confirm
      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:
    InteractiveSendRequest:
      type: object
      required:
        - phone
        - body
      properties:
        phone:
          type: string
          description: رقم الهاتف أو مستخدم فردي كامل أو مجموعة JID.
        body:
          type: string
          description: النص غير فارغ، الحد الأقصى 4096 بايت.
        footer:
          type: string
          description: حد أقصى 256 بايت.
        buttons:
          type: array
          minItems: 1
          maxItems: 10
          items:
            $ref: '#/components/schemas/InteractiveNativeFlowButton'
        cards:
          type: array
          minItems: 2
          maxItems: 10
          items:
            $ref: '#/components/schemas/InteractiveCarouselCard'
      oneOf:
        - required:
            - buttons
          not:
            required:
              - cards
        - required:
            - cards
          not:
            required:
              - buttons
    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: بيانات إضافية
    InteractiveNativeFlowButton:
      type: object
      required:
        - name
        - params
      properties:
        name:
          type: string
          enum:
            - quick_reply
            - cta_url
            - cta_copy
            - cta_call
            - single_select
            - send_location
        params:
          type: object
          additionalProperties: true
          description: |
            الحد الأقصى 16384 JSON بايت. يتطلب الرد السريع Display_text و id;
            cta_url Display_text و HTTP(S) url مطلق؛
            cta_copy يتطلب Display_text و copy_code؛
            cta_call يتطلب display_text و phone_number.
            يتطلب single_Select العنوان وأقسام غير فارغة، كل منها مع
            صفوف غير فارغة التي يكون معرفها وعنوانها سلاسل غير فارغة.
            send_location يقبل كائن مثل {} ويجب أن يكون الزر
            الوحيد في رسالة غير كاروس. يجب أن تكون جميع معلمات النص المسماة
            مقاطع غير فارغة.
    InteractiveCarouselCard:
      type: object
      required:
        - body
        - buttons
      properties:
        title:
          type: string
          description: حد أقصى 256 بايت.
        body:
          type: string
          description: النص غير فارغ، الحد الأقصى 4096 بايت.
        footer:
          type: string
          description: حد أقصى 256 بايت.
        image_base64:
          type: string
          description: |
            قاعدة قياسية اختيارية64 JPEG أو PNG، بدون بادئة عنوان URL للبيانات.
            الحد الأقصى 2800000 حرف مشفر و 2000000 فك غطاء البايت، أيضًا
            رهنا بالحد الأقصى للصورة. الحد الأقصى 4096 بكسل في الجانب.
            تم تعديلها، تشفير JPEG-، مصغرة ، وتحميلها قبل الإرسال.
        buttons:
          type: array
          minItems: 1
          maxItems: 10
          items:
            $ref: '#/components/schemas/InteractiveNativeFlowButton'
  securitySchemes:
    basicAuth:
      type: http
      scheme: basic

````

## Related topics

- [رسائل تفاعلية تجريبية](https://gowa-docs.mintlify.site/ar/examples/interactive-messages.md)
- [إرسال رسالة](https://gowa-docs.mintlify.site/ar/api-reference/send/إرسال-رسالة.md)
- [إرسال الرسائل](https://gowa-docs.mintlify.site/ar/examples/sending-messages.md)
- [إرسال مجدول](https://gowa-docs.mintlify.site/ar/examples/scheduled-sends.md)
- [إرسال حدود](https://gowa-docs.mintlify.site/ar/advanced/rate-limiting.md)


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