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



## OpenAPI

````yaml /id/openapi.yml post /send/image
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/image:
    post:
      tags:
        - send
      summary: Kirim gambar
      operationId: sendImage
      parameters:
        - $ref: '#/components/parameters/DeviceIdHeader'
      requestBody:
        content:
          multipart/form-data:
            schema:
              type: object
              allOf:
                - $ref: '#/components/schemas/ScheduleOptions'
              properties:
                phone:
                  type: string
                  example: 6289685028129@s.whatsapp.net
                  description: Nomor telepon dengan kode negara
                caption:
                  type: string
                  example: selamat malam
                  description: Keterangan yang akan dikirim
                mentions:
                  type: array
                  items:
                    type: string
                  example:
                    - '628123456789'
                    - '@everyone'
                  description: >
                    Daftar nomor telepon yang akan disebut (ghost mention -
                    tidak memerlukan @ dalam keterangan).

                    `@phone` dalam keterangan juga akan disebut. Gunakan kata
                    kunci khusus "@everyone" untuk menyebut semua peserta grup.

                    Kirim satu field formulir `mentions` untuk setiap entri.
                reply_message_id:
                  type: string
                  example: 3EB089B9D6ADD58153C561
                  description: ID pesan yang ingin Anda balas
                view_once:
                  type: boolean
                  example: false
                  description: Sekali lihat
                image:
                  type: string
                  format: binary
                  description: Gambar yang akan dikirim
                image_url:
                  type: string
                  example: https://example.com/image.jpg
                  description: URL gambar yang akan dikirim
                compress:
                  type: boolean
                  example: false
                  description: Kompres gambar
                hd:
                  type: boolean
                  example: true
                  description: >-
                    Kirim versi gambar beresolusi tinggi (sisi maksimum 2560px).
                    Menggantikan compress saat bernilai true.
                duration:
                  type: integer
                  example: 86400
                  description: >-
                    Durasi pesan sementara dalam detik. Nilai yang diizinkan: 0
                    (tanpa kedaluwarsa), 86400 (24h), 604800 (7d), 7776000
                    (90d).
                is_forwarded:
                  type: boolean
                  example: false
                  description: Apakah ini pesan yang diteruskan
                allow_reshare:
                  type: boolean
                  example: false
                  description: >-
                    Tampilkan tombol bagikan ulang kepada pemirsa status.
                    Mengharuskan `phone` bernilai `status@broadcast`; GOWA
                    menolak field ini untuk penerima lainnya.
      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 stiker](https://gowa-docs.mintlify.site/id/api-reference/send/kirim-stiker.md)
- [Pesan interaktif eksperimental](https://gowa-docs.mintlify.site/id/examples/interactive-messages.md)
- [Kirim pesan interaktif eksperimental](https://gowa-docs.mintlify.site/id/api-reference/send/kirim-pesan-interaktif-eksperimental.md)
- [Penanganan Media](https://gowa-docs.mintlify.site/id/examples/media-handling.md)
- [Kirim audio](https://gowa-docs.mintlify.site/id/api-reference/send/kirim-audio.md)


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