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

# Kirim Polling / Pemungutan Suara



## OpenAPI

````yaml /id/openapi.yml post /send/poll
openapi: 3.0.0
info:
  title: WhatsApp API MultiDevice
  version: 9.7.0
  description: >
    API ini digunakan untuk mengirim pesan WhatsApp melalui API.


    Dashboard web merupakan proyek terpisah (gowa-ui); server mengunduh aset
    rilis

    terbarunya dan menyajikannya di `/` (atau mengembalikan banner JSON saat

    APP_UI_ENABLED=false).


    Cakupan perangkat:

    - Kirim `X-Device-Id` pada semua panggilan REST yang memiliki cakupan
    perangkat.

    - WebSocket: hubungkan ke `/ws?device_id=<id>`.

    - Autentikasi WebSocket (saat autentikasi dasar diaktifkan): browser tidak
    dapat menyetel
      header Authorization pada koneksi WebSocket, sehingga sertakan juga
      `&authorization=<base64(user:pass)>` dalam query string. Gunakan TLS di
      produksi karena kredensial terlihat di URL.
servers:
  - url: http://localhost:3000
security:
  - basicAuth: []
tags:
  - name: app
    description: Koneksi awal ke server WhatsApp
  - name: device
    description: Pengelolaan perangkat untuk dukungan multi-perangkat
  - name: user
    description: Mengambil informasi
  - name: send
    description: Kirim pesan (teks/gambar/berkas/video).
  - name: message
    description: Manipulasi pesan (cabut/beri reaksi/perbarui).
  - name: call
    description: Pengelolaan panggilan (tolak panggilan masuk)
  - name: chat
    description: Percakapan chat dan perpesanan
  - name: group
    description: Pengaturan grup
  - name: newsletter
    description: Pengaturan newsletter
  - name: chatwoot
    description: Integrasi Chatwoot untuk dukungan pelanggan
paths:
  /send/poll:
    post:
      tags:
        - send
      summary: Kirim Polling / Pemungutan Suara
      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: >-
                    Nomor telepon WhatsApp tujuan polling, termasuk akhiran
                    '@s.whatsapp.net'.
                  example: 6289685024421@s.whatsapp.net
                question:
                  type: string
                  description: Pertanyaan untuk polling.
                  example: Siapa Nama Avatar The Last Air Bender?
                options:
                  type: array
                  description: Pilihan untuk polling.
                  items:
                    type: string
                  example:
                    - Zuko
                    - Aang
                    - Katara
                max_answer:
                  type: integer
                  description: Jumlah maksimal jawaban yang diizinkan untuk polling.
                  example: 2
                duration:
                  type: integer
                  example: 86400
                  description: >-
                    Durasi pesan sementara dalam detik. Nilai yang diizinkan: 0
                    (tanpa kedaluwarsa), 86400 (24h), 604800 (7d), 7776000
                    (90d).
              required:
                - phone
                - question
                - options
                - max_answer
      responses:
        '200':
          description: OK
          content:
            application/json:
              schema:
                $ref: '#/components/schemas/SendResponse'
        '400':
          description: Permintaan Tidak Valid
          content:
            application/json:
              schema:
                $ref: '#/components/schemas/ErrorBadRequest'
        '500':
          description: Kesalahan Internal Server
          content:
            application/json:
              schema:
                $ref: '#/components/schemas/ErrorInternalServer'
