> ## 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 post /send/poll
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/poll:
    post:
      tags:
        - send
      summary: إرسال استبيان / تصويت
      operationId: sendPoll
      parameters:
        - $ref: '#/components/parameters/DeviceIdHeader'
      requestBody:
        required: true
        content:
          application/json:
            schema:
              type: object
              allOf:
                - $ref: '#/components/schemas/ScheduleOptions'
              properties:
                phone:
                  type: string
                  description: >-
                    رقم هاتف WhatsApp لإرسال الاستطلاع ، بما في ذلك لاحقة
                    '@s.whatsapp.net'.
                  example: 6289685024421@s.whatsapp.net
                question:
                  type: string
                  description: السؤال المطروح على الاستطلاع.
                  example: Siapa Nama Avatar The Last Air Bender?
                options:
                  type: array
                  description: خيارات الاستطلاع.
                  items:
                    type: string
                  example:
                    - Zuko
                    - Aang
                    - Katara
                max_answer:
                  type: integer
                  description: الحد الأقصى لعدد الإجابات المسموح بها للاقتراع.
                  example: 2
                duration:
                  type: integer
                  example: 86400
                  description: >-
                    اختفاء مدة الرسالة في ثواني. القيم المسموح بها: صفر (بدون
                    انتهاء الصلاحية)، 400 86400 (24 ساعة)، 604800 (7 د)، 000 776
                    (90 د).
              required:
                - phone
                - question
                - options
                - max_answer
      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:
    ScheduleOptions:
      type: object
      description: |
        الحقول الاختيارية التي تجمل الرسالة بدلا من إرسالها الآن. تعيين
        `scheduled_at` إلى الجدول الزمني؛ بدونها يتم إرسال الرسالة فوراً.
        عامل خلفية يرسلها في الوقت المقرر، إعادة المحاولة بينما الجهاز
        غير متصل أو غير مسجل الدخول. يتم تخزين الوسائط التي تم تحميلها على خادم
        حتى ينتهي الجدول.
        في محتوى طلبات multipart/form-data، أرسل `weekdays` كحقل متكرر
        (`weekdays=1`، `weekdays=3`).
      properties:
        scheduled_at:
          type: string
          format: date-time
          example: '2026-10-01T09:00:00+07:00'
          description: >-
            RFC3339 وقت الإرسال الأول. يجب أن يكون في المستقبل. يحدث الإرسال
            الأول دائمًا في هذا الموعد، حتى إذا وقع خارج `weekdays` أو
            `day_of_month`؛ فهذان الحقلان يحددان مرات التكرار التالية.
        timezone:
          type: string
          example: Asia/Jakarta
          description: >-
            المنطقة الزمنية للوكالة الدولية للطاقة المستخدمة لحساب العمليات
            المتكررة مطلوب عند تعيين الـ scheduled_at
        recurrence:
          type: string
          enum:
            - once
            - daily
            - weekly
            - monthly
          default: once
          description: كم مرة تكرر إرسال
        weekdays:
          type: array
          items:
            type: integer
            minimum: 0
            maximum: 6
          uniqueItems: true
          example:
            - 1
            - 3
            - 5
          description: >-
            أيام الإرسال ، 0=الأحد خلال 6=يوم السبت. مطلوب عندما يكون التكرار
            أسبوعيا.
        day_of_month:
          type: integer
          minimum: 1
          maximum: 31
          example: 15
          description: >-
            يوم من الشهر الذي سيتم إرساله، ضغطت إلى اليوم الأخير من الشهر. مطلوب
            عندما يكون التكرار شهرياً.
        end_at:
          type: string
          format: date-time
          example: '2026-12-31T23:59:59+07:00'
          description: التكرار فقط. لا يرسل بعد هذا الوقت؛ يجب أن يكون بعد الموعد المحدد.
        occurrence_limit:
          type: integer
          minimum: 1
          example: 10
          description: التكرار فقط. توقف بعد هذا العديد من الإرسالات.
    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/examples/sending-messages.md)
- [إرسال مجدول](https://gowa-docs.mintlify.site/ar/examples/scheduled-sends.md)
- [إرسال ملصق](https://gowa-docs.mintlify.site/ar/api-reference/send/إرسال-ملصق.md)
- [إرسال الرابط](https://gowa-docs.mintlify.site/ar/api-reference/send/إرسال-الرابط.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.