> ## 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 pesan interaktif eksperimental

> Pengiriman REST langsung saja untuk tombol native-flow, daftar pilihan,
permintaan lokasi, dan carousel. Tidak didukung oleh pengiriman terjadwal atau MCP.
Menggunakan protokol tidak resmi; keberhasilan API tidak menjamin pesan
ditampilkan pada penerima atau terkirim. Hanya menerima penerima pengguna individual atau grup.
Berikan buttons atau cards. Batas body HTTP keseluruhan juga berlaku.




## OpenAPI

````yaml /id/openapi.yml post /send/interactive
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/interactive:
    post:
      tags:
        - send
      summary: Kirim pesan interaktif eksperimental
      description: >
        Pengiriman REST langsung saja untuk tombol native-flow, daftar pilihan,

        permintaan lokasi, dan carousel. Tidak didukung oleh pengiriman
        terjadwal atau MCP.

        Menggunakan protokol tidak resmi; keberhasilan API tidak menjamin pesan

        ditampilkan pada penerima atau terkirim. Hanya menerima penerima
        pengguna individual atau grup.

        Berikan buttons atau cards. Batas body HTTP keseluruhan juga berlaku.
      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: Diterima untuk dikirim; tampilan pada penerima belum diverifikasi
          content:
            application/json:
              schema:
                $ref: '#/components/schemas/SendResponse'
        '400':
          description: Penerima, teks, parameter tombol, atau batas gambar tidak valid
          content:
            application/json:
              schema:
                $ref: '#/components/schemas/ErrorBadRequest'
        '500':
          description: Kegagalan perangkat, unggahan media, atau pengiriman WhatsApp
          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:
    InteractiveSendRequest:
      type: object
      required:
        - phone
        - body
      properties:
        phone:
          type: string
          description: Nomor telepon atau JID lengkap pengguna individual atau grup.
        body:
          type: string
          description: >-
            Teks wajib yang tidak kosong atau hanya berisi spasi, maksimum 4096
            byte.
        footer:
          type: string
          description: Maksimum 256 byte.
        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: 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
    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: >
            Maksimum 16384 byte JSON. quick_reply memerlukan display_text dan
            id;

            cta_url memerlukan display_text dan url HTTP(S) absolut;

            cta_copy memerlukan display_text dan copy_code;

            cta_call memerlukan display_text dan phone_number.

            single_select memerlukan title dan sections yang tidak kosong,
            masing-masing dengan

            rows yang tidak kosong, dengan id dan title berupa string yang tidak
            kosong.

            send_location menerima objek seperti {} dan harus menjadi
            satu-satunya

            tombol dalam pesan non-carousel. Semua parameter teks yang
            disebutkan harus

            berupa string yang tidak kosong.
    InteractiveCarouselCard:
      type: object
      required:
        - body
        - buttons
      properties:
        title:
          type: string
          description: Maksimum 256 byte.
        body:
          type: string
          description: >-
            Teks wajib yang tidak kosong atau hanya berisi spasi, maksimum 4096
            byte.
        footer:
          type: string
          description: Maksimum 256 byte.
        image_base64:
          type: string
          description: >
            JPEG atau PNG base64 standar mentah opsional, tanpa awalan data URL.

            Maksimum 2800000 karakter terenkode dan 2000000 byte terdekode, juga

            tunduk pada batas gambar yang dikonfigurasi. Maksimum 4096 piksel
            per sisi.

            Ukurannya diubah, dienkode JPEG, dibuatkan thumbnail, dan diunggah
            sebelum dikirim.
        buttons:
          type: array
          minItems: 1
          maxItems: 10
          items:
            $ref: '#/components/schemas/InteractiveNativeFlowButton'
  securitySchemes:
    basicAuth:
      type: http
      scheme: basic

````

## Related topics

- [Pesan interaktif eksperimental](https://gowa-docs.mintlify.site/id/examples/interactive-messages.md)
- [Mengirim Pesan](https://gowa-docs.mintlify.site/id/examples/sending-messages.md)
- [Kirim pesan](https://gowa-docs.mintlify.site/id/api-reference/send/kirim-pesan.md)
- [GOWA: WhatsApp REST API](https://gowa-docs.mintlify.site/id/index.md)
- [Kirim reaksi ke pesan](https://gowa-docs.mintlify.site/id/api-reference/message/kirim-reaksi-ke-pesan.md)


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