components:
  parameters:
    DeviceIdHeader:
      name: X-Device-Id
      in: header
      required: false
      description: >
        Pengenal perangkat untuk dukungan multi-device. Wajib jika beberapa
        perangkat terdaftar.

        Jika hanya satu perangkat terdaftar, perangkat tersebut digunakan
        sebagai default.

        Dapat juga diberikan sebagai parameter kueri `device_id`.
      schema:
        type: string
        example: my-device-id
  schemas:
    ScheduleOptions:
      type: object
      description: >
        Field opsional untuk menjadwalkan pesan alih-alih mengirimnya sekarang.
        Tetapkan

        `scheduled_at` untuk menjadwalkan; tanpanya, pesan langsung dikirim.

        Worker latar belakang mengirimnya pada waktu yang dijadwalkan, dengan
        mencoba ulang selama

        perangkat offline atau belum login. Media yang diunggah disimpan di

        server hingga jadwal selesai.

        Dalam body multipart/form-data, kirim `weekdays` sebagai field berulang

        (`weekdays=1`, `weekdays=3`).
      properties:
        scheduled_at:
          type: string
          format: date-time
          example: '2026-10-01T09:00:00+07:00'
          description: >-
            Waktu pengiriman pertama dalam format RFC3339. Harus di masa
            mendatang. Pengiriman pertama selalu terjadi pada waktu ini,
            meskipun berada di luar `weekdays` atau `day_of_month`; keduanya
            mengatur pengulangan berikutnya.
        timezone:
          type: string
          example: Asia/Jakarta
          description: >-
            Zona waktu IANA yang digunakan untuk menghitung eksekusi berulang.
            Wajib saat scheduled_at ditetapkan.
        recurrence:
          type: string
          enum:
            - once
            - daily
            - weekly
            - monthly
          default: once
          description: Frekuensi pengulangan pengiriman
        weekdays:
          type: array
          items:
            type: integer
            minimum: 0
            maximum: 6
          uniqueItems: true
          example:
            - 1
            - 3
            - 5
          description: >-
            Hari pengiriman, 0=Minggu hingga 6=Sabtu. Wajib saat recurrence
            bernilai weekly.
        day_of_month:
          type: integer
          minimum: 1
          maximum: 31
          example: 15
          description: >-
            Tanggal pengiriman dalam bulan, dibatasi hingga hari terakhir bulan
            tersebut. Wajib saat recurrence bernilai monthly.
        end_at:
          type: string
          format: date-time
          example: '2026-12-31T23:59:59+07:00'
          description: >-
            Hanya untuk pengulangan. Tidak ada pengiriman setelah waktu ini;
            harus setelah scheduled_at.
        occurrence_limit:
          type: integer
          minimum: 1
          example: 10
          description: Hanya untuk pengulangan. Berhenti setelah jumlah pengiriman ini.
    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: Tidak disertakan untuk pengiriman terjadwal
            status:
              type: string
              example: <feature> success ....
            schedule_id:
              type: string
              example: 0b5c3a8e-7f5d-4d6f-9d1e-2f8c1a7b9e10
              description: >-
                Hanya untuk pengiriman terjadwal. Gunakan dengan rute
                /send/schedules.
            scheduled_at:
              type: string
              format: date-time
              example: '2026-10-01T02:00:00Z'
              description: Hanya untuk pengiriman terjadwal. Waktu pengiriman pertama.
            next_run_at:
              type: string
              format: date-time
              example: '2026-10-01T02:00:00Z'
              description: >-
                Hanya untuk pengiriman terjadwal. Waktu worker mengirim
                berikutnya.
    ErrorBadRequest:
      type: object
      properties:
        code:
          type: string
          example: 400
          description: Kode Status HTTP
        message:
          type: string
          example: field cannot be blank
          description: Pesan kesalahan terperinci
        results:
          type: object
          example: null
          description: data tambahan
    ErrorInternalServer:
      type: object
      properties:
        code:
          type: string
          example: INTERNAL_SERVER_ERROR
          description: SYSTEM_CODE_ERROR
        message:
          type: string
          example: you are not loggin
          description: Pesan kesalahan terperinci
        results:
          type: object
          example: null
          description: data tambahan
  securitySchemes:
    basicAuth:
      type: http
      scheme: basic

````

## Related topics

- [Kirim audio](https://gowa-docs.mintlify.site/id/api-reference/send/kirim-audio.md)
- [Kirim Video](https://gowa-docs.mintlify.site/id/api-reference/send/kirim-video.md)
- [Mengirim Pesan](https://gowa-docs.mintlify.site/id/examples/sending-messages.md)
- [Integrasi Chatwoot](https://gowa-docs.mintlify.site/id/integrations/chatwoot.md)
- [Kirim stiker](https://gowa-docs.mintlify.site/id/api-reference/send/kirim-stiker.md)


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